jdfalk/sabnzbd

linuxserver/sabnzbd

LinuxServer.io团队提供的此容器镜像具有简单的用户映射和社区支持特性。如需支持，可通过以下途径获取：

• 论坛
• IRC（freenode网络，频道#linuxserver.io）
• 播客（涵盖Linux服务器使用技巧及Docker容器化相关内容）

镜像概述和主要用途

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

核心功能和特性

• 全流程自动化：自动处理.nzb文件的下载、验证、修复、提取和归档
• Web界面访问：支持HTTP（8080端口）和HTTPS（9090端口）访问管理界面
• 权限控制：通过PUID和PGID参数实现用户/组权限映射，避免主机与容器间的权限问题
• 时区配置：支持通过TZ环境变量设置时区信息
• 版本分支选择：提供稳定版（默认）和unstable开发分支

使用场景和适用范围

适用于需要通过Usenet获取文件的用户，尤其是希望减少人工操作、实现下载流程自动化的场景，如媒体文件（电影、音乐）、软件等内容的批量下载管理。

使用方法和配置说明

Docker命令部署示例

bash
docker create --name=sabnzbd \
-v <数据路径>:/config \
-v <下载路径>:/downloads \
-v <临时下载路径>:/incomplete-downloads \
-e PGID=<组ID> -e PUID=<用户ID> \
-e TZ=<时区> \
-p 8080:8080 -p 9090:9090 \
linuxserver/sabnzbd

标签（Tags）

可通过标签选择使用unstable开发分支，稳定版为默认无需标签（稳定版/最新版分支绝不会包含alpha/beta/rc版本）。如需使用unstable分支，在镜像名称后添加标签：

linuxserver/sabnzbd:unstable

参数说明

参数格式为主机端:容器端，左侧代表主机配置，右侧代表容器内部配置。例如端口映射-p 外部端口:内部端口，表示将容器内端口映射到主机端口。

• -p 8080 - Web界面HTTP端口
• -p 9090 - Web界面HTTPS端口（需在Web界面中启用）
• -v /config - SABnzbd配置文件的本地路径
• -v /downloads - 已完成下载文件的本地路径
• -v /incomplete-downloads - 临时下载文件的本地路径（可选）
• -e PGID - 组ID，用于权限映射（见下文说明）
• -e PUID - 用户ID，用于权限映射（见下文说明）
• -e TZ - 时区设置，例如Europe/London

该镜像基于Ubuntu Xenial，使用s6 overlay。如需在容器运行时访问shell，执行docker exec -it sabnzbd /bin/bash。

用户/组标识符（PUID/PGID）

使用数据卷（-v参数）时，主机与容器可能出现权限问题。通过指定PUID（用户ID）和PGID（组ID）可避免此问题。确保主机数据卷目录的所有者与指定的PUID/PGID一致即可正常工作。

获取当前用户的PUID和PGID：

bash
$ id <用户名>
  uid=1001(用户名) gid=1001(组名) groups=1001(组名)

应用设置

初始设置通过HTTP端口完成。HTTPS访问需在初始设置向导或Web界面的配置中启用，并确保使用9090端口。有关SABnzbd的配置参数说明，可参考SABnzbd官方文档。

信息查看

• 容器运行时访问shell：docker exec -it sabnzbd /bin/bash
• 实时查看容器日志：docker logs -f sabnzbd
• 查看容器版本号：

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

• 查看镜像版本号：

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

版本历史

• 13.12.17：修复续行问题
• 12.07.17：添加README中的检查命令，迁移至Jenkins构建和推送
• 10.04.17：更新至2.0正式版
• 25.02.17：切换至nobetas仓库作为master/latest分支，并添加unstable分支
• 08.02.17：添加pythonioenconding=utf8环境变量
• 15.09.16：根据SABnzbd Git README编译par2多核版本
• 11.09.16：更新至1.10正式版
• 09.09.16：重新基于Xenial构建（Alpine版本的Python与SAB 1.10分支存在兼容性问题）
• 28.08.16：基于Alpine重构，使用SABnzbd Git版本
• 17.03.16：启动时安装1.0正式版
• 14.03.16：刷新镜像以获取最新RC版本
• 23.01.15：刷新镜像
• 14.12.15：刷新镜像以获取最新测试版
• 21.08.15：初始发布