# file-rocket

**Repository Path**: qyk7310/file-rocket

## Basic Information

- **Project Name**: file-rocket
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-27
- **Last Updated**: 2026-02-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">

# 🚀 File-Rocket 4.0

![File-Rocket Logo](https://img.shields.io/badge/File--Rocket-4.0-blueviolet?style=for-the-badge&logo=rocket)
[![Docker Image](https://img.shields.io/docker/v/lihupr/file-rocket?label=Docker%20Hub&style=for-the-badge&color=blue&logo=docker)](https://hub.docker.com/r/lihupr/file-rocket)
[![GitHub](https://img.shields.io/badge/GitHub-Lihu--PR-black?style=for-the-badge&logo=github)](https://github.com/Lihu-PR)
[![Mobile Optimized](https://img.shields.io/badge/Mobile-Optimized-success?style=for-the-badge&logo=android)](https://github.com/Lihu-PR)

**新一代轻量级、高性能的异地大文件传输工具**  
专为 ARM64 嵌入式设备（如 OpenWrt 软路由、树莓派）优化，同时也完美支持 PC 和服务器。

### 🌐 在线体验
**[https://file-rocket.top/](https://file-rocket.top/)** - 立即体验，无需安装（仅作演示 推荐个人部署）  
**[https://file-rocket.tech/](https://file-rocket.tech/)** - 备用地址，速度更快（仅作演示 推荐个人部署）

<img width="2560" height="1351" alt="FR4 0" src="https://github.com/user-attachments/assets/00fb127d-73a7-43b1-a891-0443c5b8fb68" />


*© 2025 File-Rocket 4.0 • Designed for Speed*

</div>

---

## ✨ 核心特性

### 🎯 三种传输模式，灵活选择

#### ⚡ 内存流式传输
- 端到端直连，服务器仅做中继，**不存储任何文件**
- 双方需同时在线，速度快，仅受带宽限制
- 支持超大文件，内存占用极低

#### 💾 服务器存储中转
- 文件暂存服务器（1小时/24小时/下载后删除/永久保存 可选）
- 支持异步下载，接收方可随时下载
- 完整的管理员文件管理功能
- **动态空间限制**：自动限制上传文件大小为服务器可用空间的 90%

#### 🔗 P2P 直连传输
- 点对点 WebRTC 连接，无需服务器中转数据
- 自动 NAT 类型检测（NAT0/1/2/3/4）
- 显示连接成功率预测和等待时间，速度最快
- **智能传输模式**：
  - 💻 **桌面设备**：StreamSaver流式传输，边收边存，支持超大文件（>10GB）
  - 📱 **移动设备**：浏览器缓存模式，传输完成后统一下载（推荐<500MB）

<img width="2560" height="1351" alt="UP" src="https://github.com/user-attachments/assets/5c6a5fbc-1ddb-452e-9768-3839af337a69" />


### 🔐 强大的管理员系统

- **隐藏式入口**：首页版权文字点击 4 次触发
- **密码保护**：默认密码 `7428`（首次登录后请修改）
- **功能配置**：动态开启/关闭传输模式
- **文件管理**：查看存储文件、磁盘空间、一键清理
- **删除策略**：1小时/24小时/下载后删除/永久保存
- **系统统计**：活跃会话、今日传输、文件数量
- **安全设置**：修改管理员密码、Token 会话管理

<img width="737" height="1316" alt="dashboard" src="https://github.com/user-attachments/assets/29cd3ef2-4e85-429e-8e50-a696ccb56fbe" />


### 🌐 全平台支持

- 📱 **响应式设计**：Glassmorphism UI，完美适配手机、平板和电脑
- 🔄 **智能断连检测**：精准监测传输状态，异常断开秒级响应
- 🌍 **跨架构支持**：ARM64 (OpenWrt/树莓派) 和 AMD64 (PC/服务器)
- 🎯 **极低占用**：内存占用极低，适合路由器等低功耗设备全天候运行
- 🛡️ **安全可靠**：SHA-256 文件完整性校验、速率限制、自动清理
- 📱 **移动优化**：智能识别移动设备，自动选择最佳传输方式
- 🌏 **中文支持**：完美支持中文文件名，无乱码问题
- ⚡ **高性能**：优化后带宽利用率达 95%+，跑满服务器带宽

---

## 📦 部署指南 (Docker)

> 💡 **提示**：不想自己部署？直接访问 [在线体验地址](https://file-rocket.top/) 或 [备用地址（高速）](https://file-rocket.tech/) 试用！（仅作演示 推荐个人部署）

我们强烈推荐直接使用 Docker 部署，这是最快、最稳定的方式。  
Docker 安装及配置教程：[哩虎的技术博客 - Docker 安装及配置](https://lihu.site/archives/docker-install)

### 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 平台部署视频教程](https://b23.tv/mgSF3vi)

#### 💻 AMD64 设备（Windows / Linux PC / 云服务器）
```
docker run -d --name file-rocket --restart unless-stopped -p 3000:3000 lihupr/file-rocket:latest
```
视频教程：[AMD64 平台部署视频教程](https://b23.tv/nlUlzcT)

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

---

### 2️⃣ 自行构建镜像（高级）

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

#### ⚠️ 编译前必读：网络问题解决
由于国内网络环境，构建时可能会拉取基础镜像失败。**请务必先手动拉取基础镜像到本地**：

**对于 ARM64（构建给 OpenWrt/树莓派用）：**
```bash
docker pull --platform linux/arm64 node:18-alpine
```

**对于 AMD64（构建给 PC/服务器用）：**
```bash
docker pull --platform linux/amd64 node:18-alpine
```

#### 🛠️ 构建步骤

**构建 ARM64 镜像：**
```bash
# 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 镜像：**
```bash
# 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: 这取决于您选择的传输模式：
- **内存流式传输**：不保存，数据直接流向接收端
- **服务器存储**：暂存1-24小时后自动删除（或选择永久保存）
- **P2P 直连**：不保存，点对点传输

**Q: 传输速度有多快？**  
A: 取决于发送端和接收端两边的**上传/下载带宽**以及服务器的中继带宽。
- **内存流式**：95%+ 带宽利用率
- **服务器存储**：99%+ 带宽利用率
- **P2P 直连**：理论上最快，无服务器瓶颈

**Q: P2P 连接失败怎么办？**  
A: P2P 成功率由**双方 NAT 类型共同决定**，查看双端 NAT 类型和成功率：
- **NAT0**（公网 IP）：单端成功率 95%，最佳选择
- **NAT1**（全锥型 NAT）：单端成功率 90%，建议使用
- **NAT2**（限制型 NAT）：单端成功率 75%，可以尝试
- **NAT3**（端口限制型 NAT）：单端成功率 50%，谨慎尝试
- **NAT4**（对称型 NAT）：单端成功率 20%，建议使用其他模式

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

**Q: 如何选择传输模式？**  
A: 根据文件大小和使用场景：
- **小文件（<100MB）**：服务器存储（上传快，随时下载）
- **中等文件（100MB-1GB）**：内存流式或 P2P
- **大文件（>1GB）**：P2P（如果网络好）或服务器存储

**Q: 上传大文件时提示 413 错误怎么办？**  
A: 系统会自动限制上传文件大小为服务器可用空间的 90%。如果仍然出现 413 错误，可能是：
1. Nginx 配置的 `client_max_body_size` 限制（参考下方 Nginx 配置）
2. 磁盘空间不足
3. 网络超时（大文件上传时间较长）

**Q: 中文文件名显示乱码怎么办？**  
A: 本版本已修复中文文件名乱码问题。如果仍然出现乱码：
1. 确保服务器已重启
2. 清除浏览器缓存（Ctrl+Shift+Delete）
3. 检查 Nginx 配置中是否设置了 `charset utf-8;`

### 📱 移动设备相关

**Q: 手机浏览器P2P传输有什么特殊处理？**  
A: 系统会自动检测设备类型并选择最佳传输方式：
- **桌面设备（PC/Mac）**：使用StreamSaver流式传输，边接收边保存到磁盘，内存占用极低（~10MB），支持超大文件
- **移动设备（手机/小平板）**：使用浏览器缓存模式，文件先接收到内存，传输完成后统一下载
- **建议**：移动设备传输文件建议 < 500MB，大文件请使用"服务器存储"模式

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

**Q: 如何测试我的设备会使用哪种传输模式？**  
A: 访问 `http://你的服务器地址:3000/test-mobile-detection.html`，该页面会显示：
- 当前设备类型（移动/桌面）
- 详细的检测信息（User Agent、屏幕尺寸、触摸支持等）
- P2P传输将使用的模式（流式/缓存）

**Q: iPad会被识别为移动设备还是桌面设备？**  
A: 取决于屏幕尺寸：
- iPad / iPad Mini（屏幕宽度 ≤ 768px）：识别为移动设备，使用缓存模式
- iPad Pro（屏幕宽度 > 768px）：识别为桌面设备，使用流式模式
- 可以通过测试页面确认具体检测结果

**Q: 移动设备P2P传输大文件会有问题吗？**  
A: 移动设备使用缓存模式，文件完全加载到内存中，可能遇到以下问题：
- 文件 > 500MB：可能导致浏览器内存溢出或崩溃
- 文件 > 1GB：强烈不推荐，建议使用"服务器存储"模式
- 推荐大小：< 200MB（最佳）、< 500MB（可接受）

**Q: 为什么移动设备不使用流式传输？**  
A: 移动浏览器对下载有严格限制：
- 下载必须由用户交互触发
- StreamSaver的Service Worker在某些移动浏览器上支持不佳
- 流式下载可能需要用户多次确认
- 缓存模式可以确保一次确认即可完成下载，用户体验更好

**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: 进入管理员面板 → 文件管理 → 点击 **"删除所有文件"** 按钮。

**Q: 如何配置 Nginx 以支持大文件上传？**  
A: 在 Nginx 配置中添加以下内容（参考项目中的 `nginx.conf.example`）：
```nginx
server {
    # 增加客户端请求体大小限制
    client_max_body_size 10G;
    client_body_buffer_size 128M;
    
    # 增加超时时间
    client_body_timeout 600s;
    proxy_read_timeout 600s;
    proxy_send_timeout 600s;
    
    # TCP 优化
    tcp_nodelay on;
    tcp_nopush on;
    
    # 禁用请求缓冲（流式传输）
    proxy_request_buffering off;
    
    location / {
        proxy_pass http://localhost:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        
        # WebSocket 支持
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}
```

---

## 🚀 最新优化（v4.0）

### ✅ 性能优化
- **带宽利用率提升**：从 60-70% 提升到 95%+
- **上传速度提升**：优化后提升约 60%（200Mbps 带宽下从 ~15MB/s 提升到 ~24MB/s）
- **下载速度提升**：优化后提升约 33%（200Mbps 带宽下从 ~18MB/s 提升到 ~24MB/s）
- **TCP 优化**：启用 NoDelay 和 KeepAlive，减少网络延迟
- **缓冲区优化**：文件读取缓冲区从 512KB 增加到 8MB
- **进度更新优化**：减少 DOM 操作频率，降低 CPU 使用率

### ✅ 功能增强
- **中文文件名支持**：完美支持中文、日文、韩文等多语言文件名
- **动态空间限制**：自动限制上传文件大小为服务器可用空间的 90%
- **永久保存选项**：管理员可选择永久保存文件，不自动删除
- **实时进度显示**：服务器存储模式下载时正确显示进度和速度
- **智能设备检测**：自动识别移动设备，选择最佳传输方式

### 📊 性能对比

| 指标 | 优化前 | 优化后 | 提升 |
|------|--------|--------|------|
| 上传速度 (200Mbps) | ~15 MB/s | ~24 MB/s | +60% |
| 下载速度 (200Mbps) | ~18 MB/s | ~24 MB/s | +33% |
| 带宽利用率 | ~60-70% | ~95%+ | +40% |
| 进度显示 | 不显示/为零 | 实时显示 | ✅ |
| 中文文件名 | 乱码 | 正确显示 | ✅ |

---

## 📊 P2P传输模式对比

| 特性 | 桌面设备（流式） | 移动设备（缓存） |
|------|-----------------|-----------------|
| **内存占用** | 极低（~10MB） | 高（=文件大小） |
| **大文件支持** | 优秀（>10GB） | 一般（<500MB） |
| **下载触发** | 自动边收边存 | 传输完成后手动确认 |
| **用户体验** | 无感知下载 | 需要确认下载 |
| **浏览器要求** | Chrome/Edge 85+ | 所有浏览器 |
| **HTTPS要求** | 是（本地开发可用HTTP） | 否 |

---

## 🔒 安全建议

1. ✅ 首次登录后立即修改默认密码
2. ✅ 使用强密码（至少 12 位，包含字母数字符号）
3. ✅ 生产环境必须使用 HTTPS
4. ✅ 定期检查管理后台统计数据
5. ✅ 定期清理存储文件
6. ✅ 不要将 `config.json` 提交到版本控制
7. ✅ 配置防火墙规则限制访问

---

## 🛠️ 技术栈

- **后端**：Node.js + Express + Socket.IO
- **前端**：原生 JavaScript + WebRTC + StreamSaver.js
- **传输**：HTTP Stream + WebSocket + DataChannel
- **存储**：文件系统
- **认证**：Token-based
- **设计**：Glassmorphism UI
- **设备检测**：多重策略（User Agent + 触摸屏 + 屏幕尺寸 + 新API）

---

## 🤝 贡献与反馈

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

- **GitHub**：[Lihu-PR](https://github.com/Lihu-PR)
- **Docker Hub**：[lihupr](https://hub.docker.com/u/lihupr)
- **哩虎的技术博客**：[lihu.site](https://lihu.site/)

---

## 📄 许可证

MIT License

---

<div align="center">

Made with ❤️ by Lihu-PR

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

</div>