syncarr/syncarr

Syncarr

镜像概述和主要用途

Syncarr是一款通过Web API同步两个Radarr/Sonarr/Lidarr服务器的工具。主要用于维护不同配置的媒体服务器实例（如4k和1080p分辨率的Radarr/Sonarr），确保内容在实例间保持同步。支持单向或双向同步，并可通过多种过滤条件控制同步内容。

核心功能和特性

• 支持Radarr/Sonarr v3版本
• 可按profile名称或profile_id同步内容
• 通过profile名称或profile_id过滤同步媒体
• 支持Docker部署，可运行多个实例
• 可设置同步间隔时间
• 默认单向同步，支持双向同步配置
• 跳过缺失文件的内容
• 可设置语言配置文件（Sonarr）
• 支持按内容文件质量过滤（仅Radarr）
• 支持按标签过滤（Sonarr/Radarr）
• 提供test_run测试模式（执行同步流程但不实际同步）

使用场景和适用范围

• 需要维护不同分辨率（如4k和1080p）媒体库的用户
• 希望在主从服务器间保持内容同步的场景
• 需要按特定配置文件、标签或质量筛选同步内容的需求
• 希望自动化同步流程，减少手动操作的媒体服务器管理员

详细配置说明

配置文件设置

1. 编辑config.conf文件，输入两个服务器的URL和API密钥
2. 为目标服务器添加profile名称（不区分大小写）和媒体路径

Radarr实例同步示例

ini
[radarrA]
url = https://4k.example.com:443
key = XXXXX

[radarrB]
url = http://127.0.0.1:8080
key = XXXXX
profile = 1080p
path = /data/Movies  # 若未指定，将使用radarrA的路径（可能不符合预期）

Sonarr实例同步示例

ini
[sonarrA]
url = https://4k.example.com:443
key = XXXXX

[sonarrB]
url = http://127.0.0.1:8080
key = XXXXX
profile = 1080p
path = /data/Shows

Lidarr实例同步示例

ini
[lidarrA]
url = https://lossless.example.com:443
key = XXXXX

[lidarrB]
url = http://127.0.0.1:8080
key = XXXXX
profile = Standard
path = /data/Music

注意：不能同时混合配置Radarr、Lidarr和Sonarr实例

可选配置参数

ini
[*arrA]
url = http://127.0.0.1:8080
key = XXXXX
profile_filter = 1080p  # 仅同步属于此配置文件的内容（也可通过profile_filter_id设置）
quality_match = HD-  # （仅Radarr）正则匹配，仅同步符合质量的内容（如1080p）
tag_filter = Horror  # （Sonarr/Radarr）按标签名称同步（多标签用逗号分隔，无空格）
tag_filter_id = 2  # （Sonarr/Radarr）按标签ID同步（多ID用逗号分隔，无空格）
blacklist = movie-name-12,movie-name-43  # 从不同步的内容slug或ID列表（逗号分隔，无空格）
             # slug是URL中"/movies/"、"/series/"或"/artist/"后的部分

[*arrB]
url = http://127.0.0.1:8080
key = XXXXX
profile_id = 1  # 直接指定配置文件ID（优先于名称）
language = Vietnamese  # 新添加内容的语言（Sonarr，也可通过language_id设置）
path = /data/Movies

[general]
sync_bidirectionally = 1  # 双向同步（A→B和B→A，默认0）
auto_search = 0  # 自动搜索新内容（默认1，设为0禁用）
skip_missing = 1  # 跳过缺失文件的内容（仅Radarr，默认1）
monitor_new_content = 0  # 是否监控同步的新内容（默认1，设为0不监控）
test_run = 1  # 测试模式（执行流程但不实际同步，默认0）
sync_monitor = 1  # 同步内容的监控状态（默认0）

注意：若sync_bidirectionally设为1，实例A也需要指定profile_id或profile及path

Docker部署示例

Docker Compose配置

Radarr同步示例

