robertbeal/syncthing

Syncthing镜像

镜像概述

这是一个生产优化的Syncthing镜像，基于Alpine构建，支持多架构，可在只读模式下运行，并通过su-exec工具管理运行用户，确保安全性与灵活性。

核心功能

1. 生产优化：针对生产环境进行性能与稳定性优化
2. 多架构支持：适配多种硬件架构设备
3. 只读模式：支持以只读模式运行，降低安全风险
4. 灵活用户管理：提供多种用户身份管理方式，适配不同部署场景

使用场景

• 个人设备间的文件同步（如电脑、手机、服务器）
• 团队内部的文档共享与协作
• 跨平台的数据备份与同步

配置说明

只读模式运行

镜像使用用户syncthing:770，以下是几种运行方式：

方式1：创建匹配UID的主机用户

bash
sudo useradd --no-create-home --system --shell /bin/false --uid 770 foo
docker run \
    --name syncthing \
    --init \
    --user $(id foo -u):$(id foo -g) \
    --rm \
    --read-only \
    --security-opt="no-new-privileges:true" \
    --net=host \
    --health-cmd="curl --fail -H \"X-API-Key: $(cat /root/syncthing-api-key)\" http://127.0.0.1:8384/rest/system/ping || exit 1" \
    --health-interval=30s \
    --health-retries=3 \
    -v /home/syncthing/config:/config \
    -v /home/syncthing/data:/data \
    -p 127.0.0.1:8384:8384 \
    -p 22000:22000 \
    -p 21027:21027/udp \
    robertbeal/syncthing

方式2：挂载/etc/passwd并创建同名主机用户

bash
sudo useradd --no-create-home --system --shell /bin/false syncthing
docker run \
    --name syncthing \
    --init \
    --rm \
    --read-only \
    --security-opt="no-new-privileges:true" \
    --net=host \
    --health-cmd="curl --fail -H \"X-API-Key: $(cat /root/syncthing-api-key)\" http://127.0.0.1:8384/rest/system/ping || exit 1" \
    --health-interval=30s \
    --health-retries=3 \
    -v /etc/passwd:/etc/passwd:ro \
    -v /home/syncthing/config:/config \
    -v /home/syncthing/data:/data \
    -p 127.0.0.1:8384:8384 \
    -p 22000:22000 \
    -p 21027:21027/udp \
    robertbeal/syncthing

可写模式运行

可通过环境变量定义UID和GID，但无法使用只读模式：

bash
docker run \
    --name syncthing \
    --init \
    --rm \
    --security-opt="no-new-privileges:true" \
    --net=host \
    --health-cmd="curl --fail -H \"X-API-Key: $(cat /root/syncthing-api-key)\" http://127.0.0.1:8384/rest/system/ping || exit 1" \
    --health-interval=30s \
    --health-retries=3 \
    -e PUID=$(id -u) \
    -e PGID=$(id -g) \
    -v /home/syncthing/config:/config \
    -v /home/syncthing/data:/data \
    -p 127.0.0.1:8384:8384 \
    -p 22000:22000 \
    -p 21027:21027/udp \
    robertbeal/syncthing

测试方法

bash
pip install --user --upgrade pip pipenv
pipenv install -d
pipenv run pytest -v