File-Transfer-Go 是一款基于 Go 语言开发的高性能跨平台文件传输工具，支持局域网及互联网环境下的 P2P 直连、WebRTC 及 HTTP 传输。具备 Web 界面、断点续传、大文件支持、TLS 加密及安全认证等特性。支持二进制安装、Docker 部署及源码编译，可集成至 Nginx 或云存储，适用于企业内部共享、开发团队协作及个人文件互传场景。
File-Transfer-Go 是一个用 Go 语言开发的高性能、跨平台文件传输工具，支持局域网和互联网文件传输。它类似于一个简化的 WeTransfer 或 SendAnywhere，但完全开源且可自托管。
┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ Web UI │◄──►│ HTTP Server │◄──►│ 文件管理器 │ └─────────────┘ └─────────────┘ └─────────────┘ │ ┌───────▼───────┐ │ 传输引擎核心 │ ├───────────────┤ │ P2P 模块 │ │ HTTP 模块 │ │ WebRTC 模块 │ └───────┬───────┘ │ ┌───────▼───────┐ │ 网络层/IO │ └───────────────┘
# Linux/macOS
curl -L https://github.com/xxx/file-transfer-go/releases/latest/download/ftg-linux-amd64 -o ftg
chmod +x ftg
./ftg
# Windows
# 下载 ftg-windows-amd64.exe 并运行
docker run -d \
-p 8080:8080 \
-v /path/to/data:/data \
--name file-transfer \
filetransfer/go
git clone https://github.com/xxx/file-transfer-go.git
cd file-transfer-go
go build -o ftg main.go
./ftg
# config.yaml
server:
port: 8080
host: "0.0.0.0"
ssl:
enable: false
cert: "cert.pem"
key: "key.pem"
storage:
path: "./uploads"
max_size: "10GB" # 单个文件最大
total_size: "100GB" # 总存储限制
transfer:
chunk_size: 5242880 # 5MB 分块
threads: 4 # 并发线程数
timeout: 300 # 超时秒数
security:
enable_auth: false
allow_origins: ["*"]
token_expire: 24h
# 启动服务
./ftg serve
# 指定端口
./ftg serve --port 9000 --host 192.168.1.100
# 启用 HTTPS
./ftg serve --ssl --cert cert.pem --key key.pem
访问 http://localhost:8080 即可使用：
# 发送文件
./ftg send /path/to/file.txt --recipient 192.168.1.101:8080
# 接收文件
./ftg receive --output ./downloads
# 批量发送
./ftg send /path/to/folder --recursive
# 上传文件
curl -X POST http://localhost:8080/api/upload \
-F "[email protected]"
# 获取文件列表
curl http://localhost:8080/api/files
# 下载文件
curl -O http://localhost:8080/api/download/{file_id}
# 启用 P2P 模式（无需服务器中转）
./ftg serve --mode p2p
# 两台设备直接传输
# 设备 A（发送端）
./ftg send file.jpg --p2p
# 设备 B（接收端）
./ftg receive --code XXXXXX # 输入显示的安全码
// 在网页中使用 WebRTC
const ftg = new FileTransferGo({
signalingServer: 'ws://localhost:8080/ws',
onProgress: (progress) => {
console.log(`传输进度：${progress}%`);
}
});
// 发送文件
await ftg.sendFile(file);
// 接收文件
await ftg.receiveFile(fileId);
// 客户端自动处理断点续传
resumeInfo := client.CheckResume(fileHash)
if resumeInfo.CanResume {
client.ResumeUpload(filePath, resumeInfo.Offset)
}
file-transfer-go/
├── cmd/ # CLI 命令
│ ├── serve.go # 服务启动
│ ├── send.go # 发送命令
│ └── receive.go # 接收命令
├── internal/
│ ├── server/ # HTTP 服务器
│ ├── transfer/ # 传输引擎
│ │ ├── p2p.go # P2P 传输
│ │ ├── http.go # HTTP 传输
│ │ └── webrtc.go # WebRTC 传输
│ ├── storage/ # 存储管理
│ └── crypto/ # 加密模块
├── web/ # 前端界面
│ ├── static/ # 静态文件
│ └── templates/ # 模板文件
├── pkg/ # 公共库
└── configs/ # 配置文件
// 自定义传输协议
type CustomTransfer struct {
transfer.BaseTransfer
}
func (c *CustomTransfer) Send(filePath string) error {
// 实现自定义发送逻辑
return nil
}
// 注册到系统中
transfer.Register("custom", &CustomTransfer{})
# 启用认证
security:
enable_auth: true
users:
- username: admin
password: $2a$10$...
- username: user
password: $2a$10$...
rate_limit: 100 # 请求频率限制
// 多线程分块传输
func (t *Transfer) uploadFile(filePath string) {
chunks := t.splitFile(filePath)
var wg sync.WaitGroup
for i, chunk := range chunks {
wg.Add(1)
go func(idx int, data []byte) {
defer wg.Done()
t.uploadChunk(idx, data)
}(i, chunk)
}
wg.Wait()
}
# 使用 systemd
sudo cp ftg.service /etc/systemd/system/
sudo systemctl enable ftg
sudo systemctl start ftg
# docker-compose.yml
version: '3'
services:
ftg:
image: filetransfer/go
ports:
- "8080:8080"
volumes:
- ./data:/data
environment:
- FTG_MODE=cluster
- REDIS_URL=redis:6379
redis:
image: redis:alpine
# Kubernetes Deployment
apiVersion: apps/v1
kind: Deployment
metadata:
name: file-transfer
spec:
replicas: 3
template:
spec:
containers:
- name: ftg
image: filetransfer/go
ports:
- containerPort: 8080
metrics:
enable: true
path: "/metrics"
# 结构化日志
./ftg serve --log-level info --log-format json
# 日志轮转
./ftg serve --log-file /var/log/ftg.log --log-max-size 100MB
# nginx.conf
server {
listen 80;
server_name transfer.yourdomain.com;
location / {
proxy_pass http://localhost:8080;
proxy_set_header X-Real-IP $remote_addr;
# 大文件上传优化
client_max_body_size 10G;
proxy_request_buffering off;
}
}
// 支持 AWS S3、阿里云 OSS 等
storage, err := s3.NewS3Storage(S3Config{
Bucket: "my-bucket",
Region: "us-east-1",
})
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online
将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online