先说主线:同是临时分享,它比 Pingvin Share 还要极端
上一篇写的 Pingvin Share 已经是临时分享里很轻量的选手了:链接分享、过期时间、密码、访客次数限制一应俱全。但它仍然保留了一套「正经服务」的骨架——要注册账号,要登录后台,要以用户为单位管理每一个分享。
PsiTransfer 的取舍更极端:它干脆把账号体系整个删掉了。没有注册,没有登录,没有用户管理。打开网页,把文件拖进去,设一个过期时间,拿到链接发给对方,就这么多。对方下载完,或者到了过期时间,这批文件就自动消失。它对自己的定位非常清楚:不是网盘,不是文件库,就是一个「传完即走」的中转站,是 WeTransfer、Dropbox 这类商业临时分享服务的开源自托管替代。
这种极简带来两个直接结果。一是部署和维护成本几乎为零:单个 Docker 容器,没有数据库,没有外部依赖,前端用 Vue 写、gzip 之后不到 100 KB,页面打开飞快。二是安全模型完全不同:既然没有账号,防护就不能靠「谁登录了」,只能靠上传口令、内网隔离这类外围手段——这一点后面会用整整一节讲,因为它正是 PsiTransfer 用得好不好的分水岭。
核心概念:一切围绕「桶」
PsiTransfer 里没有目录树的概念,取而代之的是「桶」(bucket):一次上传的所有文件装进一个桶,每个桶有自己的链接、过期时间和下载规则。日常使用只要理解四个设定:
- 过期时间:上传时给桶设一个有效期,到期后文件自动删除,不需要人工清理。
- 一次性下载:可以把桶设为「下载一次即焚」,适合传敏感文件,对方取走就没了。
- 下载密码:桶的下载列表可以设密码保护,密码以 AES 加密保存;链接和密码分开发送更稳妥。
- 自定义桶名:链接里默认是随机 ID,但可以在上传时用
sid=<名字>参数指定桶名,生成一个好记、能口头念出来的链接,发给同事时直接报名字就行。
其他日常够用的能力:支持同时传多个文件,单个文件可以非常大(流式传输,不把整个文件读进内存);上传和下载都基于 tus.io 协议支持断点续传,网络断了接着传,不用从头再来;下载时可以把整个桶打包成 zip 或 tar.gz 一次拿走;常见格式有弹窗式文件预览。管理方面有一个 /admin 页面,能看到所有桶的信息,但它默认是关闭的,必须先设置管理员密码才启用。
部署一:一条 docker run 命令
最快的上手方式,官方镜像是 psitrax/psitransfer:
docker run -d --name psitransfer \ -p 3000:3000 \ -e PSITRANSFER_ADMIN_PASS=改成你的管理员密码 \ -v $PWD/data:/data \ psitrax/psitransfer跑完打开 http://服务器地址:3000 就是上传页面。镜像标签按需选:latest 跟着主干分支,2 是最新的 2.x 稳定版,1.1 这类是指定小版本线;长期使用建议锁一个稳定大版本,别无脑追 latest。
这里有一个必须当场处理、否则必踩的坑:数据卷的属主。容器内进程以 UID 1000 运行,挂进去的 data 目录如果不归这个 UID 所有,上传就会失败,或者数据根本写不进去。启动容器前先执行:
mkdir -p datasudo chown -R 1000 data部署二:docker compose(长期运行推荐)
打算长期挂着用的话,用 compose 管理更顺手,顺带把关键环境变量一次写齐:
services: psitransfer: image: psitrax/psitransfer:2 container_name: psitransfer restart: unless-stopped ports: - "3000:3000" environment: - PSITRANSFER_ADMIN_PASS=改成你的管理员密码 - PSITRANSFER_UPLOAD_PASS=改成上传口令 volumes: - ./data:/datasudo chown -R 1000 ./datadocker compose up -d两个密码的区别一定要分清:PSITRANSFER_ADMIN_PASS 是 /admin 管理页的密码,决定管理功能开不开;PSITRANSFER_UPLOAD_PASS 是上传口令,决定「谁能往这个站里传文件」,这是公网部署时最关键的一个开关,下一节细说。
配置方式:环境变量优先
PsiTransfer 的配置有三层:环境变量、按环境分的配置文件、默认的 config.js。
- 环境变量:统一用
PSITRANSFER_前缀,比如PSITRANSFER_UPLOAD_DIR改上传数据目录。容器部署时这是最方便的方式,改完重启容器即生效。 - 配置文件:默认配置在
config.js,端口、数据目录等都在里面,官方不建议直接改它;推荐新建config.production.js这样的文件,文件名后缀对应NODE_ENV的值,只写要覆盖的项。
常用环境变量速查:
| 环境变量 | 作用 | 建议 |
|---|---|---|
PSITRANSFER_ADMIN_PASS | 启用 /admin 管理页并设置其密码 | 必设,否则没有管理入口 |
PSITRANSFER_UPLOAD_PASS | 上传口令,不知道口令的人不能上传 | 公网部署必设 |
PSITRANSFER_UPLOAD_DIR | 上传文件的存放目录 | 默认配合 /data 挂卷即可,一般不用改 |
日常使用:一次完整的传递流程
实际用起来只有四步:
- 上传:打开首页,把文件拖进页面(也可以点选),可以一次拖多个。上传过程中页面会显示进度;中途断网也不用慌,tus 断点续传会在网络恢复后接着传,而不是从零开始。
- 设定规则:给这个桶定一个期限,比如一天、一周;需要的话勾上一次性下载,再给下载列表加个密码。这一步决定了这批文件的「寿命」和「门槛」。
- 发链接:把桶的链接发给对方。想让链接好记一点,上传时带上
sid=<名字>指定桶名,生成的链接里就是这个名字,不用对着一串随机字符反复核对。 - 收尾:什么都不用做。到期自动删除,一次性下载被取走后自动销毁;想提前清掉,去
/admin里手动删桶即可。
有一个容易忽略的细节:PsiTransfer 的桶是「一批文件一个链接」,不是「一个文件一个链接」。给同一个人发十个文件,装进同一个桶、发一条链接就行,对方还能在下载页把整个桶打包成 zip 或 tar.gz 一次拿走,比逐个文件发链接清爽得多。
另外补一句数据层面的事:PsiTransfer 没有数据库,桶的信息和文件都落在数据目录里,所以备份和迁移都很原始、也很可靠——停掉容器,把 data 目录整个打包带走,恢复时放回去、确认属主仍是 UID 1000 即可。反过来说,这个目录丢了就是全丢,长期运行的话,建议把它纳入你现有的服务器备份节奏里。
安全:没有账号,意味着防线只有两道
WARNINGPsiTransfer 没有任何账号体系,默认状态下,谁拿到网址谁就能上传文件。把默认部署直接暴露在公网,等于开了一个全世界可写的公开上传站:轻则硬盘被塞满,重则被人拿来分发违规文件,锅全在站长头上。公网使用必须二选一:设置
PSITRANSFER_UPLOAD_PASS给上传加口令,或者只放在内网、仅通过内网穿透或 VPN 访问,绝不要裸奔。另外官方明确说明:PsiTransfer 没有端到端加密,文件在服务器上是明文存放的,下载密码保护的只是列表的访问。它适合传「不怕被服务器管理员看到、但要控制谁能下载」的文件;真正的机密文件请先在本地加密再上传,或者改用有完整账号与权限体系的方案。
除此之外,常规加固同样适用:前面套一层带 HTTPS 的反向代理;定期去 /admin 看有没有陌生桶;对数据目录所在磁盘的容量心里有数——临时分享站最常见的事故不是被黑,而是被当成免费图床、免费网盘刷爆磁盘。
反向代理:大文件上传的三个注意点
PsiTransfer 自己只监听 3000 端口的 HTTP,对外服务一般在前面加 Nginx 或 Caddy 做 HTTPS 和域名入口。因为它主打大文件和断点续传,反代配置有三个地方和普通站点不同:
- 放开请求体大小:Nginx 默认的
client_max_body_size只有 1 MB,不改的话大文件上传会直接被拦下。按实际需求调大,比如写client_max_body_size 0;表示不限制,或者给一个明确上限如10g。 - 关掉请求缓冲:tus 断点续传是分片流式上传的,反代如果把整个请求缓冲完再转发,续传和上传进度都会出问题。Nginx 里给对应的 location 加上
proxy_request_buffering off;,让分片直接透传。 - 拉长超时:慢速网络传几个 GB 的文件可能要几十分钟,
proxy_read_timeout和proxy_send_timeout都要给足,比如 3600s,避免传到一半被代理掐断。
Nginx 示例(关键行):
location / { proxy_pass http://127.0.0.1:3000; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; client_max_body_size 0; proxy_request_buffering off; proxy_read_timeout 3600s; proxy_send_timeout 3600s;}和 Pingvin Share 怎么选
两者都是临时分享,气质却完全不同,放一张表说清:
| 对比项 | PsiTransfer | Pingvin Share |
|---|---|---|
| 账号体系 | 完全没有,打开即用 | 有用户注册与登录 |
| 分享管理 | 以「桶」为单位,过期自动删 | 以分享为单位,功能更细 |
| 过期与次数 | 过期时间、一次性下载 | 过期时间、访客次数上限、密码 |
| 邮件通知收件人 | 无 | 有 |
| 反向分享(让别人传给你) | 无(它本身就是上传页) | 有 Reverse Share |
| 第三方登录 | 无 | 支持 OIDC、LDAP |
| 病毒扫描 | 无 | 可集成 ClamAV |
| 存储后端 | 本地目录 | 本地或 S3 |
| 上手成本 | 一条命令,页面极简 | 功能多,配置项也多 |
| 适合场景 | 自己人之间快速传大文件 | 对外发文件、需要管理和审计 |
简单说:给同事、朋友传个几 GB 的素材包,越快越好、传完拉倒,PsiTransfer 是最优解;要长期对外提供下载、需要知道谁下载过、想要品牌化页面和登录体系,选 Pingvin Share。
排障
上传失败、文件存不进去、容器日志报权限错误
十有八九是数据卷属主不对。容器内进程是 UID 1000,在宿主机上执行 sudo chown -R 1000 ./data 后重启容器即可。这也是从 docker run 换到 compose、或者迁移服务器之后最容易复发的问题:迁移数据目录时,记得连属主一起处理。
/admin 打开是空白或者报错
管理页默认禁用,没设 PSITRANSFER_ADMIN_PASS 时它就是不存在的。给容器加上这个环境变量并重启,再访问 /admin,用该密码登录,就能看到所有桶的信息。
任何人都能往我的站里传文件
这是默认行为,不是 Bug。立刻设置 PSITRANSFER_UPLOAD_PASS 并重启容器;如果已经被刷了,先去 /admin 清掉陌生桶,再检查数据目录的占用情况。
大文件传到一半失败,但直连 3000 端口正常
基本是反向代理的问题,按上一节逐项核对:client_max_body_size 是否放开、proxy_request_buffering 是否关闭、读写超时是否足够。tus 续传能救回大部分网络中断,但代理直接拒绝请求时它也无能为力。
下载链接提示已失效
先确认是不是自己设的过期时间到了,或者这个桶被设成了一次性下载、且已经被下载过一次。这两种都是按设计销毁,不是故障;桶的具体状态在 /admin 里能看到。
改了环境变量却不生效
环境变量是容器启动那一刻读进去的,只修改 compose 文件、或者只在宿主机上 export,都不会自动生效。改完配置后执行一次 docker compose up -d,compose 会在配置变化时重建容器;如果是用 docker run 起的,就删掉旧容器按新参数重新 run。改完别凭感觉判断,去上传页实际传一个文件、再进 /admin 看一眼,确认新配置真的在工作。
想改端口或数据目录,改完重启又没了
不要直接改容器里的 config.js,容器重建就恢复原样。用 PSITRANSFER_ 前缀的环境变量覆盖,或者把 config.production.js 挂载进容器,保证配置在重建之后还在。
小结
PsiTransfer 是那种「小而明确」的工具:它把临时分享这件事做到了减法的极致——没有账号、没有数据库、没有花哨功能,只剩下上传、过期、密码、一次性下载这几个真正高频的动作,再加上 tus 断点续传为大文件兜底。如果你的需求就是「给自己人快速传大文件,传完自动清」,它比任何带账号体系的方案都省心。
在整个网盘系列里,它的位置也很清楚:长期存放、要目录树要权限,用 Cloudreve 这类正经网盘;完全不想维护服务器,用 Davflare 把文件放在 Cloudflare R2 上;而 PsiTransfer 只负责一种场景——临时中转。用对地方,它就是那个装上之后你会忘记它存在的工具,这恰恰是对基础设施工具最好的评价。