---
title: "用会过期的链接让别人往你的 Mac 传大文件"
description: "对方没有 Tailscale 账号也能上传：copyparty 的可续传上传页加 TSLink 访客链接，到期自动失效。附实测速度、限制与清理步骤。"
url: "https://tslink.md/zh/docs/receive-files"
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`.

有人要给你传文件：相机素材、客户的原始资料、一批照片。对方只用浏览器，文件落在你自己的硬盘上，链接在你定的日期后失效。TSLink 自己没有上传页，本指南把它和 [copyparty](https://github.com/9001/copyparty)(MIT 许可)配在一起：copyparty 的浏览器上传会把文件切成块，中断后能续传；TSLink 负责公网可达、会过期、可撤销的[访客链接](https://tslink.md/zh/docs/guest-links.md)。

以下数据实测于 **2026-11-11**，用的是 v0.3.1 之后不久的 TSLink main 构建与 copyparty 1.20.26，从另一台机器经公网 Funnel 入口上传。答应别人传 40 GB 之前，先看[速度](https://tslink.md/zh/docs/receive-files.md#%E9%80%9F%E5%BA%A6)一节。

## 配置

需要 TSLink v0.4.0 或更新版本，以及一个运行中、已入网的 TSLink 节点，并开通 Tailscale HTTPS 与 Funnel 权限。然后：

```bash
pipx install copyparty            # 或:python3 -m pip install --user copyparty
mkdir -p ~/inbox
copyparty -i 127.0.0.1 -p 3923 -v ~/inbox:/:w -nih -nid --name inbox --bname inbox
```

让它在一个终端里一直跑。另开一个终端：

```bash
tslink add inbox --proxy localhost:3923 --max-request-body 128MiB
tslink guest create inbox --for 3d --label "相机素材" --public --print-link
```

把输出的消息发给对方。对方打开链接，把文件拖进页面并确认即可。

每个参数的作用：

| 参数                          | 作用                                                                                                     |
| --------------------------- | ------------------------------------------------------------------------------------------------------ |
| `-i 127.0.0.1`              | copyparty 只监听本机回环地址，访客链接是唯一入口                                                                          |
| `-v ~/inbox:/:w`            | 只写卷：访客能上传，看不到也下载不了任何文件，包括别人传的                                                                          |
| `-nih -nid`                 | 单横线。copyparty 默认会向每个访客显示你的主机名和磁盘剩余空间                                                                   |
| `--max-request-body 128MiB` | copyparty 的浏览器上传把每块作为单独请求发送，目标 64 MiB，上限 96 MiB。TSLink 默认 32 MiB 的上限会对这些块返回 413;128 MiB 足够，不需要设成几十 GiB |

请求上限尽量在发链接之前定好。之后要改，执行 `tslink limits set inbox --max-request-body <值>`：它只改上限，并重启应用的节点，进行中的上传会中断，对方要重新打开链接。TSLink 会拒绝对带访客链接的应用执行 `tslink add`。

在新安装上，第一条访客链接还会把应用从[门户网关](https://tslink.md/zh/docs/portal-gateway.md)上摘下来，并在输出里写明（`removed_gateway_route`）。如果 `guest create` 报 `portal_route_guest_refused`，说明还有别人依赖这条路由，比如你授权过这个应用的人；提示里会给出下一步命令。如果报 `url_not_ready`，什么都没有保存：执行 `tslink url inbox --wait=30s`，再把同一条命令跑一次。新建链接后的约 30 秒内，公网第一次请求可能失败，Funnel 还在启动。

## 对方看到什么

一个带进度条的 copyparty 上传页。对方关掉标签页、断了 Wi-Fi，或者你这边重启了 copyparty，进度都不会丢：重新打开同一个链接，选同一个文件，copyparty 会跳过已经存下的块。我们测了三种中断：杀掉浏览器、重启 copyparty、在上传方封锁网络 60 秒。三次上传都从断点继续，网络封锁那次完全不用人管。一个 300 MB 文件传完后 SHA-256 两端一致。

## 速度

公网流量经 Tailscale 的 Funnel 中继服务器转发，[Tailscale 的 Funnel 文档](https://tailscale.com/docs/features/tailscale-funnel)写明它受不可配置的带宽限制。实测上传到接收端 Mac 的速度：

| 路径                      | 速度               |
| ----------------------- | ---------------- |
| 公网访客链接（Funnel），浏览器上传，持续 | 0.8 到 1.1 MB/s   |
| 同上，单个 `curl` 上传         | 0.65 到 0.84 MB/s |
| 同一节点、同一应用，走 tailnet     | 35 MB/s          |

上传方的上行带宽是 1.5 Gbit/s，瓶颈在中继，不在 TSLink，也不在网络。按约 1 MB/s 算，1 GB 要 15 到 20 分钟，40 GB 要 11 小时以上。几 GB 用访客链接没问题；几十 GB 更适合给对方这个应用的 [tailnet 访问权限](https://tslink.md/zh/docs/people-sharing.md)，对方装一次 Tailscale，就能用 tailnet 的速度。

## 撤销与清理

```bash
tslink guest list
tslink guest revoke <grant-id>
tslink remove inbox
```

撤销后，链接本身和已经打开的浏览器会话都只会得到统一的 401，正在进行的上传随之停止。`tslink remove` 会撤销这个应用剩下的全部链接。最后一条链接到期时，TSLink 还会关掉公网 Funnel 入口：我们测试时，进行中的上传在截止时间后一秒内停住，之后的请求直接连不上。copyparty 需要自己停掉。中断的上传会以 `*.PARTIAL` 文件留在 `~/inbox`，不要的手动删除。

## 已知限制

* 在 v0.3.1 及更早版本里，`guest create` 不会去掉网关路由（要先执行 `tslink portal route remove inbox`），带访客链接的应用改不了请求上限，访客 gate 生效期间对同一应用再执行 `guest create --print-link` 会报 `url_not_ready`。
* 访客链接是持有即可用的链接，任何拿到它的人在到期前都能上传。介意的话加 `--pin`,PIN 单独发送。
* 这套配置里 copyparty 不限额。注意磁盘剩余空间，或查 copyparty 的卷选项设置大小上限。

来源：[copyparty README](https://github.com/9001/copyparty) 与 [Tailscale Funnel](https://tailscale.com/docs/features/tailscale-funnel)，访问于 **2026-11-11**。
