2026/03/08

用 TSLink 分享第一个本地服务

安装 TSLink,分享已有应用或文件,按提示批准节点,再获取私有 URL。

安装 TSLink v0.1.1。

分享已有应用

先让应用在 localhost:3000 运行,再执行:

bash
tslink share 3000 --name preview --json

第一次运行不需要存储 Tailscale API token 或 OAuth client。TSLink 可能为新节点返回 data.status: needs_login 和 data.auth_url。由人打开该 URL 并批准节点。此命令不会把应用公开到互联网。

批准后取回实际地址:

bash
tslink url preview --wait

在登录同一 tailnet、且获其策略允许的另一台设备上打开返回的地址。准确 hostname 以 TSLink 输出为准,不能把示意地址当作已生效。

分享生成的文件

bash
tslink share ./report.html --name report --json

这适合 agent 将生成的报告交给人。如果结果需要批准,agent 应把 data.auth_url 交给人,之后用 tslink url report --wait 继续。本地 MCP client 见 MCP 控制服务器配置;托管他人的 HTTP MCP 服务器见 MCP 托管。

保留注册服务

需要具名代理时,执行 tslink add app-preview --proxy localhost:3000 --json。默认情况下,add 保存服务并确保后台网关运行。如果返回 data.status: needs_login,打开 data.auth_url 并批准新节点,再用 tslink url app-preview --wait 取回实际地址。用 tslink status --json 检查就绪状态。为打标签、长期运行的多服务场景存储凭据,可选用 tslink login。快速开始解释该分支和服务生命周期。