3432 字
17 分钟
PsiTransfer:连账号都不要的极简文件分享站
2026-11-16

先说主线:同是临时分享,它比 Pingvin Share 还要极端#

上一篇写的 Pingvin Share 已经是临时分享里很轻量的选手了:链接分享、过期时间、密码、访客次数限制一应俱全。但它仍然保留了一套「正经服务」的骨架——要注册账号,要登录后台,要以用户为单位管理每一个分享。

PsiTransfer 的取舍更极端:它干脆把账号体系整个删掉了。没有注册,没有登录,没有用户管理。打开网页,把文件拖进去,设一个过期时间,拿到链接发给对方,就这么多。对方下载完,或者到了过期时间,这批文件就自动消失。它对自己的定位非常清楚:不是网盘,不是文件库,就是一个「传完即走」的中转站,是 WeTransfer、Dropbox 这类商业临时分享服务的开源自托管替代。

这种极简带来两个直接结果。一是部署和维护成本几乎为零:单个 Docker 容器,没有数据库,没有外部依赖,前端用 Vue 写、gzip 之后不到 100 KB,页面打开飞快。二是安全模型完全不同:既然没有账号,防护就不能靠「谁登录了」,只能靠上传口令、内网隔离这类外围手段——这一点后面会用整整一节讲,因为它正是 PsiTransfer 用得好不好的分水岭。

项目地址:https://github.com/psi-4ward/psitransfer

核心概念:一切围绕「桶」#

PsiTransfer 里没有目录树的概念,取而代之的是「桶」(bucket):一次上传的所有文件装进一个桶,每个桶有自己的链接、过期时间和下载规则。日常使用只要理解四个设定:

  • 过期时间:上传时给桶设一个有效期,到期后文件自动删除,不需要人工清理。
  • 一次性下载:可以把桶设为「下载一次即焚」,适合传敏感文件,对方取走就没了。
  • 下载密码:桶的下载列表可以设密码保护,密码以 AES 加密保存;链接和密码分开发送更稳妥。
  • 自定义桶名:链接里默认是随机 ID,但可以在上传时用 sid=<名字> 参数指定桶名,生成一个好记、能口头念出来的链接,发给同事时直接报名字就行。

其他日常够用的能力:支持同时传多个文件,单个文件可以非常大(流式传输,不把整个文件读进内存);上传和下载都基于 tus.io 协议支持断点续传,网络断了接着传,不用从头再来;下载时可以把整个桶打包成 zip 或 tar.gz 一次拿走;常见格式有弹窗式文件预览。管理方面有一个 /admin 页面,能看到所有桶的信息,但它默认是关闭的,必须先设置管理员密码才启用。

部署一:一条 docker run 命令#

最快的上手方式,官方镜像是 psitrax/psitransfer:

Terminal window
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 所有,上传就会失败,或者数据根本写不进去。启动容器前先执行:

Terminal window
mkdir -p data
sudo 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:/data
Terminal window
sudo chown -R 1000 ./data
docker 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 挂卷即可,一般不用改

日常使用:一次完整的传递流程#

实际用起来只有四步:

  1. 上传:打开首页,把文件拖进页面(也可以点选),可以一次拖多个。上传过程中页面会显示进度;中途断网也不用慌,tus 断点续传会在网络恢复后接着传,而不是从零开始。
  2. 设定规则:给这个桶定一个期限,比如一天、一周;需要的话勾上一次性下载,再给下载列表加个密码。这一步决定了这批文件的「寿命」和「门槛」。
  3. 发链接:把桶的链接发给对方。想让链接好记一点,上传时带上 sid=<名字> 指定桶名,生成的链接里就是这个名字,不用对着一串随机字符反复核对。
  4. 收尾:什么都不用做。到期自动删除,一次性下载被取走后自动销毁;想提前清掉,去 /admin 里手动删桶即可。

有一个容易忽略的细节:PsiTransfer 的桶是「一批文件一个链接」,不是「一个文件一个链接」。给同一个人发十个文件,装进同一个桶、发一条链接就行,对方还能在下载页把整个桶打包成 zip 或 tar.gz 一次拿走,比逐个文件发链接清爽得多。

另外补一句数据层面的事:PsiTransfer 没有数据库,桶的信息和文件都落在数据目录里,所以备份和迁移都很原始、也很可靠——停掉容器,把 data 目录整个打包带走,恢复时放回去、确认属主仍是 UID 1000 即可。反过来说,这个目录丢了就是全丢,长期运行的话,建议把它纳入你现有的服务器备份节奏里。

安全:没有账号,意味着防线只有两道#

WARNING

PsiTransfer 没有任何账号体系,默认状态下,谁拿到网址谁就能上传文件。把默认部署直接暴露在公网,等于开了一个全世界可写的公开上传站:轻则硬盘被塞满,重则被人拿来分发违规文件,锅全在站长头上。公网使用必须二选一:设置 PSITRANSFER_UPLOAD_PASS 给上传加口令,或者只放在内网、仅通过内网穿透或 VPN 访问,绝不要裸奔。另外官方明确说明:PsiTransfer 没有端到端加密,文件在服务器上是明文存放的,下载密码保护的只是列表的访问。它适合传「不怕被服务器管理员看到、但要控制谁能下载」的文件;真正的机密文件请先在本地加密再上传,或者改用有完整账号与权限体系的方案。

除此之外,常规加固同样适用:前面套一层带 HTTPS 的反向代理;定期去 /admin 看有没有陌生桶;对数据目录所在磁盘的容量心里有数——临时分享站最常见的事故不是被黑,而是被当成免费图床、免费网盘刷爆磁盘。

反向代理:大文件上传的三个注意点#

PsiTransfer 自己只监听 3000 端口的 HTTP,对外服务一般在前面加 Nginx 或 Caddy 做 HTTPS 和域名入口。因为它主打大文件和断点续传,反代配置有三个地方和普通站点不同:

  1. 放开请求体大小:Nginx 默认的 client_max_body_size 只有 1 MB,不改的话大文件上传会直接被拦下。按实际需求调大,比如写 client_max_body_size 0; 表示不限制,或者给一个明确上限如 10g。
  2. 关掉请求缓冲:tus 断点续传是分片流式上传的,反代如果把整个请求缓冲完再转发,续传和上传进度都会出问题。Nginx 里给对应的 location 加上 proxy_request_buffering off;,让分片直接透传。
  3. 拉长超时:慢速网络传几个 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 怎么选#

两者都是临时分享,气质却完全不同,放一张表说清:

对比项PsiTransferPingvin 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 只负责一种场景——临时中转。用对地方,它就是那个装上之后你会忘记它存在的工具,这恰恰是对基础设施工具最好的评价。

PsiTransfer:连账号都不要的极简文件分享站
https://www.anexns.cloudns.org/posts/clouddrive-psitransfer/
作者
Anexns
发布于
2026-11-16
许可协议
CC BY-NC-SA 4.0