传传传 - 跨平台文件传输工具

简单、快速、安全的点对点文件传输解决方案

✨ 核心功能

• 📁 文件传输 - 支持多文件同时传输，基于WebRTC的P2P技术
• 📝 文字传输 - 快速分享文本内容，支持大文本传输
• 🖥️ 桌面共享 - 实时屏幕共享功能（开发中）
• 🔗 URL路由 - 支持直链分享特定功能和模式

🛡️ 安全特性

• 端到端加密 - WebRTC内置加密，数据传输安全
• 无文件存储 - 服务器不存储任何文件内容
• 临时连接 - 传输完成后自动清理连接
• 房间隔离 - 每个取件码对应独立的传输房间

🚀 技术栈

前端架构

• Next.js 15 + React 18 + TypeScript
• Tailwind CSS + 毛玻璃效果UI
• WebRTC DataChannel + WebSocket

后端架构

• Go + Gin框架 + WebSocket
• 内存存储 + 房间管理
• Docker容器化部署

📦 快速开始

方式一：Docker一键部署（推荐[未变写完成]）

git clone https://github.com/MatrixSeven/file-transfer-go.git
cd file-transfer-go
docker-compose up -d

# 访问应用
open http://localhost:8080

方式二：本地开发

# 1. 启动后端服务
make dev

# 2. 启动前端服务  
cd chuan-next
yarn 
yarn dev

# 访问应用
open http://localhost:3000

🎯 URL路由支持

支持通过URL参数直接跳转到特定功能：

# 文件传输
/?type=file&mode=send      # 发送文件
/?type=file&mode=receive   # 接收文件

# 文字传输
/?type=text&mode=send      # 发送文字
/?type=text&mode=receive   # 接收文字

# 桌面共享
/?type=desktop&mode=send   # 共享桌面
/?type=desktop&mode=receive # 观看桌面

🌟 项目特色

• ⚡ 零配置 - 无需注册登录，即开即用
• 🔒 点对点 - 基于WebRTC的直接传输，服务器仅做信令
• 📱 响应式 - 完美适配手机、平板、电脑
• <EFBFBD> 现代UI - 精美的毛玻璃效果，流畅的动画
• 🚀 高性能 - 64KB分块传输，支持大文件高速传输

📊 系统架构

┌─────────────────┐    WebSocket     ┌──────────────┐    WebSocket     ┌─────────────────┐
│   发送方 (A)     │ ←──────────────→ │   信令服务器   │ ←──────────────→ │   接收方 (B)     │
│                 │                  │              │                  │                 │
│  - 选择文件      │                  │  - 房间管理   │                  │  - 输入取件码    │
│  - 生成取件码    │                  │  - 信令转发   │                  │  - 获取文件列表  │
│  - 等待连接      │                  │  - 状态同步   │                  │  - 下载文件      │
└─────────────────┘                  └──────────────┘                  └─────────────────┘
         │                                                                       │
         │                          WebRTC P2P                                   │
         │                     ┌─────────────────┐                               │
         └────────────────────→│   直接文件传输    │←──────────────────────────────┘
                               │                 │
                               │ - 端到端加密     │
                               │ - 高速传输       │
                               │ - 断点续传       │
                               └─────────────────┘

📁 项目结构

.
├── cmd/                 # Go应用入口
├── internal/           # Go后端核心代码
│   ├── handlers/       # HTTP和WebSocket处理器
│   ├── models/         # 数据模型
│   └── services/       # 业务服务层
├── chuan-next/         # Next.js前端应用
│   ├── src/app/        # 应用页面
│   ├── src/components/ # 组件库
│   └── src/hooks/      # React Hooks
├── web/               # 静态资源（测试页面）
├── docker-compose.yml # Docker部署配置
└── Makefile          # 构建脚本

🤝 贡献指南

欢迎提交Issue和Pull Request来帮助改进项目！

📄 许可证

MIT License │ 发送方浏览器 │◄────────┤ 信令服务器 ├────────►│ 接收方浏览器 │ │ │ │ │ │ │ │ ┌───────────┐ │ │ ┌──────────┐ │ │ ┌───────────┐ │ │ │ 文件选择 │ │ │ │ WebSocket│ │ │ │ 取件码输入│ │ │ └───────────┘ │ │ │ 信令 │ │ │ └───────────┘ │ │ ┌───────────┐ │ │ └──────────┘ │ │ ┌───────────┐ │ │ │ 生成取件码│ │ │ ┌──────────┐ │ │ │ 文件接收 │ │ │ └───────────┘ │ │ │ 房间管理 │ │ │ └───────────┘ │ │ │ │ └──────────┘ │ │ │ └─────────────────┘ └──────────────┘ └─────────────────┘ │ │ └─────────────────── WebRTC P2P 连接 ──────────────────┘ (文件直接传输)

## 🛠️ 技术栈

### 后端
- **Go 1.21+**：高性能Web服务器
- **Chi Router**：轻量级HTTP路由
- **Gorilla WebSocket**：WebSocket连接管理
- **标准库**：HTML模板、JSON处理等

### 前端
- **原生JavaScript**：无框架依赖
- **WebRTC API**：浏览器P2P通信
- **Tailwind CSS**：现代化UI样式
- **模块化设计**：分离的JS文件结构

### 基础设施
- **Docker支持**：容器化部署
- **Nginx代理**：生产环境反向代理
- **STUN服务器**：NAT穿透支持

## 📁 项目结构

