Skip to Content
TSLinkTSLink 文档

从 Mac 发一个 3 天后失效的下载链接

用只监听本机的 Web 服务提供文件,再在前面挂一个 3 天期限的 TSLink 访客链接。收件人只需要浏览器,你也可以提前撤销。

最后更新于

查看 Markdown

在 Mac 上起一个只监听本机的小型 Web 服务来提供文件,用 TSLink 注册这个服务,再创建一个 --for 3d 的访客链接。收件人用浏览器打开链接,不需要 Tailscale 账号。三天后,或者你提前撤销之后,同一个链接只会返回 HTTP 401 不可用页面,请求也不会再转给你的文件服务。 用 Python 自带的服务器,在第一个终端里执行:

bash
mkdir -p ~/handoff && cp ~/Desktop/report.pdf ~/handoff/
python3 -m http.server 8000 --bind 127.0.0.1 --directory ~/handoff

再打开第二个终端:

bash
tslink add handoff --proxy localhost:8000
tslink guest create handoff --for 3d --label "Report for Acme" --public --print-link

需要 TSLink v0.4.0 或更新版本。最后一条命令只打印一次链接,把它发给收件人即可,对方什么都不用装。TSLink 是独立项目,并非由 Tailscale 出品。

开始之前

  • 已安装 TSLink。 见安装。没装 Xcode Command Line Tools 的 Mac 第一次运行 python3 时,可能会提示安装它们。
  • 一个开启了 MagicDNS 和 HTTPS 的 Tailscale 账号。 TSLink 内嵌 Tailscale,Mac 上不需要装 Tailscale 应用。
  • Funnel 权限。 访客链接经 Tailscale Funnel 到达公网,Funnel 要求 tailnet 策略文件里有 funnel 节点属性。对明确公开的服务,TSLink 默认会在拥有可用 API 权限和策略权限的情况下自动写入这条策略;否则按 Tailscale 的 Funnel 文档自己加上。
  • Mac 在整个期限内保持唤醒和联网。 文件从你的磁盘读出,Mac、Python 服务和 TSLink 都在运行,链接才能用。
  • 起一个不暴露信息的应用名。 HTTPS 名字会出现在公开的证书日志里,所以用 handoff 这类中性名字,不要用客户的名字。

每一步在做什么

  1. 只把这一个文件放进单独的文件夹。 Python 服务会在 / 列出整个文件夹并提供其中所有文件,所以不要让它指向主目录。--bind 127.0.0.1 让同一 Wi-Fi 下的其他设备无法直接访问;不加这个参数时,它默认监听所有网卡。
  2. 注册私有应用。 tslink add handoff --proxy localhost:8000 把这个服务注册为私有 HTTP proxy 应用,必要时启动后台服务。第一次运行可能返回带 auth_url 的 needs_login:在浏览器里打开一次,让节点入网,再做下一步,否则 guest create 会停在 enrollment_required。新安装还会给应用在 home gateway 上加一条路由,不用你自己去掉。
  3. 先决定要不要 PIN,再创建链接。 PIN 只能在创建链接时设置。链接可能外传的话,给 guest create 加上 --pin,在隐藏提示符下输入 6 到 64 位数字,再通过另一个渠道把 PIN 发给对方;不要把 PIN 写进命令参数。--for 必填,最短 1h,默认最长 7d(见期限)。--public 表示你确认应用会经 Funnel 暴露到公网,并由强制的访客 gate 把关。--print-link 只展示一次链接;TSLink 只保存 token 的加盐哈希,链接丢了无法再找回。第一条链接会在同一步里把应用从 home gateway 上摘下来,并在输出里写明(removed_gateway_route)。guest create 最多等 8 秒拿到应用地址;仍然报 url_not_ready 的话,什么都没有保存:执行 tslink url handoff --wait=30s,再把同一条命令跑一次。如果还有别人在用这条 gateway 路由,比如你授权过这个应用的人,它会报 portal_route_guest_refused,不做任何改动,并给出下一步命令。
  4. 发送前确认链接已生效。 guest create 只保存配置,由后台服务负责应用。执行 tslink status 和 tslink doctor;doctor 无法确认带 gate 的应用已开启 Funnel 时会给出警告。一个应用名第一次公开时,按 Tailscale 的说明,公网 DNS 记录最多可能要 10 分钟才出现。想自己试一下链接,要用 tailnet 之外的设备,比如关掉 Tailscale、走蜂窝数据的手机:在 tailnet 内部打开访客链接只会跳转到 /,不会建立访客会话。

收件人看到什么

链接打开的是应用 *.ts.net 地址下的 /guest/<token>。TSLink 写入会话 cookie 后跳转到 /,Python 的目录列表里就是 report.pdf。设置了 PIN 的话,会先出现一个输入 PIN 的小表单。过期、已撤销或输错的链接显示同一个不可用页面,页面不写应用名,只提示重新打开原始链接或联系发送者。

查看、撤销与清理

bash
tslink guest list
tslink access log --app handoff --since 24h
tslink guest revoke <id>
tslink remove handoff

guest list 列出每个链接的 ID、到期时间和使用次数。撤销对这个 ID 永久生效,同时取消进行中的请求并关闭连接。tslink remove 会撤销这个应用剩下的全部链接,之后用同一个名字重新添加的应用也不会让它们复活。用完后按 Ctrl-C 停掉 Python 服务。使用次数只是本地估计,访问历史有容量上限,可能有缺口。

