用会过期的链接让别人往你的 Mac 传大文件
对方没有 Tailscale 账号也能上传:copyparty 的可续传上传页加 TSLink 访客链接,到期自动失效。附实测速度、限制与清理步骤。
最后更新于
有人要给你传文件:相机素材、客户的原始资料、一批照片。对方只用浏览器,文件落在你自己的硬盘上,链接在你定的日期后失效。TSLink 自己没有上传页,本指南把它和 copyparty(MIT 许可)配在一起:copyparty 的浏览器上传会把文件切成块,中断后能续传;TSLink 负责公网可达、会过期、可撤销的访客链接。
以下数据实测于 2026-11-11,用的是 v0.3.1 之后不久的 TSLink main 构建与 copyparty 1.20.26,从另一台机器经公网 Funnel 入口上传。答应别人传 40 GB 之前,先看速度一节。
配置
需要 TSLink v0.4.0 或更新版本,以及一个运行中、已入网的 TSLink 节点,并开通 Tailscale HTTPS 与 Funnel 权限。然后:
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让它在一个终端里一直跑。另开一个终端:
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。
在新安装上,第一条访客链接还会把应用从门户网关上摘下来,并在输出里写明(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 文档写明它受不可配置的带宽限制。实测上传到接收端 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 访问权限,对方装一次 Tailscale,就能用 tailnet 的速度。
撤销与清理
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 与 Tailscale Funnel,访问于 2026-11-11。