t4skforce/syncthing-relay

syncthing-relaysrv

镜像概述和主要用途

syncthing-relaysrv是Syncthing项目的全局中继服务器Docker容器，用于搭建私有Syncthing“云”。本镜像基于debian:latest构建，会自动跟踪relaysrv代码仓库更新，确保使用最新构建版本。容器文件可在https://github.com/t4skforce/syncthing-relay%E8%8E%B7%E5%8F%96%E3%80%82

核心功能和特性

• 基于debian:latest构建，确保系统环境稳定
• 自动跟踪relaysrv代码更新，保持最新功能
• 支持证书持久化存储，可配置只读保护
• 丰富的环境变量配置选项，如传输速率限制、超时设置等
• 支持私有中继和公共中继模式切换
• 提供状态监控端口（默认禁用，可手动启用）

使用场景和适用范围

适用于需要搭建私有Syncthing中继服务的用户，解决设备间直接连接困难的问题，尤其适合：

• 企业内部文件同步网络
• 跨网络环境的设备连接
• 对数据隐私有较高要求的个人用户
• 需要自定义中继服务器配置的场景

详细使用方法和配置说明

基本使用

bash
docker run --name syncthing-relay -d -p 22067:22067 --restart=always t4skforce/syncthing-relay:latest

持久化证书存储（推荐）

bash
# 创建证书目录并设置权限
mkdir -p /your/home/certs
chown -R 1000:1000 /your/home/certs

# 运行容器并挂载证书目录
docker run --name syncthing-relay -d -p 22067:22067 -v /your/home:/home/relaysrv/certs --restart=always t4skforce/syncthing-relay:latest

使用现有证书（只读保护）

bash
docker run --name syncthing-relay -d -p 22067:22067 -v /your/home:/home/relaysrv/certs:ro --restart=always t4skforce/syncthing-relay:latest

容器配置

通过环境变量进行配置，支持以下选项：

配置示例：启用调试模式

bash
docker run --name syncthing-relay -d -p 22067:22067 -e DEBUG=true --restart=always t4skforce/syncthing-relay:latest

配置示例：自定义传输速率和外部地址

bash
docker run --name syncthing-relay -d -p 22067:22067 -p 22070:22070 \
  -e RATE_GLOBAL=6000000 -e RATE_SESSION=1000000 \
  -e RELAY_OPTS='-ext-address=:443' \
  -v /your/home:/home/relaysrv/certs:ro --restart=always t4skforce/syncthing-relay:latest

升级容器

bash
# 拉取最新镜像
docker pull t4skforce/syncthing-relay:latest

# 停止当前容器
docker stop syncthing-relay

# 删除容器
docker rm syncthing-relay

# 启动新容器（使用自定义配置）
docker run --name syncthing-relay -d -p 22067:22067 \
  -e RATE_GLOBAL=6000000 -e RATE_SESSION=1000000 \
  -v /your/home:/home/relaysrv/certs:ro --restart=always t4skforce/syncthing-relay:latest

# 清理无用镜像
docker rmi -f $(docker images | grep "<none>" | awk "{print \$3}") > /dev/null 2>&1

系统自动启动

创建systemd服务文件/lib/systemd/system/syncthing-relay.service：

ini
[Unit]
Description=Syncthing-relay-Server
Requires=docker.service
After=docker.service

[Service]
Restart=always
ExecStart=/usr/bin/docker start -a syncthing-relay
ExecStop=/usr/bin/docker stop -t 2 syncthing-relay

[Install]
WantedBy=multi-user.target

启用并启动服务：

bash
# 手动启动服务
systemctl start syncthing-relay

# 查看服务状态
systemctl status syncthing-relay -l

# 设置开机自启
systemctl enable syncthing-relay

自动升级配置

创建升级脚本/root/syncthing-relay_upgrade.sh：

bash
#!/bin/bash

# 证书目录
CERT_HOME="/your/home/certs"

# 拉取最新镜像
docker pull t4skforce/syncthing-relay:latest

# 停止服务
systemctl stop syncthing-relay

# 删除旧容器
docker rm syncthing-relay

# 启动新容器
docker run --name syncthing-relay -d -p 22067:22067 \
  -e RATE_GLOBAL=6000000 -e RATE_SESSION=1000000 \
  -v ${CERT_HOME}:/home/relaysrv/certs:ro --restart=always t4skforce/syncthing-relay:latest

# 停止容器
docker stop syncthing-relay

# 通过systemd启动
systemctl start syncthing-relay

# 清理无用镜像
docker rmi -f $(docker images | grep "<none>" | awk "{print \$3}") > /dev/null 2>&1

设置执行权限并测试：

bash
chmod +x /root/syncthing-relay_upgrade.sh
/root/syncthing-relay_upgrade.sh

配置定时任务（每周日午夜执行），编辑/etc/crontab添加：

bash
0 0 * * 7 root /root/syncthing-relay_upgrade.sh

参考链接

• Syncthing官方网站
• https://github.com/syncthing/relaysrv
• https://github.com/t4skforce/syncthing-relay
• https://hub.docker.com/r/t4skforce/syncthing-relay/