t4skforce/syncthing-discovery

syncthing-discosrv Docker镜像

镜像概述和主要用途

syncthing-discosrv是Syncthing项目的全局发现服务器Docker容器。由于官方镜像已几乎停止更新（撰写时最后构建距今一年），本镜像跟踪https://github.com/syncthing/discosrv%E7%9A%84%E4%BB%A3%E7%A0%81%E5%8F%98%E6%9B%B4%EF%BC%8C%E7%A1%AE%E4%BF%9D%E5%9C%A8%E6%9C%89%E4%BB%A3%E7%A0%81%E6%9B%B4%E6%96%B0%E6%97%B6%E8%87%AA%E5%8A%A8%E6%9E%84%E5%BB%BA%E6%9C%80%E6%96%B0%E7%89%88%E6%9C%AC%E3%80%82%E8%AF%A5%E5%AE%B9%E5%99%A8%E9%80%82%E7%94%A8%E4%BA%8E%E5%B8%8C%E6%9C%9B%E6%90%AD%E5%BB%BA%E8%87%AA%E5%B7%B1%E7%9A%84%E7%A7%81%E6%9C%89Syncthing%E2%80%9C%E4%BA%91%E2%80%9D%E7%9A%84%E7%94%A8%E6%88%B7%E3%80%82

容器相关文件可在https://github.com/t4skforce/syncthing-discovery%E8%8E%B7%E5%8F%96%E3%80%82

核心功能和特性

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

使用场景和适用范围

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

详细使用方法和配置说明

基本使用

通过以下命令运行容器：

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

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

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

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

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

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

创建证书目录并设置权限

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

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

升级

按照以下步骤升级容器：

bash
# 下载更新
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：

ini
[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

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

bash
systemctl start syncthing-discovery
systemctl status syncthing-discovery

设置开机自启：

bash
systemctl enable syncthing-discovery

自动升级

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

1. 创建升级脚本

创建/root/syncthing-discovery_upgrade.sh：

bash
#!/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. 设置脚本可执行

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

3. 配置定时任务

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

bash
# /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