syncthing-discosrv Docker镜像

镜像概述和主要用途

syncthing-discosrv是Syncthing项目的全局发现服务器Docker容器。由于官方镜像已几乎停止更新（撰写时最后构建距今一年），本镜像跟踪发现服务器GitHub仓库的代码变更，确保在有代码更新时自动构建最新版本。该容器适用于希望搭建自己的私有Syncthing“云”的用户。

容器相关文件可在GitHub仓库获取。

核心功能和特性

• 基于ubuntu:latest构建，安装最新成功构建的Syncthing发现服务器
• 自动跟踪官方发现服务器项目代码更新，保持版本最新
• 支持证书持久化存储，确保服务重启后证书不丢失
• 提供完整的自动启动和自动升级方案，简化运维

使用场景和适用范围

适用于需要搭建私有Syncthing发现服务的用户，解决官方镜像过时问题，确保Syncthing设备间的发现功能稳定可靠，尤其适合企业或个人搭建独立的Syncthing同步网络。

详细使用方法和配置说明

基本使用

通过以下命令运行容器：

docker run --name syncthing-discovery -d -p 22026:22026 --restart=always t4skforce/syncthing-discovery:latest

证书和所有数据默认存储在/home/discosrv/目录。推荐将证书目录挂载为持久化卷：

docker run --name syncthing-discovery -d -p 22026:22026 -v /your/home:/home/discosrv/certs --restart=always t4skforce/syncthing-discovery:latest

使用现有证书（只读模式）

若已生成证书并希望保护目录不被容器修改，使用只读挂载：

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

创建证书目录并设置权限

容器进程需要访问证书目录，执行以下命令创建并授权：

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

升级

按照以下步骤升级容器：

# 下载更新
docker pull t4skforce/syncthing-discovery:latest
# 停止当前运行的镜像
docker stop syncthing-discovery
# 删除容器
docker rm syncthing-discovery
# 使用新基础镜像启动
docker run --name syncthing-discovery -d -p 22026:22026 -v /your/home:/home/discosrv/certs:ro --restart=always t4skforce/syncthing-discovery:latest
# 清理无用镜像
docker rmi -f $(docker images | grep "<none>" | awk "{print \$3}") > /dev/null 2>&1

自动启动

通过systemd实现系统启动时自动运行服务。创建服务文件/lib/systemd/system/syncthing-discovery.service：

[Unit]
Description=Syncthing发现服务器
Requires=docker.service
After=docker.service

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

[Install]
WantedBy=multi-user.target

手动启动服务并检查状态：

systemctl start syncthing-discovery
systemctl status syncthing-discovery

设置开机自启：

systemctl enable syncthing-discovery

自动升级

结合自动启动功能，通过脚本和定时任务实现容器自动升级。

1. 创建升级脚本

创建/root/syncthing-discovery_upgrade.sh：

#!/bin/bash

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

# 下载更新
docker pull t4skforce/syncthing-discovery:latest
# 停止服务
systemctl stop syncthing-discovery
# 删除容器
docker rm syncthing-discovery
# 启动新容器
docker run --name syncthing-discovery -d -p 22026:22026 -v ${CERT_HOME}:/home/discosrv/certs:ro --restart=always t4skforce/syncthing-discovery:latest
# 停止容器（通过服务启动）
docker stop syncthing-discovery
# 通过服务启动
systemctl start syncthing-discovery
# 清理无用镜像
docker rmi -f $(docker images | grep "<none>" | awk "{print \$3}") > /dev/null 2>&1

2. 设置脚本可执行

chmod +x /root/syncthing-discovery_upgrade.sh

3. 配置定时任务

编辑/etc/crontab，添加每周日午夜执行升级：

# /etc/crontab: 系统级定时任务
# 无需运行`crontab`命令即可生效，与其他crontab不同，包含用户名字段

SHELL=/bin/sh
PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin

# m h dom mon dow user  command
17 *    * * *   root    cd / && run-parts --report /etc/cron.hourly
25 6    * * *   root    test -x /usr/sbin/anacron || ( cd / && run-parts --report /etc/cron.daily )
47 6    * * 7   root    test -x /usr/sbin/anacron || ( cd / && run-parts --report /etc/cron.weekly )
52 6    1 * *   root    test -x /usr/sbin/anacron || ( cd / && run-parts --report /etc/cron.monthly )
# Syncthing发现服务器Docker容器自动升级
0  0    * * 7   root    /root/syncthing-discovery_upgrade.sh