一、file-transfer-go介绍
1.1 file-transfer-go简介
file-transfer-go是一个基于 Go（后端信令与 P2P 协调）和 React（前端界面）构建的端到端 WebRTC 应用，专注于安全、高效、无需中转服务器的数据传输。它支持文件、文本和桌面共享，所有数据直接在用户之间传输，不经过任何中间服务器，确保隐私与安全。
1.2 file-transfer-go主要特点
- 📁 多文件同时传输：支持一次性选择并并行传输多个文件，提升批量分享效率。
- 📝 即时文字传输：可快速发送纯文本消息，无需等待连接建立完成即可预览内容。
- 🖥️ 实时桌面共享：通过 WebRTC 实现低延迟屏幕共享，适用于远程协作或演示场景。
- 🔗 连接状态同步：UI 实时反映 Peer 连接状态（如连接中、已连接、断开等），提升用户体验。
- 🔒 端到端加密：所有传输内容使用 DTLS/SRTP（WebRTC 内建）及可选应用层加密，确保数据无法被窃听或篡改。
- 📱 响应式设计：前端采用现代化 React 响应式布局，适配手机、平板和桌面设备。
- 🖥️ 多平台单文件部署：后端使用 Go 编译为单一可执行文件，支持 Linux、macOS 和 Windows，部署简单无依赖。
二、本次实践规划
2.1 本地环境规划
本次实践为个人测试环境，操作系统版本为 Ubuntu 24.04.2 LTS。
| hostname | IP地址 | 操作系统版本 | Docker版本 | 部署项目 | 备注 |
|---|---|---|---|---|---|
| jeven | 192.168.3.88 | Ubuntu 24.04.2 LTS | 28.5.0 | file-transfer-go | —— |
2.2 本次实践介绍
1.本次实践部署环境为个人测试环境，生产环境请谨慎；
2.在Docker环境下部署file-transfer-go文件传输工具。
三、本地环境检查
3.1 检查Docker服务状态
检查Docker服务是否正常运行，确保Docker正常运行。
root@jeven:~# systemctl status docker
● docker.service - Docker Application Container Engine
Loaded: loaded (/usr/lib/systemd/system/docker.service; enabled; preset: enabled)
Active: active (running) since Tue 2025-12-02 00:51:31 CST; 1min 11s ago
TriggeredBy: ● docker.socket
Docs: https://docs.docker.com
Main PID: 75393 (dockerd)
Tasks: 32
Memory: 34.1M (peak: 34.8M)
CPU: 1.248s
CGroup: /system.slice/docker.service
3.2 检查Docker版本
检查Docker版本
root@jeven:~# docker -v
Docker version 28.5.0, build 887030f
3.3 检查docker compose 版本
检查Docker compose版本，确保2.0以上版本。
root@jeven:~# docker compose version
Docker Compose version v2.39.4
四、拉取file-transfer-go文件传输工具镜像
下载file-transfer-go文件传输工具镜像，执行以下命令：
docker pull matrixseven/file-transfer-go:latest
五、部署file-transfer-go服务
5.1 创建部署目录
- 创建部署目录
mkdir -p /data/file-transfer-go/ && cd /data/file-transfer-go
5.2 docker compose方式部署
如果使用docker-cli方式部署，可参考以下命令：
docker run -d -p 8080:8080 --name file-transfer-go matrixseven/file-transfer-go:latest
新建及编辑docker-compose.yaml文件，宿主机映射端口可自行设置，注意防止端口冲突。
vim docker-compose.yaml
version: '3'
services:
file-transfer-go:
image: matrixseven/file-transfer-go:latest
container_name: file-transfer-go
restart: unless-stopped
ports:
- 7500:8080
5.3 创建file-transfer-go容器
执行以下命令，创建file-transfer-go容器。
docker compose up -d
5.4 查看file-transfer-go容器状态
检查file-transfer-go容器运行状态，确保file-transfer-go容器正常启动。
root@jeven:/data/file-transfer-go# docker compose ps
WARN[0000] /data/file-transfer-go/docker-compose.yaml: the attribute `version` is obsolete, it will be ignored, please remove it to avoid potential confusion
NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS
file-transfer-go matrixseven/file-transfer-go:latest "./server" file-transfer-go 2 minutes ago Up 2 minutes 0.0.0.0:7500->8080/tcp,[::]:7500->8080/tcp
5.5 检查file-transfer-go容器日志
检查容器运行日志，确保file-transfer-go服务正常运行。
docker compose logs
六、访问file-transfer-go服务
6.1 访问file-transfer-go首页
浏览器地址：
http://<个人的服务器IP>:7500，访问file-transfer-go初始页。如果无法访问，请确保宿主机的防火墙已关闭或已放行相关端口，对于云服务器还需配置相应的安全组规则。
6.2 发送文件
选择文件传输——发送文件，将本地上传到file-transfer-go。
6.3 生成取件码
上传文件后，我们点击【生成取件码】，我们可以通过复制文件链接来接收文件。
6.4 接收文件
- 分享链接访问：将分享链接复制到内网中另外一台电脑，则可以看到已建立连接，直接点击【开始传输】即可。
七、总结
通过本次实践，我们成功使用Docker和Docker Compose快速部署了file-transfer-go文件传输工具，验证了其轻量、高效和易用的特性。整个过程无需复杂配置，仅需编写简单的compose文件即可启动服务，极大提升了部署效率。通过浏览器访问服务界面，能够便捷地完成文件上传、取件码生成与接收等操作，满足临时文件分享需求。该方案适用于个人或团队在内网或公网环境中快速搭建安全、临时的文件传输服务。
