linuxserver/sabnzbd

Sabnzbd 旨在通过自动化尽可能多的流程，使Usenet使用变得简单流畅。用户只需添加.nzb文件，Sabnzbd将自动完成下载、验证、修复、提取和归档，全程无需人工干预。

!sabnzbd

支持的架构

本镜像利用Docker清单实现多平台支持。直接拉取 lscr.io/linuxserver/sabnzbd:latest 即可获取对应架构的正确镜像，也可通过标签拉取特定架构镜像。

支持的架构：

版本标签

本镜像提供多种版本标签，使用时请仔细阅读描述，使用不稳定或开发标签时需谨慎。

应用设置

初始设置通过 http://<docker主机IP>:<映射的HTTP端口> 访问，例如 [***]

更多信息请参见 Sabnzbd wiki。

nzb-notify

nzb-notify作为便捷脚本包含在本镜像中。使用时，在文件夹设置中将“脚本文件夹”设为 /app/nzbnotify，然后在“通知”中配置。详见 nzb-notify。

下载文件夹

在Sabnzbd图形界面设置的“文件夹”选项中，建议将“完成下载文件夹”设为 /downloads，“临时下载文件夹”设为 /incomplete-downloads。

这两个路径为可选挂载，便于快速上手，但可能失去硬链接（同一文件在同一文件系统中多位置存在但仅占用一份空间）或原子移动（即时文件移动而非复制+删除）的能力。若无需这些功能，可使用可选路径；如需了解更多，参见 Servarr文档。

使用方法

以下提供docker-compose和docker cli两种使用方式帮助创建容器。

docker-compose（推荐，更多信息）

yaml
---
version: "2.1"
services:
  sabnzbd:
    image: lscr.io/linuxserver/sabnzbd:latest
    container_name: sabnzbd
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
    volumes:
      - /path/to/data:/config
      - /path/to/downloads:/downloads #可选
      - /path/to/incomplete/downloads:/incomplete-downloads #可选
    ports:
      - 8080:8080
    restart: unless-stopped

docker cli（更多信息）

bash
docker run -d \
  --name=sabnzbd \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -p 8080:8080 \
  -v /path/to/data:/config \
  -v /path/to/downloads:/downloads `#可选` \
  -v /path/to/incomplete/downloads:/incomplete-downloads `#可选` \
  --restart unless-stopped \
  lscr.io/linuxserver/sabnzbd:latest

参数

容器通过运行时参数配置，格式为 <外部>:<内部>。例如 -p 8080:80 表示将容器内80端口映射到主机8080端口。

环境变量从文件（Docker secrets）

可通过特殊前缀 FILE__ 从文件设置环境变量。例如：

bash
-e FILE__MYVAR=/run/secrets/mysecretvariable

这将根据 /run/secrets/mysecretvariable 文件内容设置 MYVAR 环境变量。

应用运行的Umask设置

所有镜像支持通过可选参数 -e UMASK=022 覆盖默认umask设置。注意umask是权限掩码（减法操作），而非直接设置权限，详见 umask说明。

用户/组标识符

使用卷（-v参数）时，主机与容器可能出现权限问题。通过指定用户PUID和组PGID可避免此问题。确保主机卷目录归属于指定用户，权限问题将迎刃而解。

示例中使用 PUID=1000 和 PGID=1000，可通过以下命令获取当前用户的PUID和PGID：

bash
id your_user

输出示例：

text
uid=1000(your_user) gid=1000(your_user) groups=1000(your_user)

Docker Mods

我们提供多种 Docker Mods 以扩展容器功能。上述徽章链接可查看本镜像及通用Mods。

支持信息

• 容器运行时Shell访问：

  bash
  docker exec -it sabnzbd /bin/bash
  

• 实时监控容器日志：

  bash
  docker logs -f sabnzbd
  

• 容器版本号：

  bash
  docker inspect -f '{{ index .Config.Labels "build_version" }}' sabnzbd
  

• 镜像版本号：

  bash
  docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/sabnzbd:latest
  

更新信息

多数镜像为静态版本化，需更新镜像并重建容器以更新应用（部分例外如nextcloud、plex）。不建议在容器内更新应用，详见 应用设置。

