无极开物Docs

远程访问 (Tailscale)

通过 Tailscale Serve 在手机/笔记本电脑上使用 HTTPS 安全上下文。

Kaiwu 依赖浏览器的“安全上下文”(Secure Context)特性(如 WebCrypto)。浏览器会将 http://localhost 视为安全上下文,但不会将 http://⟦K3⟧:⟦K4⟧ 或 http://⟦K5⟧:⟦K6⟧ 视为安全上下文。

如需远程访问(例如通过手机、另一台笔记本电脑等),应当使用 HTTPS。

推荐方案是使用 Tailscale Serve,它能为你的设备提供一个仅在 Tailnet 内可访问的 https://*.ts.net URL。

快速开始

  1. 在电脑上安装 Tailscale 并登录。

  2. 启用 Serve:

hstack tailscale enable
hstack tailscale url
  1. 在另一台同样登录了 Tailscale 的设备上,打开来自 hstack tailscale url 的 URL。

提示:在 iOS 上,可以通过 Safari 的“添加到主屏幕”功能将其当作 App 来使用。

自动化配置

如果已经配置了 Serve,除非显式设置了 KAIWU_STACK_SERVER_URL,否则 hstack start 会自动优先使用 https://*.ts.net URL 作为规范/分享链接。

提示:对于自托管服务器,建议同时设置 KAIWU_PUBLIC_SERVER_URL(通常设为相同的 https://*.ts.net URL)。该值会由服务器通过 GET /v1/features 对外宣告,也是客户端嵌入二维码或深度链接中的地址。

你也可以让 hstack 在启动时自动启用 Serve:

KAIWU_STACK_TAILSCALE_SERVE=1 hstack start

常用调节选项:

  • KAIWU_STACK_TAILSCALE_WAIT_MS
  • KAIWU_TAILSCALE_BIN(推荐的统一覆盖项)
  • KAIWU_STACK_TAILSCALE_BIN(旧版特定栈别名)

使用原生移动端 App(可选)

Kaiwu 移动端 App 的开发者模式中提供了“API Endpoint”(或“自定义服务器 URL”)设置项。 将其指向相同的 HTTPS *.ts.net URL,即可连接你的本地服务器。

不过,通常最省心的方式还是直接使用 Serve 提供的 Web UI(无需更新 App)。

© 乾元执中(南京)科技有限公司 · WUJI-Labs

On this page