wetpaint/sabnzbd Docker镜像文档

镜像概述和主要用途

wetpaint/sabnzbd是基于linuxserver/docker-sabnzbd修改的Docker镜像，主要用于支持NZBtoMedia后处理脚本。该镜像集成了SABnzbd 3.5.1版本，提供Usenet下载自动化解决方案，可实现从添加.nzb文件到下载、验证、修复、提取及归档的全流程自动化处理，无需人工干预。

核心功能和特性

基于原版的增强

• 版本更新：集成SABnzbd 3.5.1版本，包含最新功能及修复
• 依赖补充：预装ffmpeg和git，满足媒体处理及脚本管理需求
• 环境优化：设置环境语言为C.UTF-8，避免字符编码相关错误
• 脚本支持：增加对/scripts目录的访问权限，支持NZBtoMedia等后处理脚本

SABnzbd原生功能

• 自动化Usenet下载流程：解析.nzb文件、下载、验证完整性、修复损坏文件、提取压缩包
• 支持文件归档及分类管理，可自定义存储路径

使用场景和适用范围

适用于需要通过Usenet获取资源并进行自动化后处理的用户，例如：

• 媒体文件（电影、剧集、音乐）的自动化下载与整理
• 需要通过NZBtoMedia脚本实现复杂后处理（如格式转换、元数据匹配、媒体库同步）的场景
• 对下载流程自动化要求高，希望减少人工干预的个人或家庭媒体中心用户

使用方法和配置说明

基本部署命令（docker run）

bash
docker run -d \
  --name=sabnzbd \
  -v <本地配置路径>:/config \
  -v <本地下载路径>:/downloads \
  -v <本地临时下载路径>:/incomplete-downloads \
  -v <本地脚本路径>:/scripts \
  -e PGID=<组ID> \
  -e PUID=<用户ID> \
  -e TZ=<时区> \
  -p 8080:8080 \
  -p 9090:9090 \
  wetpaint/sabnzbd

docker-compose配置示例

yaml
version: '3'
services:
  sabnzbd:
    image: wetpaint/sabnzbd
    container_name: sabnzbd
    volumes:
      - /path/to/local/config:/config       # 本地配置文件存储路径
      - /path/to/local/downloads:/downloads # 完成下载文件存储路径
      - /path/to/local/incomplete:/incomplete-downloads # 临时下载文件路径（可选）
      - /path/to/local/scripts:/scripts     # 后处理脚本存放路径
    environment:
      - PGID=1001                          # 组ID，需与本地目录权限匹配
      - PUID=1001                          # 用户ID，需与本地目录权限匹配
      - TZ=Asia/Shanghai                   # 时区，如Asia/Shanghai
    ports:
      - "8080:8080"                        # HTTP WebUI端口
      - "9090:9090"                        # HTTPS WebUI端口
    restart: unless-stopped

参数说明

端口映射（-p）

• 8080:8080：SABnzbd WebUI的HTTP端口，用于初始配置及日常访问
• 9090:9090：SABnzbd WebUI的HTTPS端口（需在WebUI中手动启用，端口固定为9090）

数据卷映射（-v）

• /config：容器内配置文件目录，映射至本地路径以持久化配置（如服务器设置、下载规则）
• /downloads：容器内完成下载的文件存储目录，映射至本地路径用于获取下载结果
• /incomplete-downloads：容器内临时下载文件目录（可选，建议映射以避免容器重启导致临时文件丢失）
• /scripts：后处理脚本目录，映射至本地存放NZBtoMedia等脚本的路径

环境变量（-e）

• PGID：容器运行的组ID，需与本地数据卷目录的所属组ID一致（避免权限问题），可通过id <用户名>命令获取
• PUID：容器运行的用户ID，需与本地数据卷目录的所属用户ID一致（避免权限问题），可通过id <用户名>命令获取
• TZ：时区设置，格式为区域/城市，如Asia/Shanghai（上海）、Europe/London（伦敦）

应用设置

初始配置流程

1. 启动容器后，通过http://<主机IP>:8080访问WebUI
2. 在初始化向导中完成基本设置（如Usenet服务器信息、下载路径等）
3. 如需启用HTTPS访问，需在WebUI的“配置”→“一般”→“安全”中启用HTTPS，并设置端口为9090

用户/组ID获取方法

在主机终端执行id <用户名>（如id dockeruser），输出结果中的uid即为PUID，gid即为PGID：

bash
$ id dockeruser
uid=1001(dockeruser) gid=1001(dockergroup) groups=1001(dockergroup)

运维信息

容器管理命令

• 进入容器shell：docker exec -it sabnzbd /bin/bash（用于调试或手动执行脚本）
• 查看实时日志：docker logs -f sabnzbd（监控下载进度及错误信息）

版本信息

• 镜像版本：v03052019
• 集成SABnzbd版本：3.5.1