Skip to Content
👋 欢迎来到 HowToUseMoltbot 快速入门
网关Tailscale

Tailscale（网关仪表板）

Moltbot 可为网关仪表板与 WebSocket 端口自动配置 Tailscale Serve（tailnet）或 Funnel（公网）。网关保持绑定回环，由 Tailscale 提供 HTTPS、路由及（Serve 时）身份头。

模式

  • serve：经 tailscale serve 的仅 tailnet Serve。网关仍在 127.0.0.1。
  • funnel：经 tailscale funnel 的公网 HTTPS。Moltbot 需要共享密码。
  • off：默认（无 Tailscale 自动化）。

认证

设置 gateway.auth.mode 控制握手：

  • token（设置 CLAWDBOT_GATEWAY_TOKEN 时默认）
  • password（通过 CLAWDBOT_GATEWAY_PASSWORD 或配置的共享密钥）

当 tailscale.mode = "serve" 且 gateway.auth.allowTailscale 为 true 时，有效的 Serve 代理请求可经 Tailscale 身份头（tailscale-user-login）认证而无需提供 token/密码。Moltbot 通过本地 Tailscale 守护进程（tailscale whois）解析 x-forwarded-for 地址并与头匹配后接受。Moltbot 仅在请求来自回环且带有 Tailscale 的 x-forwarded-for、x-forwarded-proto 与 x-forwarded-host 头时将其视为 Serve。要要求显式凭据，设 gateway.auth.allowTailscale: false 或强制 gateway.auth.mode: "password"。

配置示例

仅 Tailnet（Serve）

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

打开：https://<magicdns>/（或你配置的 gateway.controlUi.basePath）

仅 Tailnet（绑定到 Tailnet IP）

当希望网关直接在 Tailnet IP 上监听（无 Serve/Funnel）时使用：

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

从另一 Tailnet 设备连接：

  • 控制 UI：http://<tailscale-ip>:18789/
  • WebSocket：ws://<tailscale-ip>:18789

注：回环（http://127.0.0.1:18789）在此模式下不可用。

公网（Funnel + 共享密码）

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

优先使用 CLAWDBOT_GATEWAY_PASSWORD 而非将密码提交到磁盘。

CLI 示例

moltbot gateway --tailscale serve
moltbot gateway --tailscale funnel --auth password

说明

  • Tailscale Serve/Funnel 需要安装并登录 tailscale CLI。
  • tailscale.mode: "funnel" 除非认证模式为 password，否则拒绝启动，以避免公网暴露。
  • 若希望 Moltbot 在关闭时撤销 tailscale serve 或 tailscale funnel 配置，设 gateway.tailscale.resetOnExit。
  • gateway.bind: "tailnet" 是直接 Tailnet 绑定（无 HTTPS，无 Serve/Funnel）。
  • gateway.bind: "auto" 优先回环；若仅需 Tailnet，使用 tailnet。
  • Serve/Funnel 仅暴露网关控制 UI + WS。节点通过同一网关 WS 端点连接，故 Serve 可用于节点访问。

浏览器控制（远程网关 + 本地浏览器）

若在一台机器上运行网关但想在另一台机器上驱动浏览器，在浏览器机器上运行节点主机，并让两者在同一 tailnet 上。网关会将浏览器操作代理到节点；无需单独控制服务器或 Serve URL。避免将 Funnel 用于浏览器控制；将节点配对视为操作员访问。

Tailscale 前提与限制

  • Serve 需要为 tailnet 启用 HTTPS；CLI 会在缺失时提示。
  • Serve 注入 Tailscale 身份头；Funnel 不注入。
  • Funnel 需要 Tailscale v1.38.3+、MagicDNS、启用 HTTPS 与 funnel 节点属性。
  • Funnel 仅支持端口 443、8443 与 10000（TLS）。
  • macOS 上的 Funnel 需要开源 Tailscale 应用变体。

了解更多

最后更新于:
Setup 设置Tools Invoke HTTP API 工具调用 API