# file-transfer-go
**Repository Path**: wangxinbing/file-transfer-go
## Basic Information
- **Project Name**: file-transfer-go
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-16
- **Last Updated**: 2025-09-16
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# 文件快传 - P2P文件传输工具
**安全、快速、简单的点对点文件传输解决方案 - 无需注册，即传即用**
## [在线体验](https://transfer.52python.cn) • [关注我](https://x.com/_MatrixSeven) • [帮助文档](https://transfer.52python.cn/help)
## ✨ 核心功能[端到端数据传输完全基于WebRTC的P2P直连]
- 📁 **文件传输** - 支持多文件同时传输
- 📝 **文字传输** - 快速分享文本内容
- 🖥️ **桌面共享** - 实时屏幕共享
- 🔗 **连接状态同步** - 实时连接状态UI同步
- 🔒 **端到端加密** - 数据传输安全，服务器不存储文件
- 📱 **响应式设计** - 完美适配手机、平板、电脑
- 🖥️ **多平台支持** - 支持linux/macos/win 单文件部署
## 🔄 最近更新日志
### 2025-09-5
- ✅ **WEBRTC链接恢复** - 关闭页面后在打开，进行数据链接恢复
- ✅ **定义TURN配置** - 支持自定义中继TURN配置
- ✅ **优化移动端提示** - 优化各种场景的错误提示
- ✅ **帮助文档** - 常见问题说明文档更新
### 2025-09-1
- ✅ **移动端桌面全屏** - 优化移动端下UI，并解决全屏问题
### 2025-08-28
- ✅ **完善Docker部署支持** - 优化Docker配置，支持一键部署和多环境配置
- ✅ **优化README文档** - 更新项目说明，完善部署指南和技术栈信息
- ✅ **改进UI用户体验** - 优化界面细节，完善错误提示和加载状态
- ✅ **重构Hooks架构** - 拆分复杂hooks，提高代码复用性和可维护性
### 2025-08-24
- ✅ **文件传输 ACK 确认支持** - 实现了可靠的数据传输机制，每个数据块都需要接收方确认
- ✅ **修复组件渲染后重复注册/解绑 bug** - 解决了 React 组件重复渲染导致的处理器反复注册问题
- ✅ **修复进度显示 Infinity% 问题** - 解决了除零错误和进度闪烁问题
### 2025-08-14
- ✅ **分离UI组件，统一UI状态** - 重构UI架构，提高代码复用性和可维护性
- ✅ **共享底层链接** - 优化WebRTC连接管理，支持多个业务模块共享连接
- ✅ **远程桌面支持** - 新增实时屏幕共享功能
- ✅ **修复 WebRTC 连接状态异常** - 增强了连接状态错误处理和恢复能力
## 🚀 技术栈
### 前端技术栈
- **Next.js 15** - React全栈框架，支持SSR/SSG
- **React 18** - 现代化UI组件库
- **TypeScript 5** - 类型安全的JavaScript超集
- **Tailwind CSS 3.4** - 实用优先的CSS框架
- **Radix UI** - 无障碍访问的组件库
- **Zustand** - 轻量级状态管理
- **Lucide React** - 现代化图标库
### 后端技术栈
- **Go 1.22** - 高性能编程语言
- **WebSocket** - 实时双向通信
- **内存存储** - 轻量级数据存储
- **标准库** - 原生HTTP服务器
### 传输协议
- **WebRTC DataChannel** - 端到端数据传输
- **P2P直连** - 点对点连接，无需中转
- **ICE框架** - 网络连接协商
- **STUN/TURN** - NAT穿透支持
### 架构特点
- **微服务架构** - 前后端分离
- **实时通信** - WebSocket + WebRTC
- **响应式设计** - 移动端适配
- **容器化** - Docker部署支持
## 📦 快速部署
### 方式一：Docker 一键部署（推荐）
```bash
# 使用 Docker Compose（最简单）
git clone https://github.com/MatrixSeven/file-transfer-go.git
cd file-transfer-go
docker-compose up -d
# 或者直接使用 Docker 镜像
docker run -d -p 8080:8080 --name file-transfer-go matrixseven/file-transfer-go:latest
```
### 方式二：本地构建部署
```bash
git clone https://github.com/MatrixSeven/file-transfer-go.git
cd file-transfer-go
./build-fullstack.sh
./dist/file-transfer-go
```
访问 http://localhost:8080 开始使用
### 方式三：开发环境部署
```bash
# 后端服务
make dev
# 前端服务（新终端）
cd chuan-next && yarn && yarn dev
```
### 部署配置说明
#### 环境变量配置
- `NODE_ENV`: 运行环境（development/production）
- `PORT`: 服务端口（默认8080）
- `GO_BACKEND_URL`: 后端服务地址
#### Docker 配置选项
```yaml
# docker-compose.yml 可配置项
environment:
- NODE_ENV=production
- PORT=8080
ports:
- "8080:8080"
restart: unless-stopped
```
#### 多架构支持
项目支持多架构Docker镜像：
- `linux/amd64` - x86_64 架构
- `linux/arm64` - ARM 64位架构
#### 镜像版本
- `latest` - 最新稳定版本
- `v1.0.x` - 特定版本号
- `dev` - 开发版本
## 🎯 使用方法
### 发送文件
1. 选择文件 → 生成取件码 → 分享6位码
### 文字传输
1. 输入文字内容 → 生成取件码 → 分享给对方
### 桌面共享
1. 点击共享桌面 → 生成取件码 → 对方输入码观看
## 📊 项目架构
```
发送方 ←─── WebSocket信令 ───→ 服务器 ←─── WebSocket信令 ───→ 接收方
│ │
└────────────── WebRTC P2P直连传输 ──────────────────────────┘
```
## 🛠️ 本地开发
```bash
# 后端
make dev
# 前端
cd chuan-next && yarn && yarn dev
```
## 📄 许可证
MIT License
---
⭐ 如果觉得这个项目对你有帮助，请给个星标！
[]