需要新链接或 PIN 时

再执行一次 guest create:每个链接有自己的 ID、截止时间和可选的 PIN,第一个链接还有效时也能创建第二个。PIN 只能在创建链接时设置,所以给新命令加上 --pin;旧链接要停用的话,用 tslink guest revoke <id> 撤销。guest create 失败后不要去掉 --print-link 重试:那样会成功,但保存下来的链接谁也拿不到,遇到这种授权要撤销。

在 v0.3.1 及更早版本里,guest create 不会去掉 gateway 路由(要先执行 tslink portal route remove <app>),访客 gate 生效期间对同一应用再执行 guest create --print-link 会报 url_not_ready。直接升级,比绕开这些限制省事。

需要知道的限制

  • 访客链接只支持 HTTP proxy 应用。 用 tslink add --dir 或 tslink share <路径> 注册的文件夹和文件只在 tailnet 内可见,所以要自己起一个本地 Web 服务。TSLink 本身不向访客提供文件。
  • 链接是公开、可转发的凭证。 截止前,拿到链接(以及设置了的 PIN)的人都能下载。label 只是你自己的备注,不能说明是谁访问的。
  • 到期收不回已下载的文件。 撤销和截止时间会挡住新请求,并关闭正在进行的下载;撤销前一刻已获授权的请求可能仍会完成,已经保存下来的文件留在对方手里。
  • 默认上限是七天。 主人可以在 config.json 里用 durations.public_max 调高,比如 14d。访客链接不接受 never。
  • Funnel 有带宽限制。 Tailscale 说明 Funnel 流量受不可配置的带宽限制。我们没有测过经访客链接下载的速度,依赖它之前先用大文件自己试一次。特别大的文件,传输服务或按人授权的私有访问可能更合适;访客 gate 生效期间,应用不能新增人员授权,所以要另用一个应用名;对 tailnet 之外的人还需要已保存的 Tailscale API token。

这些情况换别的工具更合适

方案适合什么情况代价
Tailscale Serve收件人已经在你的 tailnet 里,或者就是你自己的设备。不会有任何东西公开。收件人要装 Tailscale;Serve 没有截止时间。
单独用 Tailscale Funnel链接一直公开也没关系。它的命令行参数里没有到期和访客校验,要自己去停。
Cloudflare Quick Tunnel今天就要链接,又没有 Tailscale 账号。--allowed-mail 只放行列出的邮箱,每个访客在交互式浏览器里用一次性 PIN 验证邮箱。cloudflared 一停所有人同时失去访问,每次运行主机名都会变,邮箱校验不支持 curl 这类非交互客户端,Cloudflare 把它定位为测试和开发用途。
命名的 Cloudflare Tunnel 或正式托管要一个长期公开、不需要到期的站点。账号、域名和访问策略都要自己管。
网盘分享链接(Dropbox、Google Drive 等)收件人方便最重要,或者 Mac 撑不了三天在线。文件要上传到服务商的存储里。

如果你正打算自己写一个带 token 和截止时间的服务器,可以先看为什么 http.server 加隧道难做链接到期,里面列了要补的东西。

交给编程 agent

把下面这段贴进 Claude Code、Codex 或 Cursor,改掉文件路径和收件人:

代码
用 TSLink 访客链接,把 ~/Desktop/report.pdf 发给一位外部收件人,链接 3 天后失效。按以下规则执行:
1. 新建文件夹 ~/handoff,只把这一个文件复制进去。用只绑定 127.0.0.1 的本地 HTTP 服务提供它,例如:python3 -m http.server 8000 --bind 127.0.0.1 --directory ~/handoff,并让它在后台持续运行。
2. 确认 tslink --version 显示 v0.4.0 或更新版本。注册为私有 TSLink 应用:tslink add handoff --proxy localhost:8000。如果结果是 needs_login,把 auth_url 给我,等我打开。不要自己去掉 gateway 路由,第一条访客链接会处理。
3. 创建之前先问我要不要 PIN,PIN 只能在这一步设置。公开任何东西之前,先把访客命令给我看,等我同意。如果我要 PIN,让我自己加 --pin 执行这条命令,在隐藏提示符下输入,不要把 PIN 写进任何命令参数;否则执行:tslink guest create handoff --for 3d --label "<收件人>" --public --print-link --json。期限不得超过 7d,也不能用 never。
4. 执行 tslink status 和 tslink doctor,确认 Funnel 已生效;新的公网名字最多可能要 10 分钟才能解析。然后把链接、grant id、到期时间和撤销命令 tslink guest revoke <id> 一起给我。
5. 不要自己写 token 或到期服务器,也不要另起隧道。要新链接时,再执行一次 guest create;我要求时再撤销旧链接。如果 guest create 报 url_not_ready,执行 tslink url handoff --wait=30s 后再试一次,不要去掉 --print-link 重试。
6. 我说结束时:先执行 tslink guest revoke <id>,再停掉 HTTP 服务,最后执行 tslink remove handoff。

接入了 TSLink MCP 服务的 agent 也可以改用 guest_create,传 public: true 和 print_link: true;访客相关工具需要 owner 角色。

相关页面

以上 Tailscale、Cloudflare 与 Python 官方来源访问日期:2026-11-11。TSLink 行为按 v0.4.0 核对;吞吐数据来自 v0.3.1 之后不久的一个 main 分支构建上的一次测试。TSLink 是 anydoor7 的独立项目,并非由 Tailscale 制作或背书。

目录