yaml
syncarr:
    image: syncarr/syncarr:latest
    container_name: syncarr
    restart: unless-stopped
    environment:
        RADARR_A_URL: https://4k.example.com:443
        RADARR_A_KEY: XXXXX
        RADARR_B_URL: http://127.0.0.1:8080
        RADARR_B_KEY: XXXXX
        RADARR_B_PROFILE: 1080p
        RADARR_B_PATH: /data/Movies
        SYNC_INTERVAL_SECONDS: 300  # 同步间隔（秒）

Sonarr同步示例

yaml
syncarr:
    image: syncarr/syncarr:latest
    container_name: syncarr
    restart: unless-stopped
    environment:
        SONARR_A_URL: https://4k.example.com:443
        SONARR_A_KEY: XXXXX
        SONARR_B_URL: http://127.0.0.1:8080
        SONARR_B_KEY: XXXXX
        SONARR_B_PROFILE: 1080p
        SONARR_B_PATH: /data/Shows
        SYNC_INTERVAL_SECONDS: 300

Lidarr同步示例

yaml
syncarr:
    image: syncarr/syncarr:latest
    container_name: syncarr
    restart: unless-stopped
    environment:
        LIDARR_A_URL: https://lossless.example.com:443
        LIDARR_A_KEY: XXXXX
        LIDARR_B_URL: http://127.0.0.1:8080
        LIDARR_B_KEY: XXXXX
        LIDARR_B_PROFILE: Standard
        LIDARR_B_PATH: /data/Music
        SYNC_INTERVAL_SECONDS: 300

Docker Run命令（Radarr示例）

bash
docker run -it --rm --name syncarr \
    -e RADARR_A_URL=https://4k.example.com:443 \
    -e RADARR_A_KEY=XXXXX \
    -e RADARR_B_URL=http://127.0.0.1:8080 \
    -e RADARR_B_KEY=XXXXX \
    -e RADARR_B_PROFILE=1080p \
    -e RADARR_B_PATH=/data/Movies \
    -e SYNC_INTERVAL_SECONDS=300 \
    syncarr/syncarr

环境变量说明

• *ARR_A_PROFILE_ID/*ARR_B_PROFILE_ID: 直接指定配置文件ID
• *ARR_A_PROFILE_FILTER/*ARR_B_PROFILE_FILTER: 按配置文件名称过滤
• *ARR_A_PROFILE_FILTER_ID/*ARR_B_PROFILE_FILTER_ID: 按配置文件ID过滤
• SONARR_B_LANGUAGE/SONARR_B_LANGUAGE_ID: 设置Sonarr新内容的语言
• SYNCARR_BIDIRECTIONAL_SYNC=1: 启用双向同步（默认0）
• SYNCARR_AUTO_SEARCH=0: 禁用自动搜索新内容（默认1）
• SYNCARR_MONITOR_NEW_CONTENT=0: 不监控同步的新内容（默认1）
• *ARR_A_QUALITY_MATCH/*ARR_B_QUALITY_MATCH: 按质量正则匹配（仅Radarr）
• *ARR_A_TAG_FILTER/*ARR_B_TAG_FILTER: 按标签名称过滤
• *ARR_A_TAG_FILTER_ID/*ARR_B_TAG_FILTER_ID: 按标签ID过滤
• SYNCARR_TEST_RUN=1: 启用测试模式
• *ARR_A_BLACKLIST/*ARR_B_BLACKLIST: 内容黑名单（slug或ID，逗号分隔）
• SYNCARR_SYNC_MONITOR=1: 同步内容的监控状态
• LOG_LEVEL=10: 设置日志级别（默认20，10为调试模式）

故障排除

如需排查问题，可通过配置文件或环境变量设置日志级别：

• 配置文件方式：

  ini
  [general]
  log_level = 10  # 10为调试模式，20为仅信息（默认）
  

• Docker环境变量方式：设置LOG_LEVEL=10

注意：在线分享调试日志时，请移除API密钥及其他敏感信息。

免责声明

使用前请备份服务器数据。作者不对任何数据丢失负责。