File-Transfer-Go 开源跨平台文件传输工具

# 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

📖 使用示例

1. 基本使用

# 启动服务
./ftg serve
# 指定端口
./ftg serve --port 9000 --host 192.168.1.100
# 启用 HTTPS
./ftg serve --ssl --cert cert.pem --key key.pem

2. Web 界面操作

访问 http://localhost:8080 即可使用：

• 上传文件：拖拽或选择文件
• 生成链接：自动生成分享链接
• 二维码：手机扫码下载
• 管理文件：查看、删除已上传文件

3. 命令行传输

# 发送文件
./ftg send /path/to/file.txt --recipient 192.168.1.101:8080
# 接收文件
./ftg receive --output ./downloads
# 批量发送
./ftg send /path/to/folder --recursive

4. API 使用

# 上传文件
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}

🔧 高级功能

1. P2P 直连模式

# 启用 P2P 模式（无需服务器中转）
./ftg serve --mode p2p
# 两台设备直接传输
# 设备 A（发送端）
./ftg send file.jpg --p2p
# 设备 B（接收端）
./ftg receive --code XXXXXX # 输入显示的安全码

2. WebRTC 传输

// 在网页中使用 WebRTC
const ftg = new FileTransferGo({
  signalingServer: 'ws://localhost:8080/ws',
  onProgress: (progress) => {
    console.log(`传输进度：${progress}%`);
  }
});

// 发送文件
await ftg.sendFile(file);
// 接收文件
await ftg.receiveFile(fileId);

3. 断点续传

// 客户端自动处理断点续传
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{})

🔐 安全特性

1. 传输安全

• TLS 1.3 加密传输
• 端到端加密（P2P 模式）
• 文件哈希校验
• 过期链接自动清理

2. 访问控制

# 启用认证
security:
  enable_auth: true
  users:
    - username: admin
      password: $2a$10$...
    - username: user
      password: $2a$10$...
  rate_limit: 100 # 请求频率限制

📊 性能优化

1. 并发处理

// 多线程分块传输
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()
}

2. 内存优化

• 流式传输，避免大文件内存占用
• 分块读取，适合大文件
• 内存池复用

🌐 部署方案

1. 单机部署

# 使用 systemd
sudo cp ftg.service /etc/systemd/system/
sudo systemctl enable ftg
sudo systemctl start ftg

2. 集群部署

# 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

3. 云原生部署

# 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

📈 监控与日志

1. Prometheus 监控

metrics:
  enable: true
  path: "/metrics"

2. 日志配置

# 结构化日志
./ftg serve --log-level info --log-format json
# 日志轮转
./ftg serve --log-file /var/log/ftg.log --log-max-size 100MB

🔄 与其他工具集成

1. 与 Nginx 集成

# 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;
  }
}

2. 与云存储集成

// 支持 AWS S3、阿里云 OSS 等
storage, err := s3.NewS3Storage(S3Config{
  Bucket: "my-bucket",
  Region: "us-east-1",
})

🎯 使用场景

1. 企业内部文件共享

• 安全的内部文件传输
• 大文件分享
• 跨部门协作

2. 开发团队

• 传输测试文件
• 分享构建产物
• 部署包分发

3. 个人使用

• 手机电脑互传
• 临时文件分享
• 备份重要文件

📝 注意事项

1. 安全提醒：
   • 公开部署时务必启用 HTTPS
   • 定期清理过期文件
   • 限制上传文件类型
2. 性能建议：
   • 机械硬盘建议分块大小 2-5MB
   • SSD 建议分块大小 5-10MB
   • 根据网络带宽调整并发数
3. 存储管理：
   • 设置合理的存储配额
   • 定期备份重要文件
   • 监控磁盘使用情况

🔗 相关资源

• GitHub 仓库: https://github.com/xxx/file-transfer-go
• 文档网站: https://ftg.example.com/docs
• Docker Hub: https://hub.docker.com/r/filetransfer/go
• 在线演示: https://demo.file-transfer-go.com