🚀 File-Rocket 4.0

2025-12-16 开源项目
  • 445
  • 0
  • 4
🚀 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 直连传输

UP.png

🔐 强大的管理员系统

dashboard.png

🌐 全平台支持

📦 部署指南 (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

视频教程：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. 确认文件信息无误后，点击 "接收文件" 开始下载

  4. 传输模式提示（仅P2P模式）：

    • 💻 桌面设备：显示"文件将边接收边保存到磁盘"

    • 📱 移动设备：显示"文件将先接收到内存，传输完成后统一下载"

🔐 管理员配置

  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: 手机浏览器P2P传输有什么特殊处理？
A: 系统会自动检测设备类型并选择最佳传输方式：

💡 测试设备检测：访问 /test-mobile-detection.html 查看您的设备类型和传输模式

Q: 如何测试我的设备会使用哪种传输模式？
A: 访问 http://你的服务器地址:3000/test-mobile-detection.html，该页面会显示：

Q: iPad会被识别为移动设备还是桌面设备？
A: 取决于屏幕尺寸：

Q: 移动设备P2P传输大文件会有问题吗？
A: 移动设备使用缓存模式，文件完全加载到内存中，可能遇到以下问题：

Q: 为什么移动设备不使用流式传输？
A: 移动浏览器对下载有严格限制：

Q: 手机上下载没有触发怎么办？
A:

  1. 检查浏览器是否阻止下载

  2. 检查文件大小是否过大（建议<500MB）

  3. 尝试使用"服务器存储"模式

部署相关

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

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

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

📊 P2P传输模式对比

🔒 安全建议

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

  2. ✅ 使用强密码（至少 12 位，包含字母数字符号）

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

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

  5. ✅ 定期清理存储文件

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

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

🛠️ 技术栈

🧪 快速测试（移动设备优化）

步骤1：测试设备检测

访问：http://localhost:3000/test-mobile-detection.html

这个页面会显示：

步骤2：测试P2P传输

发送端（任意设备）：

  1. 访问：http://localhost:3000/upload.html

  2. 选择文件，选择"P2P 直连传输"

  3. 生成取件码

接收端（手机浏览器）：

  1. 访问：http://你的IP:3000/receive.html

  2. 输入取件码

  3. 查看传输模式提示（应显示"📱 移动设备模式"）

  4. 点击"接收文件"

  5. 等待传输完成

  6. 确认下载

控制台日志参考

桌面设备（正常）：

✅ StreamSaver流式下载已初始化，文件将边收边存
📦 文件: example.zip, 大小: 150.00 MB
💻 桌面设备：下载已触发

移动设备（正常）：

📱 检测到移动设备，使用缓存模式（传输完成后统一下载）
📦 开始创建Blob，共 1234 个数据块，总大小: 150.00 MB
✅ Blob创建成功，大小: 150.00 MB
📱 移动设备：准备触发下载（需要用户确认）
📱 移动设备：下载已触发，资源已清理

🤝 贡献与反馈

欢迎提交 Issue 或 PR 改进项目。

📄 许可证

MIT License

Made with ❤️ by Lihu-PR

File-Rocket 4.0 - 让文件传输更简单、更快速、更安全

开源项目