lsiodev/resilio-sync

linuxserver/resilio-sync

Resilio Sync（前身为BitTorrent Sync）利用BitTorrent协议在所有设备间同步文件和文件夹，支持免费和付费版本。此容器由LinuxServer.io团队维护，相比官方镜像增加了用户映射功能，简化卷权限管理。

支持的架构

该镜像利用Docker manifest实现多平台支持，拉取lscr.io/linuxserver/resilio-sync:latest即可自动获取对应架构的镜像，也可通过标签指定特定架构：

应用设置

• Web界面地址：<your-ip>:8888，用于账户创建和配置
• 更多设置信息请参考Resilio Sync官方文档

使用方法

docker-compose（推荐）

yaml
---
version: "2.1"
services:
  resilio-sync:
    image: lscr.io/linuxserver/resilio-sync:latest
    container_name: resilio-sync
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Europe/London
    volumes:
      - /path/to/config:/config
      - /path/to/downloads:/downloads
      - /path/to/data:/sync
    ports:
      - 8888:8888
      - 55555:55555
    restart: unless-stopped

docker cli

bash
docker run -d \
  --name=resilio-sync \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Europe/London \
  -p 8888:8888 \
  -p 55555:55555 \
  -v /path/to/config:/config \
  -v /path/to/downloads:/downloads \
  -v /path/to/data:/sync \
  --restart unless-stopped \
  lscr.io/linuxserver/resilio-sync:latest

参数说明

容器运行时通过参数进行配置，格式为<外部>:<内部>：

环境变量文件（Docker secrets）

可通过FILE__前缀从文件中设置环境变量，例如：

bash
-e FILE__PASSWORD=/run/secrets/mysecretpassword

上述命令会将PASSWORD环境变量设置为/run/secrets/mysecretpassword文件的内容。

应用运行的Umask设置

所有镜像支持通过-e UMASK=022覆盖默认umask设置。注意umask是权限掩码，通过减法而非加法调整权限，详情参考umask说明。

用户/组标识符

使用卷（-v标志）时，主机OS与容器可能出现权限问题。通过指定PUID（用户ID）和PGID（组ID）可避免此问题。确保主机上的卷目录归属于指定的用户和组。

获取当前用户的PUID和PGID：

bash
id username

示例输出：

uid=1000(dockeruser) gid=1000(dockergroup) groups=1000(dockergroup)

Docker Mods

https://img.shields.io/badge/dynamic/yaml?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=resilio-sync&query=%24.mods%5B%27resilio-sync%27%5D.mod_count&url=https%3A%2F%2Fraw.githubusercontent.com%2Flinuxserver%2Fdocker-mods%2Fmaster%2Fmod-list.yml]([] "查看此容器可用的mods") https://img.shields.io/badge/dynamic/yaml?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=universal&query=%24.mods%5B%27universal%27%5D.mod_count&url=https%3A%2F%2Fraw.githubusercontent.com%2Flinuxserver%2Fdocker-mods%2Fmaster%2Fmod-list.yml]([] "查看通用mods")

LinuxServer.io提供多种https://github.com/linuxserver/docker-mods%E4%BB%A5%E6%89%A9%E5%B1%95%E5%AE%B9%E5%99%A8%E5%8A%9F%E8%83%BD%EF%BC%8C%E4%B8%8A%E8%BF%B0%E5%BE%BD%E7%AB%A0%E9%93%BE%E6%8E%A5%E5%8F%AF%E6%9F%A5%E7%9C%8B%E6%AD%A4%E9%95%9C%E5%83%8F%E4%B8%93%E7%94%A8%E5%8F%8A%E9%80%9A%E7%94%A8%E7%9A%84mods%E3%80%82

支持信息

• 容器运行时Shell访问：docker exec -it resilio-sync /bin/bash
• 实时查看容器日志：docker logs -f resilio-sync
• 容器版本号：docker inspect -f '{{ index .Config.Labels "build_version" }}' resilio-sync
• 镜像版本号：docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/resilio-sync:latest

更新信息

大多数镜像为静态版本，需更新镜像并重建容器以更新应用。以下是更新容器的方法：

通过Docker Compose

• 更新所有镜像：docker-compose pull
• 更新单个镜像：docker-compose pull resilio-sync
• 重建容器：docker-compose up -d（或单个容器：docker-compose up -d resilio-sync）
• 清理旧镜像：docker image prune

通过Docker Run

• 更新镜像：docker pull lscr.io/linuxserver/resilio-sync:latest
• 停止容器：docker stop resilio-sync
• 删除容器：docker rm resilio-sync
• 使用相同参数重建容器（若卷映射正确，/config文件夹及设置将保留）
• 清理旧镜像：docker image prune

通过Watchtower自动更新（仅用于忘记原始参数时）

bash
docker run --rm \
-v /var/run/docker.sock:/var/run/docker.sock \
containrrr/watchtower \
--run-once resilio-sync

注意：不推荐使用Watchtower作为自动化更新工具，长期建议使用Docker Compose。

镜像更新通知 - Diun

推荐使用Diun接收更新通知，不建议使用自动更新容器的工具。

本地构建

如需本地修改或定制镜像：

bash
git clone https://github.com/linuxserver/docker-resilio-sync.git
cd docker-resilio-sync
docker build \
  --no-cache \
  --pull \
  -t lscr.io/linuxserver/resilio-sync:latest .

在x86_64硬件上构建ARM变体需使用multiarch/qemu-user-static：

bash
docker run --rm --privileged multiarch/qemu-user-static:register --reset

注册后使用-f Dockerfile.aarch64指定架构Dockerfile。

版本历史

• 03.10.21: 使用上游apt仓库安装，基于focal重建
• 20.01.21: 弃用UMASK_SET，改用基础镜像中的UMASK设置
• 23.03.19: 切换到新基础镜像，使用arm32v7标签
• 11.02.19: 基于bionic重建，添加流水线逻辑和多架构支持
• 05.02.18: 添加downloads卷挂载
• 28.01.18: 将/sync添加到目录白名单
• 26.01.18: 使用架构变量以适配armhf架构仓库
• 15.12.17: 修复续行符
• 02.06.17: 基于ubuntu xenial重建，alpine linux不再支持resilio
• 22.05.17: 添加用户定义umask变量
• 14.05.17: 使用固定版本而非latest，因2.5.0在非glibc系统（alpine）上存在问题
• 08.02.17: 基于alpine 3.5重建
• 02.11.16: 初始发布