MCPcopy
hub / github.com/MatrixSeven/file-transfer-go

github.com/MatrixSeven/file-transfer-go @v1.1.0 sqlite

repository ↗ · DeepWiki ↗ · release v1.1.0 ↗
300 symbols 643 edges 87 files 51 documented · 17%
README

文件快传 - P2P文件传输工具

安全、快速、简单的点对点文件传输解决方案 - 无需注册,即传即用

在线体验关注我帮助文档

项目演示

✨ 核心功能[端到端数据传输完全基于WebRTC的P2P直连/文件在线传输]

React Next.js TypeScript Go WebRTC Tailwind CSS

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

🚀 技术栈

前端技术栈

  • 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

📄 许可证

MIT License


⭐ 如果觉得这个项目对你有帮助,请给个星标!

[Star History Chart]

Extension points exported contracts — how you extend this code

FileInfo (Interface)
(no doc)
chuan-next/src/types/index.ts
TransferProgress (Interface)
(no doc)
chuan-next/src/types/index.ts
RoomStatus (Interface)
(no doc)
chuan-next/src/types/index.ts
VoiceChatPanelProps (Interface)
(no doc)
chuan-next/src/components/VoiceChatPanel.tsx
AddServerModalProps (Interface)
(no doc)
chuan-next/src/components/WebRTCSettings.tsx

Core symbols most depended-on inside this repo

cn
called by 23
chuan-next/src/lib/utils.ts
sendMessage
called by 13
chuan-next/src/hooks/connection/types.ts
useToast
called by 11
chuan-next/src/components/ui/toast-simple.tsx
connect
called by 9
chuan-next/src/hooks/connection/types.ts
getEnv
called by 8
chuan-next/src/lib/config.ts
disconnect
called by 7
chuan-next/src/hooks/connection/types.ts
checkRoomStatus
called by 6
chuan-next/src/lib/room-utils.ts
useSharedWebRTCManager
called by 6
chuan-next/src/hooks/connection/useSharedWebRTCManager.ts

Shape

Function 179
Interface 58
Method 47
Struct 14
Class 2

Languages

TypeScript80%
Go20%

Modules by API surface

chuan-next/src/hooks/connection/types.ts18 symbols
internal/services/webrtc_service.go16 symbols
chuan-next/src/lib/transfer-utils.ts14 symbols
internal/web/frontend.go13 symbols
chuan-next/src/components/WebRTCSettings.tsx13 symbols
chuan-next/src/components/DesktopViewer.tsx11 symbols
chuan-next/src/app/help/HelpPage.tsx11 symbols
chuan-next/src/components/WebRTCFileTransfer.tsx10 symbols
chuan-next/src/components/webrtc/WebRTCTextSender.tsx9 symbols
internal/services/relay_service.go8 symbols
chuan-next/src/lib/config.ts8 symbols
internal/handlers/handlers.go7 symbols

Dependencies from manifests, versioned

github.com/go-chi/corsv1.2.1 · 1×
@eslint/eslintrc3 · 1×
@radix-ui/react-avatar1.1.10 · 1×
@radix-ui/react-dialog1.1.14 · 1×
@radix-ui/react-progress1.1.7 · 1×
@radix-ui/react-separator1.1.7 · 1×
@radix-ui/react-slot1.2.3 · 1×
@radix-ui/react-toast1.2.14 · 1×

For agents

$ claude mcp add file-transfer-go \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact