---
title: "把活动照片收进自己电脑，宾客免注册"
description: "婚礼或聚会上 30 位宾客的照片，不用注册账号：运行一个只写文件夹的上传应用，前面挂一个 TSLink 访客链接，活动结束后自动到期。"
url: "https://tslink.md/zh/docs/collect-event-photos"
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`.

**在电脑上运行 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](https://github.com/9001/copyparty) 适合这个场景，因为它的浏览器上传器按分块发送并支持续传（见[上传说明](https://github.com/9001/copyparty/blob/1af7efeca858dcfa29f797d7ae93f22eb2fdecf0/README.md#uploading)），场地 Wi-Fi 或蜂窝信号不稳时更从容。

我们测试过的 copyparty 配置和实测数据见[接收大文件](https://tslink.md/zh/docs/receive-files.md)。简单说，把它配置成：

* 只监听 `127.0.0.1`（copyparty 的 `-i`，默认监听所有网卡，见 [`--help` 源码](https://github.com/9001/copyparty/blob/1af7efeca858dcfa29f797d7ae93f22eb2fdecf0/copyparty/__main__.py#L1536)）；
* 访客对一个文件夹只有写入权限（copyparty 的 `w` 权限），宾客之间看不到也下载不了彼此的照片（见[账号与卷](https://github.com/9001/copyparty/blob/1af7efeca858dcfa29f797d7ae93f22eb2fdecf0/README.md#accounts-and-volumes)）；
* 用 `-nih` 和 `-nid` 隐藏主机名和磁盘用量（单横线，见 [`--help` 源码](https://github.com/9001/copyparty/blob/1af7efeca858dcfa29f797d7ae93f22eb2fdecf0/copyparty/__main__.py#L1842-L1843)）。

TSLink 默认把单个请求限制在 32 MiB，低于 copyparty 默认最大 96 MiB 的分块（见 [u2sz](https://github.com/9001/copyparty/blob/1af7efeca858dcfa29f797d7ae93f22eb2fdecf0/README.md#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 说明](https://github.com/9001/copyparty/blob/1af7efeca858dcfa29f797d7ae93f22eb2fdecf0/README.md#cors)）。上限怎么定，见[让别人往我的 Mac 传大文件](https://tslink.md/zh/docs/upload-big-files-to-mac.md)。

**印桌卡之前先定好上限。** 之后也能用 `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**（见[安装](https://tslink.md/zh/docs/installation.md)），**开启了 MagicDNS 和 HTTPS 的 Tailscale 账号，以及 Funnel 权限。** [Tailscale Funnel](https://tailscale.com/docs/features/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 分钟](https://tailscale.com/docs/features/tailscale-funnel)才出现在公网 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` 显示每个链接的使用次数；[访问历史](https://tslink.md/zh/docs/access-history.md)按链接 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 文件请求](https://help.dropbox.com/share/create-file-request)                                                                                    | 想要最简单的宾客体验，或者电脑撑不了一直在线。宾客不需要 Dropbox 账号。                                                                                                               | 照片进入 Dropbox 存储。Basic、Plus 和 Family 方案单个文件最大 2 GB；设截止时间要更高的方案。                |
| 单独用 copyparty                                                                                                                                         | 你接受 copyparty 自带的[分享链接](https://github.com/9001/copyparty/blob/1af7efeca858dcfa29f797d7ae93f22eb2fdecf0/README.md#shares)（可以设密码、到期时间并允许上传），并且已有发布它的办法。 | 要自己发布。TSLink 提供经 Funnel 的 `ts.net` 地址，不用在路由器上开端口，并在应用前面执行截止时间和撤销，进行中的上传也会被切断。 |
| [Tailscale Serve](https://tailscale.com/docs/reference/tailscale-cli/serve)                                                                           | 所有上传的人都已经在你的 tailnet 里。                                                                                                                                | 宾客得装 Tailscale，大多数活动用不了。                                                      |
| [Cloudflare Quick Tunnel](https://developers.cloudflare.com/cloudflare-one/networks/connectors/cloudflare-tunnel/do-more-with-tunnels/trycloudflare/) | 不想用 Tailscale 账号。                                                                                                                                      | 要么每位访客都在浏览器里用 `--allowed-mail` 验证邮箱，要么链接完全开放；只面向测试和开发；`cloudflared` 一停访问就结束。  |

## 交给编程 agent

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

```text
通过一个所有宾客共用的 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 里的任何东西。
```

## 相关页面

* [让别人往我的 Mac 传大文件](https://tslink.md/zh/docs/upload-big-files-to-mac.md)：请求上限，以及只有一个上传方时的做法。
* [访客链接](https://tslink.md/zh/docs/guest-links.md)：PIN 限制、会话与撤销的细节。
* [从 Mac 发一个 3 天后失效的下载链接](https://tslink.md/zh/docs/expiring-download-link.md)：把精选照片再发回去。
* [工具对比](https://tslink.md/zh/docs/comparisons.md)：TSLink 与其他发布应用的方式比较。

以上 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](https://github.com/anydoor7/tslink) 的独立项目，**并非由 Tailscale 制作或背书**。
