Skip to Content
TSLinkTSLink 文档

把活动照片收进自己电脑,宾客免注册

婚礼或聚会上 30 位宾客的照片,不用注册账号:运行一个只写文件夹的上传应用,前面挂一个 TSLink 访客链接,活动结束后自动到期。

最后更新于

查看 Markdown

在电脑上运行 copyparty 这类上传应用并开一个只写文件夹,前面挂一个 TSLink 访客链接,把这个链接发给宾客,有效期一两天。宾客用手机浏览器上传,不用注册账号,也不用装应用;照片直接落到你自己的磁盘上,到截止时间或你撤销后链接就失效。 假设上传应用在 127.0.0.1:3923 上监听:

bash
tslink add photos --proxy localhost:3923 --max-request-body 128MiB --request-read-timeout 2m
tslink guest create photos --for 2d --label "Wedding guests" --public --print-link

需要 TSLink v0.4.0 或更新版本;在新安装上,第一条访客链接还会把应用从 home gateway 上摘下来。打印出的链接本身就是钥匙,做桌卡二维码时请用 qrencode 这类离线工具,不要用网站。TSLink 是独立项目,并非由 Tailscale 出品。

配置上传应用

TSLink 不提供上传页面,它只在你运行的应用前面加一道限时 gate。copyparty 适合这个场景,因为它的浏览器上传器按分块发送并支持续传(见上传说明),场地 Wi-Fi 或蜂窝信号不稳时更从容。

我们测试过的 copyparty 配置和实测数据见接收大文件。简单说,把它配置成:

  • 只监听 127.0.0.1(copyparty 的 -i,默认监听所有网卡,见 --help 源码);
  • 访客对一个文件夹只有写入权限(copyparty 的 w 权限),宾客之间看不到也下载不了彼此的照片(见账号与卷);
  • 用 -nih 和 -nid 隐藏主机名和磁盘用量(单横线,见 --help 源码)。

TSLink 默认把单个请求限制在 32 MiB,低于 copyparty 默认最大 96 MiB 的分块(见 u2sz)。copyparty 的 README 建议把代理上限调到至少 96 MiB,或者用 --u2sz 调小分块,所以默认分块下 --max-request-body 128MiB 是合理的上限,它限制的是访客单个请求能发多少。我们测试时,用默认上限的情况下每个分块都收到 413:页面一直显示有传输速度,服务器上却什么都没存下。--request-read-timeout 2m 让中途停顿的手机比默认的 30 秒读取空闲多一些余量。我们用 copyparty 1.20.26 和 v0.3.1 之后不久的一个 main 分支构建测试时,不加 --preserve-host,经访客链接的浏览器上传也能成功;如果彩排时上传被拒,在创建链接之前给 tslink add 加上 --preserve-host(copyparty 会检查 Origin 头,见它的 cors 说明)。上限怎么定,见让别人往我的 Mac 传大文件。

印桌卡之前先定好上限。 之后也能用 tslink limits set photos --max-request-body <大小> 调高上限,链接不用换,但这会重启应用的节点:进行中的上传会中断,宾客要重新打开链接。TSLink 会拒绝对带访客链接的应用执行 tslink add,所以之后要加 --preserve-host,就得删除应用,桌卡上的链接也会随之撤销。

一个共用链接,不设 PIN,期限要短

所有宾客共用一个链接。不要设 PIN:TSLink 对每个链接在 15 分钟内只允许 5 次 PIN 校验,成功的校验也计入;同一来源地址跨链接还有 10 次的限制。30 位宾客在同一个链接上输 PIN 会把它锁住,而连着同一个场地 Wi-Fi 的宾客可能共用一个公网地址。链接本身带有 256 位 token,所以像保管桌卡一样保管它:只发给宾客,期限尽量短。

  • 定好时间窗口。 --for 2d 覆盖当天和第二天上午;最短 1h,默认最长 7d。
  • 链接外泄时,用同一条 guest create 命令建一个新链接,再用 tslink guest revoke <id> 撤销旧的,所有宾客都要拿新链接。第一个链接还有效时也能创建第二个,所以也可以给晚到的一批人单独发一个链接,之后单独撤销。
  • 重启不致命。 链接和截止时间会持久保存,但访客会话保存在内存里,TSLink 重启后宾客重新打开链接即可。

活动之前

  • 已安装 TSLink(见安装),开启了 MagicDNS 和 HTTPS 的 Tailscale 账号,以及 Funnel 权限。 Tailscale Funnel 要求 tailnet 策略文件里有 funnel 节点属性。对明确公开的服务,TSLink 默认会在拥有可用 API 权限和策略权限的情况下自动写入;否则自己加上。
  • 让节点入网。 第一次 tslink add 可能返回带 auth_url 的 needs_login,在 guest create 之前打开一次。如果 guest create 报 url_not_ready,什么都没有保存:执行 tslink url photos --wait=30s,再把同一条命令跑一次。
  • 提前一天搭好。 新的公网名字最多可能要 10 分钟才出现在公网 DNS 里,你也需要时间彩排。
  • 用关掉 Tailscale、走蜂窝数据的手机彩排一遍。 tailnet 内的设备连到的是私有入口,在那里打开访客链接只会跳转到 /,不会建立访客会话,测不出宾客实际看到的页面。tslink status 和 tslink doctor 用来确认 Funnel 已生效,doctor 无法确认时会给出警告。
  • 电脑在整个窗口期保持唤醒、联网,并留足磁盘空间。

