Docker部署file‑transfer‑go｜轻量自建文件传输服务完整实践

一、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。

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文件即可启动服务，极大提升了部署效率。通过浏览器访问服务界面，能够便捷地完成文件上传、取件码生成与接收等操作，满足临时文件分享需求。该方案适用于个人或团队在内网或公网环境中快速搭建安全、临时的文件传输服务。