johngong/syncthing-relay-discosrv

Syncthing 中继与发现服务器 Docker 镜像文档

镜像概述

本镜像基于 Syncthing 项目，集成中继服务器（strelaysrv）和发现服务器（stdiscosrv），提供 Syncthing 设备间的中继转发与节点发现功能。适用于搭建私有 Syncthing 中继网络，解决设备间直接连接困难问题，提升同步稳定性。

核心功能与特性

• 集成双服务器：同时支持中继服务器（strelaysrv）和发现服务器（stdiscosrv），可独立启用或禁用
• 版本信息：strelaysrv 2.0.10、stdiscosrv 2.0.10
• 多架构支持：兼容 amd64、arm64v8、arm32v7 架构
• 灵活配置：支持速率限制（全局/每会话）、超时设置、持久化证书与数据库
• 权限控制：可自定义运行用户 UID/GID，适配不同环境权限要求

使用场景

• 搭建私有 Syncthing 中继网络，加速跨网络设备同步
• 部署本地发现服务器，提升局域网或私有网络内设备发现效率
• NAS 环境（如群晖）中部署，提供稳定的中继与发现服务
• 需要控制数据传输速率、保障同步安全性的企业或个人场景

版本信息

安装与部署

镜像下载

Docker 命令行部署

快速启动（默认配置）

bash
docker run -d \
  --name=syncthing-relay-discosrv \
  -p 22067:22067 \
  -p 22070:22070 \
  -p 8443:8443 \
  --restart unless-stopped \
  docker.xuanyuan.run/johngong/syncthing-relay-discosrv:latest

自定义配置示例（持久化+速率限制）

bash
docker run -d \
  --name=syncthing-relay-discosrv \
  -p 22067:22067 \
  -p 22070:22070 \
  -p 8443:8443 \
  -v /path/to/local/config:/config \  # 持久化配置、证书与数据库
  -e UID=1024 \
  -e GID=1024 \
  -e GLOBAL_RATE=200000000 \  # 全局速率限制 200MB/s
  -e PER_SESSION_RATE=20000000 \  # 每会话速率限制 20MB/s
  --restart unless-stopped \
  johngong/syncthing-relay-discosrv:latest

群晖 NAS 部署

卷配置（可选）

端口配置

环境变量配置

在群晖 Docker 界面「环境」选项卡中添加以下变量：

配置参数详解

基础命令参数

端口映射

卷挂载

环境变量

容器管理

基本操作

bash
# 启动容器
docker start syncthing-relay-discosrv

# 停止容器
docker stop syncthing-relay-discosrv

# 重启容器
docker restart syncthing-relay-discosrv

# 查看容器日志（获取 Device ID 等关键信息）
docker logs syncthing-relay-discosrv

# 删除容器（需先停止）
docker rm syncthing-relay-discosrv

# 删除镜像
docker rmi johngong/syncthing-relay-discosrv:latest

客户端配置

获取服务器 Device ID

1. 通过容器日志获取：

   bash
   docker logs syncthing-relay-discosrv | grep "Device ID"
   

   输出示例：Device ID: ITZRNXE-YNROGBZ-HXTH5P7-VK5NYE5-QHRQGE2-7JQ6VNJ-KZUEDIU-5PPR5AM

Syncthing 客户端设置

1. 全局连接配置

进入 Syncthing 客户端界面 → 操作 → 设置 → 连接：

• 协议监听地址：添加中继服务器地址
  格式：relay://<服务器IP或域名>:22067/?id=<Device ID>
  示例：relay://syncthing-relay.example.com:22067/?id=ITZRNXE-YNROGBZ-HXTH5P7-VK5NYE5-QHRQGE2-7JQ6VNJ-KZUEDIU-5PPR5AM

• 全球发现服务器：添加私有发现服务器（若启用）
  格式：https://<服务器IP或域名>:8443/?id=<Device ID>
  示例：https://syncthing-disco.example.com:8443/?id=ITZRNXE-YNROGBZ-HXTH5P7-VK5NYE5-QHRQGE2-7JQ6VNJ-KZUEDIU-5PPR5AM

• 连接选项：勾选「启用中继」，按需启用「本地发现」（局域网环境）。

2. 远程设备高级配置

针对特定远程设备，进入 远程设备 → 选择设备 → 编辑 → 高级 → 地址列表：

• 添加中继服务器地址，格式同上：
  relay://syncthing-relay.example.com:22067/?id=ITZRNXE-YNROGBZ-HXTH5P7-VK5NYE5-QHRQGE2-7JQ6VNJ-KZUEDIU-5PPR5AM

参考与致谢

项目链接

• GitHub 源码：https://github.com/gshang2017/docker
• 基于 Syncthing 官方项目：https://github.com/syncthing

官方文档

• Syncthing 中继服务器文档：[***]
• Syncthing 发现服务器文档：[***]
• Syncthing 客户端使用指南：[***]