Tailscale

​

Chế độ

• serve: Serve chỉ dành cho tailnet qua tailscale serve. Gateway vẫn ở 127.0.0.1.
• funnel: HTTPS công khai qua tailscale funnel. OpenClaw yêu cầu mật khẩu dùng chung.
• off: Mặc định (không có tự động hóa Tailscale).

​

Xác thực

• none (chỉ ingress riêng tư)
• token (mặc định khi OPENCLAW_GATEWAY_TOKEN được đặt)
• password (bí mật dùng chung qua OPENCLAW_GATEWAY_PASSWORD hoặc cấu hình)
• trusted-proxy (reverse proxy nhận biết danh tính; xem Xác thực Trusted Proxy)

​

Ví dụ cấu hình

​

Chỉ tailnet (Serve)

{
  gateway: {
    bind: "loopback",
    tailscale: { mode: "serve" },
  },
}

{
  gateway: {
    bind: "loopback",
    tailscale: { mode: "serve", serviceName: "svc:openclaw" },
  },
}

​

Chỉ tailnet (bind vào IP Tailnet)

{
  gateway: {
    bind: "tailnet",
    auth: { mode: "token", token: "your-token" },
  },
}

• Giao diện điều khiển: http://<tailscale-ip>:18789/
• WebSocket: ws://<tailscale-ip>:18789

​

Internet công khai (Funnel + mật khẩu dùng chung)

{
  gateway: {
    bind: "loopback",
    tailscale: { mode: "funnel" },
    auth: { mode: "password", password: "replace-me" },
  },
}

​

Ví dụ CLI

openclaw gateway --tailscale serve
openclaw gateway --tailscale funnel --auth password

​

Ghi chú

• Tailscale Serve/Funnel yêu cầu CLI tailscale đã được cài đặt và đã đăng nhập.
• tailscale.mode: "funnel" từ chối khởi động trừ khi chế độ xác thực là password để tránh phơi bày công khai.
• gateway.tailscale.serviceName chỉ áp dụng cho chế độ Serve và được truyền cho tailscale serve --service=<name>. Giá trị phải dùng định dạng tên Service svc:<dns-label> của Tailscale, ví dụ svc:openclaw. Tailscale yêu cầu host Service là các nút đã gắn thẻ, và Service có thể cần được phê duyệt trong bảng điều khiển quản trị trước khi Serve có thể phát hành nó.
• Đặt gateway.tailscale.resetOnExit nếu bạn muốn OpenClaw hoàn tác cấu hình tailscale serve hoặc tailscale funnel khi tắt.
• Đặt gateway.tailscale.preserveFunnel: true để giữ một route tailscale funnel được cấu hình bên ngoài tiếp tục hoạt động qua các lần khởi động lại gateway. Khi bật và gateway chạy ở mode: "serve", OpenClaw kiểm tra tailscale funnel status trước khi áp dụng lại Serve và bỏ qua khi một route Funnel đã bao phủ cổng gateway. Chính sách Funnel do OpenClaw quản lý chỉ dùng mật khẩu vẫn không đổi.
• gateway.bind: "tailnet" là bind Tailnet trực tiếp (không HTTPS, không Serve/Funnel).
• gateway.bind: "auto" ưu tiên loopback; dùng tailnet nếu bạn muốn chỉ dùng Tailnet.
• Serve/Funnel chỉ phơi bày Giao diện điều khiển Gateway + WS. Các nút kết nối qua cùng endpoint Gateway WS, vì vậy Serve có thể hoạt động cho truy cập nút.

​

Điều khiển trình duyệt (Gateway từ xa + trình duyệt cục bộ)

​

Điều kiện tiên quyết + giới hạn của Tailscale

• Serve yêu cầu HTTPS được bật cho tailnet của bạn; CLI sẽ nhắc nếu thiếu.
• Serve chèn các header danh tính Tailscale; Funnel thì không.
• Funnel yêu cầu Tailscale v1.38.3+, MagicDNS, HTTPS được bật, và một thuộc tính nút funnel.
• Funnel chỉ hỗ trợ các cổng 443, 8443, và 10000 qua TLS.
• Funnel trên macOS yêu cầu biến thể ứng dụng Tailscale mã nguồn mở.

​

Tìm hiểu thêm

• Tổng quan Tailscale Serve: https://tailscale.com/kb/1312/serve
• Lệnh tailscale serve: https://tailscale.com/kb/1242/tailscale-serve
• Tổng quan Tailscale Funnel: https://tailscale.com/kb/1223/tailscale-funnel
• Lệnh tailscale funnel: https://tailscale.com/kb/1311/tailscale-funnel

​

Liên quan

• Truy cập từ xa
• Khám phá
• Xác thực