活动中与活动后

bash
tslink guest list
tslink access log --app photos --since 24h
tslink guest revoke <id>
tslink remove photos

guest list 显示每个链接的使用次数;访问历史按链接 ID 而不是按人记录访客的放行与拒绝,并且有容量上限。撤销或到期会中断进行中的上传,所以等最后一位宾客传完再撤销。tslink remove 也会撤销这个应用剩下的全部链接。然后停掉上传应用,照片留在上传文件夹里。

v0.3.1 及更早版本

在 v0.3.1 及更早版本里,guest create 不会去掉 gateway 路由(要先执行 tslink portal route remove <app>),带访客链接的应用改不了请求上限,访客 gate 生效期间对同一应用再执行 guest create --print-link 会报 url_not_ready。活动之前先升级。任何版本上,guest create 失败后都不要去掉 --print-link 重试:那样会成功,但保存下来的链接谁也拿不到,遇到这种授权要撤销。

需要知道的限制

  • 拿到链接的人都能上传,包括被转发到的人,直到链接到期。只写权限能把影响限制在多出一些不想要的文件,但挡不住上传本身。
  • TSLink 不负责续传,也不管理文件。 续传、文件名、重复文件和存储都由上传应用负责。
  • 电脑必须一直在线。 电脑睡眠时链接不可用,唤醒后恢复。
  • Funnel 很慢。 Tailscale 说明 Funnel 流量受不可配置的带宽限制。2026-11-11 我们经 Funnel 做的上传测试里,单个 curl 上传是 0.65 到 0.84 MB/s,浏览器持续上传是 0.8 到 1.5 MB/s,只是一天的结果;按约 1 MB/s 算,一条连接每小时大约传 3.5 GB。很多宾客同时上传的情况我们没有测过。
  • 访客链接只支持 HTTP proxy 应用,所以上传应用必不可少。

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

方案适合什么情况代价
Dropbox 文件请求想要最简单的宾客体验,或者电脑撑不了一直在线。宾客不需要 Dropbox 账号。照片进入 Dropbox 存储。Basic、Plus 和 Family 方案单个文件最大 2 GB;设截止时间要更高的方案。
单独用 copyparty你接受 copyparty 自带的分享链接(可以设密码、到期时间并允许上传),并且已有发布它的办法。要自己发布。TSLink 提供经 Funnel 的 ts.net 地址,不用在路由器上开端口,并在应用前面执行截止时间和撤销,进行中的上传也会被切断。
Tailscale Serve所有上传的人都已经在你的 tailnet 里。宾客得装 Tailscale,大多数活动用不了。
Cloudflare Quick Tunnel不想用 Tailscale 账号。要么每位访客都在浏览器里用 --allowed-mail 验证邮箱,要么链接完全开放;只面向测试和开发;cloudflared 一停访问就结束。

交给编程 agent

把下面这段贴进 Claude Code、Codex 或 Cursor:

代码
通过一个所有宾客共用的 TSLink 访客链接,在 2 天内把大约 30 位婚礼宾客的照片收进这台电脑。宾客都没有账号。按以下规则执行:
1. 使用 copyparty,按它的官方 README 配置,不要自己写上传服务器。只监听 127.0.0.1,端口 3923,只开放一个文件夹 ~/wedding-photos,访客可以写入但不能浏览,用 -nih 和 -nid 隐藏主机名和磁盘用量。让它在后台持续运行。
2. 确认 tslink --version 显示 v0.4.0 或更新版本。注册应用:tslink add photos --proxy localhost:3923 --max-request-body 128MiB --request-read-timeout 2m。如果结果是 needs_login,把 auth_url 给我并等待。不要自己去掉 gateway 路由,第一条访客链接会处理。
3. 公开任何东西之前,先把访客命令给我看,等我同意。然后执行:tslink guest create photos --for 2d --label "Wedding guests" --public --print-link --json。不设 PIN,因为很多宾客共用一个链接。期限不得超过 7d,也不能用 never。如果 guest create 报 url_not_ready,执行 tslink url photos --wait=30s 后再试一次,不要去掉 --print-link 重试。
4. 用 tslink status 和 tslink doctor 确认 Funnel 已生效,然后把链接、grant id、到期时间和撤销命令 tslink guest revoke <id> 一起给我。二维码用 qrencode 这类离线工具生成,不要用网站。让我用关掉 Tailscale 的手机测试一次上传。如果上传收到 HTTP 413,用 tslink limits set photos --max-request-body <大小> 调高上限;如果是别的原因导致上传失败,解决办法是执行 tslink remove photos,再加上 --preserve-host 重新添加并创建新链接。
5. 活动结束、我说可以时:先执行 tslink guest revoke <id>,再停掉 copyparty,最后执行 tslink remove photos。不要删除或移动 ~/wedding-photos 里的任何东西。

相关页面

以上 Tailscale、Cloudflare、Dropbox 与 copyparty 官方来源访问日期:2026-11-11(copyparty README 与源码固定在提交 1af7efe)。TSLink 行为按 v0.4.0 核对;吞吐与 copyparty 相关的观察来自一次测试,使用 copyparty 1.20.26 和 v0.3.1 之后不久的一个 main 分支构建。TSLink 是 anydoor7 的独立项目,并非由 Tailscale 制作或背书。

目录