---
title: "为什么 http.server 加隧道难做链接到期"
description: "python3 -m http.server 没有时间概念，隧道只负责转发流量。一个会到期的链接需要你自己补哪些东西，TSLink 访客链接和其他工具又已经提供了什么。"
url: "https://tslink.md/zh/docs/http-server-tunnel-expiry"
locale: "zh"
product_version: "0.4.0"
source: "https://github.com/anydoor7/tslink/blob/v0.4.0/docs/guest-links.md"
---

> Documentation index: https://tslink.md/zh/llms.txt · Installed binary is authoritative: `tslink manifest`.

**`python3 -m http.server` 把文件提供给任何能连上它的人，本身没有时间概念；Tailscale Funnel 或 Cloudflare Quick Tunnel 这样的隧道只负责把流量转过去。要让链接到期，你得自己写 token 校验、持久保存的截止时间、拒绝页面、按收件人撤销、切断已在进行的下载、访问日志，还要让服务和隧道在整个期限内一直运行。** TSLink 访客链接把这道关卡放在你已有的任意本地 HTTP 服务前面：

```bash
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 的话，先看[安装](https://tslink.md/zh/docs/installation.md)。

完整流程见[从 Mac 发一个 3 天后失效的下载链接](https://tslink.md/zh/docs/expiring-download-link.md)。TSLink 是独立项目，并非由 Tailscale 出品。

## 两边都没有时钟

Python 文档明确提醒，[http.server](https://docs.python.org/3/library/http.server.html) 不建议用于生产环境，只做了基本的安全检查；不加 `--bind` 时它监听所有网卡。它没有截止时间或密码之类的设置。

隧道也不补这一块。[`tailscale funnel` 参考](https://tailscale.com/docs/reference/tailscale-cli/funnel)列出的参数是 `--bg`、`--https`、`--proxy-protocol`、`--set-path`、`--tcp`、`--tls-terminated-tcp` 和 `--yes`，没有一个设置到期或校验访客。[Cloudflare Quick Tunnel](https://developers.cloudflare.com/cloudflare-one/networks/connectors/cloudflare-tunnel/do-more-with-tunnels/trycloudflare/) 随 `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 模块](https://nginx.org/en/docs/http/ngx_http_secure_link_module.html)可以校验签名链接并限制链接寿命；这个模块默认不编译，需要 `--with-http_secure_link_module`。签名 URL 的生成和服务器的公网发布仍然要你自己来。
* **没有 Tailscale 账号，现在就要链接。** 带 `--allowed-mail` 的 Cloudflare Quick Tunnel 两边都不需要账号，前提是能接受 `cloudflared` 一停访问就结束。
* **你要的是长期公开的站点。** 命名的 Cloudflare Tunnel 或普通托管更合适，那里本来就不存在到期问题。
* **收件人已经在你的 tailnet 里。** [Tailscale Serve](https://tailscale.com/docs/reference/tailscale-cli/serve) 保持私有，完全没有公网入口。
* **你的电脑没法一直在线。** 网盘分享链接把文件存在服务商那里，这是换取可用性的代价。

## 交给编程 agent

如果你的 agent 又打算用 `http.server` 加隧道，把下面这段贴进 Claude Code、Codex 或 Cursor：

```text
我需要一个会到期的链接。不要自己写 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 天后失效的下载链接](https://tslink.md/zh/docs/expiring-download-link.md)：完整的下载流程。
* [让别人往我的 Mac 传大文件](https://tslink.md/zh/docs/upload-big-files-to-mac.md)：把同一道关卡放在上传应用前面。
* [访客链接](https://tslink.md/zh/docs/guest-links.md)：gate、cookie、PIN 限制与撤销的细节。
* [工具对比](https://tslink.md/zh/docs/comparisons.md)：TSLink 与 Funnel、Cloudflare 等工具的比较。

以上 Tailscale、Cloudflare 与 Python 官方来源访问日期：**2026-11-11**。TSLink 行为按 **v0.4.0** 核对。TSLink 是 [anydoor7](https://github.com/anydoor7/tslink) 的独立项目，**并非由 Tailscale 制作或背书**。
