syncthing-relay-discovery Docker镜像

镜像概述和主要用途

这是Syncthing项目的全局中继和发现服务器Docker容器，用于搭建私有Syncthing“云”环境。基于Debian最新版构建，自动跟踪Syncthing中继服务器（relaysrv）和发现服务器（discosrv）的上游代码更新，确保安装最新成功构建的版本。

核心功能和特性

• 基于debian:latest构建，确保基础系统最新
• 自动拉取并安装Syncthing中继和发现服务器的最新成功构建版本
• 支持证书持久化存储，保障安全通信
• 通过环境变量灵活配置服务器参数（速率限制、端口、调试模式等）
• 支持Docker Compose部署，简化管理
• 可配置为私有中继或加入公共中继池

使用场景和适用范围

适用于希望搭建私有Syncthing“云”的用户，为Syncthing设备提供中继和发现服务，解决NAT穿透问题，适用于个人或小型团队的私有Syncthing基础设施构建。

使用方法和配置说明

基本使用

启动容器的基本命令：

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

证书持久化配置

证书和数据默认存储在/home/syncthing/，建议将证书目录挂载为持久卷：

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

若使用已生成的证书并设置为只读：

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

证书目录权限设置

容器进程需要访问证书目录，创建并配置权限：

bash
mkdir -p /your/home/certs
chown -R 1000:1000 /your/home/certs

Docker Compose部署

yaml
---
version: '3'

services:
  syncthing-relay-discovery:
    container_name: syncthing-relay-discovery
    restart: always
    image: t4skforce/syncthing-relay-discovery:latest
    environment:
      RELAY_OPTS: '-debug'
      DISCO_OPTS: '-debug'
    ports:
      - 22067:22067  # 中继服务器端口
      - 22026:22026  # 发现服务器端口

容器配置参数

通用配置

• DEBUG: 启用调试模式，可选值true/false，默认false

Syncthing中继服务器配置

• RATE_GLOBAL: 全局最大传输速率（字节/秒），默认***（10Mbps）
• RATE_SESSION: 每会话最大传输速率（字节/秒），默认5000（500Kbps）
• TIMEOUT_MSG: 消息超时时间，默认1m45s
• TIMEOUT_NET: 网络超时时间，默认3m30s
• PING_INT: ping间隔时间，默认1m15s
• PROVIDED_BY: 提供者标识字符串，默认"syncthing-relay"
• RELAY_PORT: 中继服务器监听端口，默认22067
• STATUS_PORT: 状态页面端口，默认22070（需手动添加端口映射）
• POOLS: 中继池地址，私有中继留空，公共中继使用"[***]"，默认""
• RELAY_OPTS: 额外中继服务器选项，默认""
  示例：-e RELAY_OPTS='-ext-address=:443'（指定外部地址）

Syncthing发现服务器配置

• DISCO_PORT: 发现服务器监听端口，默认22026
• DISCO_OPTS: 额外发现服务器选项，默认""
  示例：-e DISCO_OPTS='-metrics-listen=:***'（指定指标监听地址）

更多配置细节参考上游文档：relaysrv 和 discosrv