psitrax/psitransfer Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

PsiTransfer

概述

PsiTransfer 是一款简单的开源自托管文件共享解决方案，作为 Dropbox、WeTransfer 等付费服务的替代方案，无需账户即可实现文件共享，支持多种功能特性如大文件传输、断点续传、过期时间设置等。

核心功能与特性

• 无需账户登录：无需注册账户即可使用
• 移动端友好：响应式界面，适配移动设备
• 大文件支持：支持多文件及超大文件传输（基于流传输）
• 断点续传：支持上传和下载断点续传（基于 tus.io 协议）
• 过期时间设置：可为上传文件包设置过期时间
• 一次性下载：支持设置文件包为一次性下载
• 批量下载：可将所有文件打包为 zip/tar.gz 归档下载
• 文件预览：模态框式文件预览功能
• 密码保护：下载列表支持 AES 加密密码保护
• 管理员页面：提供 /admin 页面查看文件包信息（需设置 adminPass 启用）
• 轻量前端：基于 Vue 构建的前端应用，Gzip 压缩后小于 100k
• 自定义文件包 ID：通过查询参数 sid=<myBucketID> 指定文件包 ID

使用场景

• 个人临时文件共享（无需注册账户，快速上传）
• 团队内部文件传输（支持大文件和批量下载）
• 需要设置过期时间的敏感文件分享（避免长期留存）
• 临时共享给外部人员的文件（支持一次性下载和密码保护）

使用方法

Docker 部署

基本运行命令

bash
$ docker run -p 0.0.0.0:3000:3000 -e PSITRANSFER_ADMIN_PASS=secret -v $PWD/data:/data psitrax/psitransfer
# 数据卷需要 UID 1000 权限
$ sudo chown -R 1000 $PWD/data

镜像标签说明

可通过镜像标签指定版本：

• latest：对应 master 分支
• 2：最新稳定版 2.x.x
• 1.1：最新稳定版 1.1.x
• 1.0.0：精确版本号

配置说明

环境变量配置

支持通过环境变量自定义配置，常用变量如下：

• PSITRANSFER_ADMIN_PASS：设置管理员密码，启用 /admin 页面
• PSITRANSFER_UPLOAD_PASS：设置上传密码，保护非授权上传
• PSITRANSFER_UPLOAD_DIR：指定上传文件存储目录（默认 /data）
• PSITRANSFER_PORT：指定服务端口（默认 3000）

配置文件

• 不建议直接修改 config.js
• 可创建 config.production.js（NODE_ENV=production 时生效）覆盖配置
• 参考 config.dev.js 了解配置项

自定义界面

可修改 public/pug/upload.pug 和 download.pug 文件添加自定义 logo 和样式，建议保留“由 PsiTransfer 提供支持”等声明。

调试

使用 debug 模块进行调试，命令如下：

bash
DEBUG=psitransfer:* npm start

注意事项

• 目前暂不支持（端到端） payload 加密
• “下载全部为 ZIP”功能不支持断点续传
• 需 Node.js >=7.4 环境，或使用 --harmony-async-await 标志

许可证

BSD 许可证