【GitHub项目推荐--文件快传 - P2P文件传输工具】

有时候需要在不同设备间传输大文件，传统的蓝牙方式又慢又不稳定，而使用网盘又要登录，挺让人头疼的。

面对这个痛点，File Transfer Go 项目提供了一个解决方案，基于 WebRTC 技术安全快速的点对点文件传输。

数据完全不需要经过服务器中转，更加安全隐私，支持多文件同时传输、文字分享以及桌面共享等功能。

主要功能：

• 📁 文件传输 - 支持多文件同时传输
• 📝 文字传输 - 快速分享文本内容
• 🖥️ 桌面共享 - 实时屏幕共享
• 🔗 连接状态同步 - 实时连接状态UI同步
• 🔒 端到端加密 - 数据传输安全，服务器不存储文件
• 📱 响应式设计 - 完美适配手机、平板、电脑
• 🖥️ 多平台支持 - 支持linux/macos/win 单文件部署

支持 Docker 一键部署或本地构建，界面采用响应式设计，适配手机、平板以及电脑使用。

🚀 技术栈

前端技术栈

• 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 一键部署（推荐）

# 使用 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

方式二：本地构建部署

git clone https://github.com/MatrixSeven/file-transfer-go.git
cd file-transfer-go
./build-fullstack.sh 
./dist/file-transfer-go

访问 http://localhost:8080 开始使用

方式三：开发环境部署

# 后端服务
make dev

# 前端服务（新终端）
cd chuan-next && yarn && yarn dev

部署配置说明

环境变量配置

• NODE_ENV: 运行环境（development/production）
• PORT: 服务端口（默认8080）
• GO_BACKEND_URL: 后端服务地址

Docker 配置选项

# 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直连传输 ──────────────────────────┘

🛠️ 本地开发

# 后端
make dev

# 前端
cd chuan-next && yarn && yarn dev

github地址：MatrixSeven/file-transfer-go: Go/React开发的端到端webrtc的文件传输/文字传输/桌面共享，安全，隐私，数据不经过服务器。