chuan/ ├── cmd/ │ └── main.go # 程序入口 ├── internal/ │ ├── handlers/ │ │ └── handlers.go # HTTP请求处理 │ ├── models/ │ │ └── models.go # 数据模型定义 │ └── services/ │ ├── file_service.go # 文件服务（预留） │ ├── memory_store.go # 内存存储 │ ├── p2p_service.go # P2P连接管理 │ └── webrtc_service.go # WebRTC服务（预留） ├── web/ │ ├── static/ │ │ ├── css/ │ │ │ └── style.css # 样式文件 │ │ └── js/ │ │ ├── common.js # 通用工具函数 │ │ ├── p2p-transfer.js # P2P传输核心逻辑 │ │ ├── webrtc-connection.js # WebRTC连接管理 │ │ └── file-transfer.js # 文件传输处理 │ └── templates/ │ ├── base.html # 基础模板 │ ├── index.html # 主页面 │ ├── upload.html # 上传页面（预留） │ └── video.html # 视频传输页面 ├── uploads/ # 上传目录（预留） ├── bin/ │ └── chuan # 编译后的可执行文件 ├── docker-compose.yml # Docker Compose配置 ├── Dockerfile # Docker镜像构建 ├── nginx.conf # Nginx配置 ├── Makefile # 构建脚本 ├── deploy.sh # 部署脚本 ├── go.mod # Go模块定义 ├── go.sum # Go模块校验 └── README.md # 项目文档

## 🚀 快速开始

### 本地开发

1. **克隆项目**
```bash
git clone <repository-url>
cd chuan

2. 安装依赖

go mod tidy

3. 启动服务

go run cmd/main.go

4. 访问应用

打开浏览器访问: http://localhost:8080

使用Make命令

# 运行开发服务器
make run

# 构建可执行文件
make build

# 清理构建文件
make clean

# 运行测试
make test

Docker部署

1. 构建镜像

docker build -t chuan .

2. 运行容器

docker run -p 8080:8080 chuan

3. 使用Docker Compose

docker-compose up -d

📖 使用说明

发送文件

1. 访问主页面
2. 点击选择文件或拖拽文件到上传区域
3. 点击"生成取件码"按钮
4. 分享6位取件码给接收方
5. 等待接收方连接并开始传输

接收文件

1. 访问主页面
2. 在"输入取件码"区域输入6位取件码
3. 系统自动连接并显示文件列表
4. 等待P2P连接建立（显示绿色状态）
5. 点击"下载"按钮开始接收文件

传输状态说明

• 🟡 等待连接：正在建立WebSocket连接
• 🟢 P2P已连接：可以开始文件传输
• 🔴 连接失败：请检查网络或重试

⚙️ 配置说明

环境变量

• PORT：服务器端口（默认8080）
• HOST：服务器主机（默认localhost）

STUN服务器配置

系统默认使用以下STUN服务器（按优先级）：

1. stun:stun.chat.bilibili.com:3478 - 哔哩哔哩
2. stun:stun.voipbuster.com - VoIP服务
3. stun:stun.voipstunt.com - VoIP服务
4. stun:stun.qq.com:3478 - 腾讯QQ
5. stun:stun.l.google.com:19302 - Google（备用）

🔧 高级配置

传输参数优化

在 file-transfer.js 中可调整以下参数：

const chunkSize = 65536;        // 分块大小（64KB）
const transmissionDelay = 1;    // 传输间隔（1ms）
const maxRetransmits = 3;       // 最大重传次数
const maxPacketLifeTime = 3000; // 数据包最大生存时间

连接超时设置

在 webrtc-connection.js 中可调整：

const connectionTimeout = 60000; // 连接超时（60秒）

🐛 故障排除

常见问题

1. P2P连接失败

   • 检查防火墙设置
   • 确认浏览器支持WebRTC
   • 尝试使用不同的STUN服务器

2. 文件传输中断

   • 检查网络连接稳定性
   • 避免浏览器标签页切换到后台
   • 大文件传输建议分批进行

3. 取件码无效

   • 确认取件码输入正确（6位大写字母数字）
   • 检查房间是否已过期（默认1小时）
   • 确认发送方仍在线

调试模式

打开浏览器开发者工具（F12），查看Console标签页获取详细日志信息。

🚀 生产部署

Nginx配置

server {
    listen 80;
    server_name your-domain.com;
    
    location / {
        proxy_pass http://localhost:8080;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
    
    location /ws {
        proxy_pass http://localhost:8080;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "Upgrade";
        proxy_set_header Host $host;
    }
}

systemd服务

创建 /etc/systemd/system/chuan.service：

[Unit]
Description=Chuan P2P File Transfer Service
After=network.target

[Service]
Type=simple
User=www-data
WorkingDirectory=/opt/chuan
ExecStart=/opt/chuan/bin/chuan
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

启动服务：

sudo systemctl enable chuan
sudo systemctl start chuan

🤝 贡献指南

1. Fork 项目
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启 Pull Request

📝 开发计划

v1.1 计划功能

• 文件传输加密增强
• 传输速度优化
• 移动端适配改进
• 批量文件操作

v1.2 计划功能

• 用户认证系统
• 传输历史记录
• 文件预览功能
• API接口开放

v2.0 计划功能

• 视频通话功能完善
• 屏幕共享支持
• 多人会议室
• 云存储集成

📄 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情

🙏 致谢

• WebRTC - 实时通信技术
• Go - 后端开发语言
• Tailwind CSS - UI样式框架
• Chi Router - Go HTTP路由库

📞 联系方式

• 项目主页：[GitHub Repository]
• 问题反馈：[GitHub Issues]

---

⭐ 如果这个项目对你有帮助，请给它一个星标！