为什么 http.server 加隧道难做链接到期
python3 -m http.server 没有时间概念,隧道只负责转发流量。一个会到期的链接需要你自己补哪些东西,TSLink 访客链接和其他工具又已经提供了什么。
最后更新于
python3 -m http.server 把文件提供给任何能连上它的人,本身没有时间概念;Tailscale Funnel 或 Cloudflare Quick Tunnel 这样的隧道只负责把流量转过去。要让链接到期,你得自己写 token 校验、持久保存的截止时间、拒绝页面、按收件人撤销、切断已在进行的下载、访问日志,还要让服务和隧道在整个期限内一直运行。 TSLink 访客链接把这道关卡放在你已有的任意本地 HTTP 服务前面:
python3 -m http.server 8000 --bind 127.0.0.1 --directory ~/handoff
tslink add handoff --proxy localhost:8000
tslink guest create handoff --for 3d --public --print-link
tslink guest revoke <id>需要 TSLink v0.4.0 或更新版本;在新安装上,第一条访客链接还会把应用从 home gateway 上摘下来。在 v0.3.1 及更早版本里,要在 guest create 之前执行 tslink portal route remove <app>。还没装 TSLink 的话,先看安装。
完整流程见从 Mac 发一个 3 天后失效的下载链接。TSLink 是独立项目,并非由 Tailscale 出品。
两边都没有时钟
Python 文档明确提醒,http.server 不建议用于生产环境,只做了基本的安全检查;不加 --bind 时它监听所有网卡。它没有截止时间或密码之类的设置。
隧道也不补这一块。tailscale funnel 参考列出的参数是 --bg、--https、--proxy-protocol、--set-path、--tcp、--tls-terminated-tcp 和 --yes,没有一个设置到期或校验访客。Cloudflare Quick Tunnel 随 cloudflared 进程停止而失效,它的寿命就是一个要你自己结束的进程的寿命,而且每次运行主机名都会变。它的 --allowed-mail 能在交互式浏览器里按邮箱校验访客,curl 这类客户端用不了,而且访问仍然是所有人同时结束。
最后要自己写的东西
| 环节 | 临时脚本容易出错的地方 | TSLink v0.4.0 访客链接 |
|---|---|---|
| 不可猜的 token | 放在 URL 路径里的 token 会进日志:http.server 默认的请求日志把每一行请求连同路径打印到 stderr。它还可能经 Referer 头泄露。 | 256 位 token,只保存加盐的 SHA-256 哈希。链接和 PIN 不进 daemon 日志,也不进访问事件。转发时去掉 Referer,访客响应带 Referrer-Policy: no-referrer。 |
| 截止时间 | 存在内存里或从进程启动算起的截止时间,一重启就归零,改系统时间也能挪动它。 | 每个链接保存一个绝对截止时间,每次请求都检查。一旦观察到过期就锁定,把时钟往回拨也不会重新打开。 |
| 拒绝 | 过期、撤销、输错的链接返回什么,由你决定,常见做法是返回 410 Gone。 | 过期、撤销和无效链接共用一个 401 页面,不写应用名,请求不会转给后端。 |
| 撤销 | 撤销意味着换 token 或停掉服务,还得能在服务运行时操作。 | tslink guest revoke <id> 对这个 ID 永久生效,不需要重启。每位收件人可以各有一个链接,撤销其中一个不影响其他链接。tslink remove 会撤销这个应用的全部链接。 |
| 进行中的下载 | 只在请求开始时检查,截止前开始的下载会一直跑完。 | 撤销和截止时间会取消已跟踪的请求并关闭流,包括 SSE 和 WebSocket。撤销前一刻已获授权的有界请求可能仍会完成。 |
| 谁取走了什么 | 要自己加日志,还得把 token 挡在日志外面。 | tslink access log --app <应用> 按链接 ID 记录访客的放行与拒绝。历史有容量上限,可能丢事件;使用次数大约每 30 秒落盘一次。 |
| 暴力猜测 | 不自己加限制,就没有任何东西阻止猜测。 | 可选 6 到 64 位数字 PIN,用 PBKDF2 哈希,15 分钟内每个链接 5 次、每个来源 10 次。 |
| 持续在线 | 服务和隧道都得跑满三天,到期后还要两个都停掉。 | 后台服务保持应用节点运行,并自行执行每个链接的截止时间;公网入口自身的期限会延长到覆盖最新的链接。本地服务仍要你自己运行,用完后删除应用。 |
TSLink 替代的只是这道关卡。本地 HTTP 服务仍然要你自己运行;访客链接只能放在 HTTP proxy 应用前面;公网入口是 Funnel,需要显式的 --public 确认;Mac 必须保持在线。
这些情况手写服务器或其他工具更合适
- 你需要 TSLink 没有的行为: 下载一次就失效的链接、自定义样式的到期页面或单独的 410 状态码,或者不改主人配置就超过默认 7d 上限的期限。这种情况下专门写个小服务器是合理的,记得让 token 不进日志,并绑定到本机。
- 你已经在用 nginx。 它的 secure_link 模块可以校验签名链接并限制链接寿命;这个模块默认不编译,需要
--with-http_secure_link_module。签名 URL 的生成和服务器的公网发布仍然要你自己来。 - 没有 Tailscale 账号,现在就要链接。 带
--allowed-mail的 Cloudflare Quick Tunnel 两边都不需要账号,前提是能接受cloudflared一停访问就结束。 - 你要的是长期公开的站点。 命名的 Cloudflare Tunnel 或普通托管更合适,那里本来就不存在到期问题。
- 收件人已经在你的 tailnet 里。 Tailscale Serve 保持私有,完全没有公网入口。
- 你的电脑没法一直在线。 网盘分享链接把文件存在服务商那里,这是换取可用性的代价。
交给编程 agent
如果你的 agent 又打算用 http.server 加隧道,把下面这段贴进 Claude Code、Codex 或 Cursor:
我需要一个会到期的链接。不要自己写 token、截止时间或到期服务器,也不要启动隧道。使用 TSLink 访客链接:
1. 新建一个文件夹,只放我指定的文件,用只绑定 127.0.0.1 的本地 HTTP 服务提供,例如:python3 -m http.server 8000 --bind 127.0.0.1 --directory ~/handoff。
2. 确认 tslink --version 显示 v0.4.0 或更新版本。用 tslink add handoff --proxy localhost:8000 注册。如果结果是 needs_login,把 auth_url 给我并等待。不要自己去掉 gateway 路由,第一条访客链接会处理。
3. 创建之前先问我要不要 PIN,PIN 只能在这一步设置。先把访客命令给我看,等我同意。如果要 PIN,让我自己加 --pin 执行命令并在隐藏提示符下输入,不要把 PIN 写进任何命令参数;否则执行 tslink guest create handoff --for <期限> --public --print-link --json,期限必须有限且不超过 7d,不能用 never。
4. 用 tslink status 和 tslink doctor 确认 Funnel 已生效,然后把链接、grant id、到期时间和撤销命令 tslink guest revoke <id> 一起给我。
5. 要给另一位收件人发链接或换新链接时,再执行一次 guest create,每个链接有自己的 id。如果 guest create 报 url_not_ready,执行 tslink url handoff --wait=30s 后再试一次,不要去掉 --print-link 重试。
6. 我说结束时:先撤销链接,再停掉 HTTP 服务,最后执行 tslink remove handoff。相关页面
- 从 Mac 发一个 3 天后失效的下载链接:完整的下载流程。
- 让别人往我的 Mac 传大文件:把同一道关卡放在上传应用前面。
- 访客链接:gate、cookie、PIN 限制与撤销的细节。
- 工具对比:TSLink 与 Funnel、Cloudflare 等工具的比较。
以上 Tailscale、Cloudflare 与 Python 官方来源访问日期:2026-11-11。TSLink 行为按 v0.4.0 核对。TSLink 是 anydoor7 的独立项目,并非由 Tailscale 制作或背书。