通过Docker Compose更新

• 更新镜像：

  • 所有镜像：

    bash
    docker-compose pull
    

  • 单个镜像：

    bash
    docker-compose pull sabnzbd
    

• 更新容器：

  • 所有容器：

    bash
    docker-compose up -d
    

  • 单个容器：

    bash
    docker-compose up -d sabnzbd
    

• 清理旧镜像：

  bash
  docker image prune
  

通过Docker Run更新

• 更新镜像：

  bash
  docker pull lscr.io/linuxserver/sabnzbd:latest
  

• 停止运行中的容器：

  bash
  docker stop sabnzbd
  

• 删除容器：

  bash
  docker rm sabnzbd
  

• 使用上述docker run参数重建容器（若卷映射正确，/config文件夹及设置将保留）

• 清理旧镜像：

  bash
  docker image prune
  

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

• 拉取最新镜像并使用相同环境变量重建容器：

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

• 清理旧镜像：docker image prune

警告：不推荐使用Watchtower自动更新容器，建议使用 Docker Compose。

镜像更新通知 - Diun（Docker Image Update Notifier）

提示：推荐使用 Diun 获取更新通知，不建议使用自动更新容器的工具。

本地构建

如需本地修改或开发，可执行以下命令构建镜像：

bash
git clone [***]
cd docker-sabnzbd
docker build \
  --no-cache \
  --pull \
  -t lscr.io/linuxserver/sabnzbd:latest .

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

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

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

版本历史

• 23.11.23: - 构建翻译文件。
• 13.09.23: - 使用par2cmdline-turbo替代par2cmdline。
• 16.08.23: - 从 linuxserver仓库 安装unrar。
• 10.08.23: - 升级unrar至6.2.10。
• 16.05.23: - 将稳定版基底更新为Alpine 3.18，弃用armhf架构。
• 15.03.23: - 从p7zip切换到7zip，升级unrar至6.2.6。
• 05.03.23: - 将主分支基底更新为Alpine 3.17。
• 03.10.22: - 将主分支基底更新为Alpine 3.16，迁移至s6v3。
• 12.08.22: - 升级unrar至6.1.7。
• 31.07.22: - 添加nightly标签。
• 10.03.22: - 集成nzb-notify。
• 22.02.22: - 将主分支基底更新为Alpine，从源码构建unrar，弃用Alpine分支。
• 25.01.22: - 将Unstable分支基底更新为Alpine。
• 13.01.22: - 添加alpine分支。
• 08.08.21: - 升级至focal，不强制绑定IPv4端口8080。
• 24.07.21: - 添加python3-setuptools。
• 14.05.21: - 使用linuxserver.io的wheel索引安装pip包。
• 12.02.21: - 清理rust/cargo和pip缓存。
• 17.08.20: - 使用python3从源码运行，移除python2，将python符号链接至python3。
• 02.01.20: - 过渡期在镜像中同时添加python3和python2。
• 23.03.19: - 切换至新基底镜像，迁移至arm32v7标签。
• 25.02.19: - 基底更新为Bionic，添加脚本所需的python依赖。
• 26.01.19: - 添加流水线逻辑和多架构支持。
• 13.12.17: - 修复续行符。
• 12.07.17: - 添加检查命令至README，迁移至jenkins构建推送。
• 10.04.17: - 升级至2.0版本。
• 25.02.17: - 将master/latest分支切换至nobetas仓库，添加unstable分支。
• 08.02.17: - 添加pythonioenconding=utf8环境变量。
• 15.09.16: - 根据Sabnzbd git 文档 编译多核par2。
• 11.09.16: - 升级至1.10版本。
• 09.09.16: - 基底回退至xenial，解决Alpine版本python与Sab 1.10分支的兼容性问题。
• 28.08.16: - 基底更新为Alpine，使用Sab的git版本。
• 17.03.16: - 启动时安装1.0正式版。
• 14.03.16: - 刷新镜像以获取最新RC版本。
• 23.01.15: - 刷新镜像。
• 14.12.15: - 刷新镜像以获取最新测试版。
• 21.08.15: - 初始发布。