---
title: "从 Mac 发一个 3 天后失效的下载链接"
description: "用只监听本机的 Web 服务提供文件，再在前面挂一个 3 天期限的 TSLink 访客链接。收件人只需要浏览器，你也可以提前撤销。"
url: "https://tslink.md/zh/docs/expiring-download-link"
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`.

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

## 每一步在做什么

1. **只把这一个文件放进单独的文件夹。** Python 服务会在 `/` 列出整个文件夹并提供其中所有文件，所以不要让它指向主目录。`--bind 127.0.0.1` 让同一 Wi-Fi 下的其他设备无法直接访问；不加这个参数时，它默认[监听所有网卡](https://docs.python.org/3/library/http.server.html)。
2. **注册私有应用。** `tslink add handoff --proxy localhost:8000` 把这个服务注册为私有 HTTP proxy 应用，必要时启动后台服务。第一次运行可能返回带 `auth_url` 的 `needs_login`：在浏览器里打开一次，让节点入网，再做下一步，否则 `guest create` 会停在 `enrollment_required`。新安装还会给应用在 [home gateway](https://tslink.md/zh/docs/portal-gateway.md) 上加一条路由，不用你自己去掉。
3. **先决定要不要 PIN，再创建链接。** PIN 只能在创建链接时设置。链接可能外传的话，给 `guest create` 加上 `--pin`，在隐藏提示符下输入 6 到 64 位数字，再通过另一个渠道把 PIN 发给对方；不要把 PIN 写进命令参数。`--for` 必填，最短 1h，默认最长 7d（见[期限](https://tslink.md/zh/docs/durations.md)）。`--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 分钟](https://tailscale.com/docs/features/tailscale-funnel)才出现。想自己试一下链接，要用 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 服务。使用次数只是本地估计，[访问历史](https://tslink.md/zh/docs/access-history.md)有容量上限，可能有缺口。

### 需要新链接或 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 流量受不可配置的带宽限制。我们没有测过经访客链接下载的速度，依赖它之前先用大文件自己试一次。特别大的文件，传输服务或[按人授权的私有访问](https://tslink.md/zh/docs/people-sharing.md)可能更合适；访客 gate 生效期间，应用不能新增人员授权，所以要另用一个应用名；对 tailnet 之外的人还需要已保存的 Tailscale API token。

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

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

如果你正打算自己写一个带 token 和截止时间的服务器，可以先看[为什么 http.server 加隧道难做链接到期](https://tslink.md/zh/docs/http-server-tunnel-expiry.md)，里面列了要补的东西。

## 交给编程 agent

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

```text
用 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 服务](https://tslink.md/zh/docs/mcp-server.md)的 agent 也可以改用 `guest_create`，传 `public: true` 和 `print_link: true`；访客相关工具需要 owner 角色。

## 相关页面

* [访客链接](https://tslink.md/zh/docs/guest-links.md)：gate、PIN、cookie 与撤销的细节。
* [让别人往我的 Mac 传大文件](https://tslink.md/zh/docs/upload-big-files-to-mac.md)：同样的做法，方向反过来。
* [私有分享一份 HTML 报告，并设置访问截止时间](https://tslink.md/zh/docs/private-html-report.md)：收件人能用 Tailscale 时的做法。
* [工具对比](https://tslink.md/zh/docs/comparisons.md)：TSLink 与 Serve、Funnel、Cloudflare 等工具的比较。

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