远程访问 (Tailscale)
通过 Tailscale Serve 在手机/笔记本电脑上使用 HTTPS 安全上下文。
Kaiwu 依赖浏览器的“安全上下文”(Secure Context)特性(如 WebCrypto)。浏览器会将 http://localhost 视为安全上下文,但不会将 http://⟦K3⟧:⟦K4⟧ 或 http://⟦K5⟧:⟦K6⟧ 视为安全上下文。
如需远程访问(例如通过手机、另一台笔记本电脑等),应当使用 HTTPS。
推荐方案是使用 Tailscale Serve,它能为你的设备提供一个仅在 Tailnet 内可访问的 https://*.ts.net URL。
快速开始
-
在电脑上安装 Tailscale 并登录。
-
启用 Serve:
hstack tailscale enable
hstack tailscale url- 在另一台同样登录了 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_MSKAIWU_TAILSCALE_BIN(推荐的统一覆盖项)KAIWU_STACK_TAILSCALE_BIN(旧版特定栈别名)
使用原生移动端 App(可选)
Kaiwu 移动端 App 的开发者模式中提供了“API Endpoint”(或“自定义服务器 URL”)设置项。
将其指向相同的 HTTPS *.ts.net URL,即可连接你的本地服务器。
不过,通常最省心的方式还是直接使用 Serve 提供的 Web UI(无需更新 App)。