🚀 File-Rocket 4.0

2025-12-16 开源项目
  • 15
  • 0
  • 1
🚀 File-Rocket 4.0

新一代轻量级、高性能的异地大文件传输工具

前段时间我开源了我的File-Rocket项目,并且录制了AMD64平台的部署教程,反响还不错。于是这次我给这个项目添加了P2P直连的传输模式和服务器存储的传输模式(但是在体验网址未开放服务器存储模式,因为服务器的硬盘空间不足以多人上传文件,如果个人部署可以尝试使用这个功能)

源代码:File-Rocket-4.0.0.zip

体验链接:File-Rocket - 极速文件传输

备用链接:File-Rocket - 极速文件传输

开源链接:Lihu-PR/File-Rocket: 新一代轻量级高性能异地大文件传输工具

© 2025 File-Rocket • Designed for Speed

✨ 核心特性

🎯 三种传输模式,灵活选择

⚡ 内存流式传输

💾 服务器存储中转

🔗 P2P 直连传输

🔐 强大的管理员系统

🌐 全平台支持


📦 部署指南 (Docker)

💡 提示:不想自己部署?直接访问 在线体验地址备用地址(高速) 试用!(仅作演示 推荐个人部署)

我们强烈推荐直接使用 Docker 部署,这是最快、最稳定的方式。
Docker 安装及配置教程:哩虎的技术博客 - Docker 安装及配置

1️⃣ 快速启动(推荐)

根据您的设备类型选择命令:

🏠 ARM64 设备(OpenWrt / 树莓派 / 电视盒子)

docker run -d --name file-rocket --restart unless-stopped -p 3000:3000 --memory=128m --cpus=0.3 lihupr/file-rocket:arm64

视频教程制作中...

💻 AMD64 设备(Windows / Linux PC / 云服务器)

docker run -d --name file-rocket --restart unless-stopped -p 3000:3000 lihupr/file-rocket:latest

视频教程:AMD64 平台部署视频教程

访问地址:打开浏览器访问 http://设备IP:3000


2️⃣ 自行构建镜像(高级)

如果您需要修改源码或自行编译,请按以下步骤操作。

⚠️ 编译前必读:网络问题解决

由于国内网络环境,构建时可能会拉取基础镜像失败。请务必先手动拉取基础镜像到本地

对于 ARM64(构建给 OpenWrt/树莓派用):

docker pull --platform linux/arm64 node:18-alpine

对于 AMD64(构建给 PC/服务器用):

docker pull --platform linux/amd64 node:18-alpine

🛠️ 构建步骤

构建 ARM64 镜像:

# 1. 确保已拉取基础镜像(见上一步)
# 2. 执行构建命令
docker build --platform linux/arm64 --no-cache -t file-rocket:arm64 .

# 3. 导出为文件(方便传输到路由器)
docker save -o file-rocket-arm64.tar file-rocket:arm64

构建 AMD64 镜像:

# 1. 确保已拉取基础镜像
# 2. 执行构建命令
docker build --platform linux/amd64 --no-cache -t file-rocket:amd64 .

# 3. 导出为文件(可选)
docker save -o file-rocket-amd64.tar file-rocket:amd64

🔧 使用说明

📤 发送文件

  1. 打开首页,点击 "发送文件"

  2. 拖拽或选择文件

  3. 选择传输方式:

    • 内存流式:双方同时在线,速度快

    • 服务器存储:异步传输,接收方可随时下载

    • P2P 直连:点对点传输,速度最快

  4. 点击 "生成取件码",获得 4 位取件码

  5. 将取件码发给接收方,等待连接

📥 接收文件

  1. 打开首页,点击 "接收文件"

  2. 输入对方提供的 4 位取件码

  3. 确认文件信息无误后,点击 "接收文件" 开始下载

🔐 管理员配置

  1. 点击页面底部版权文字 4 次 触发登录

  2. 输入默认密码:7428(首次登录后请立即修改)

  3. 进入管理后台:

    • 功能开关:实时开启/关闭各传输模式

    • 文件管理:查看磁盘空间、存储文件列表、一键清理

    • 文件保留时间:1 小时/24 小时/下载后删除

    • 系统统计:活跃会话、今日传输、存储文件数量

    • 安全设置:修改管理员密码


❓ 常见问题(FAQ)

Q: 文件会保存在服务器上吗?
A: 这取决于您选择的传输模式:

Q: 传输速度有多快?
A: 取决于发送端和接收端两边的上传/下载带宽以及服务器的中继带宽。

Q: P2P 连接失败怎么办?
A: P2P 成功率由双方 NAT 类型共同决定,查看双端 NAT 类型和成功率:

实际连接成功率 = min(发送端成功率, 接收端成功率)
如果双方成功率都 ≥90%,则取平均值(上限 95%)
例如:NAT0(95%) + NAT1(90%) = 92.5% 综合成功率
例如:NAT1(90%) + NAT3(50%) = 50% 综合成功率

Q: 如何选择传输模式?
A: 根据文件大小和使用场景:

Q: OpenWrt 部署报错 "exec format error"?
A: 您可能部署了 AMD64 的镜像。请确保使用 lihupr/file-rocket:arm64 标签。

Q: 构建时报错 "failed to do request: EOF"?
A: 这是网络问题导致无法拉取基础镜像。请参考上文的 "编译前必读",先使用 docker pull 手动拉取镜像。

Q: 如何清理损坏的文件?
A: 进入管理员面板 → 文件管理 → 点击 "删除所有文件" 按钮。


🔒 安全建议

  1. ✅ 首次登录后立即修改默认密码

  2. ✅ 使用强密码(至少 12 位,包含字母数字符号)

  3. ✅ 生产环境必须使用 HTTPS

  4. ✅ 定期检查管理后台统计数据

  5. ✅ 定期清理存储文件

  6. ✅ 不要将 config.json 提交到版本控制

  7. ✅ 配置防火墙规则限制访问


🛠️ 技术栈