!NZBGet logo

NZBGet Docker 镜像文档

镜像概述和主要用途

NZBGet 是一款高效的开源 Usenet 软件，专为从 Usenet 新闻组下载二进制内容设计。本镜像基于 nzbgetcom/nzbget 仓库构建，提供便捷的容器化部署方案。

核心功能和特性

• 多架构支持：适配 x86-64、arm64、armhf 平台
• 灵活的版本管理：提供稳定版、开发版、调试版及特定版本标签
• 环境变量配置：支持通过环境变量自定义用户认证、时区等参数
• 持久化存储：通过卷挂载实现配置和下载文件的持久化
• 集成优化工具：内置 Python 3.11 及优化的 Unrar 7 解压工具，提升处理效率

使用场景和适用范围

• 个人或家庭 Usenet 内容下载管理
• 媒体服务器自动化内容获取流程
• 轻量级服务器环境下的高效下载任务处理
• 需要跨架构部署的 Usenet 客户端场景

详细使用方法和配置说明

支持的架构

版本标签

部署示例

Docker Compose（推荐）

---
services:
  nzbget:
    image: nzbgetcom/nzbget:latest
    container_name: nzbget
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Europe/London
      - NZBGET_USER=nzbget     # 可选
      - NZBGET_PASS=tegbzn6789 # 可选
    volumes:
      - /path/to/config:/config
      - /path/to/downloads:/downloads # 可选
    ports:
      - 6789:6789
    restart: unless-stopped

Docker CLI

docker run -d \
  --name=nzbget \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Europe/London \
  -e NZBGET_USER=nzbget `# 可选` \
  -e NZBGET_PASS=tegbzn6789 `# 可选` \
  -p 6789:6789 \
  -v /path/to/config:/config \
  -v /path/to/downloads:/downloads `# 可选` \
  --restart unless-stopped \
  nzbgetcom/nzbget:latest

环境变量配置

NZBGet 容器可通过环境变量配置，Docker Compose 中通过 environment 字段，CLI 模式中通过 -e 参数指定。

用户/组标识符

使用卷挂载（-v 参数）时，主机与容器可能出现权限冲突。通过指定 PUID（用户 ID）和 PGID（组 ID）可解决此问题。示例中使用 PUID=1000 和 PGID=1000，可通过以下命令获取当前用户的 ID：

$ id user
uid=1000(user) gid=1000(users) groups=1000(users)

高级配置

本地构建

如需开发调试，可基于本地克隆的仓库构建镜像（仓库 docker 目录下）：

git clone [***]
docker compose -f docker/docker-compose.yml up --build
# 或
cd docker
docker build . -t nzbget-local

Dockerfile 支持以下构建参数：

GitHub 容器注册表（ghcr.io）

镜像同时发布于 GitHub 容器注册表，使用时将镜像名称替换为 ghcr.io/nzbgetcom/nzbget:TAG，例如：

docker run -d --name=nzbget ghcr.io/nzbgetcom/nzbget:latest

Python 版本

NZBGet 镜像内置 Python 3.11。

下载速度优化

若 Linux 或 Docker 环境中下载速度低于预期，可尝试以下优化：

1. 增加服务器连接数（配置路径：NEWS-SERVERS -> Connections）：默认 8，建议尝试 16 或 32。
2. 对于低性能设备/主机：将文章读取块大小从 4 增加到 64（配置路径：CONNECTION -> ArticleReadChunkSize），该设置在 v23 及以上版本可用。

Unrar 7 支持

镜像包含优化的 Unrar 7 二进制文件，需在设置中修改 UNPACK -> UnrarCmd 为 unrar7 启用。Unrar 7 针对不同架构的优化参数：

• x86-64：x86-64-v2
• arm64：armv8-a+***+crc
• armhf：armv7-a

更多性能优化信息见 性能调优文档。

原生 Unrar 7 构建

如需在支持加密加速的硬件上构建原生优化的 Unrar 7，可使用以下 Docker Compose 配置（需从 官方仓库 获取 entrypoint.sh 和 Dockerfile）：

---
services:
  nzbget:
    build:
      context: .
      args:
        MAKE_JOBS: 4  # 构建并行任务数（建议设为 CPU 核心数）
        UNRAR7_NATIVE: "true"  # 启用原生构建
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Europe/London
      - NZBGET_USER=nzbget
      - NZBGET_PASS=tegbzn6789
    volumes:
      - ./config:/config
      - ./downloads:/downloads
    ports:
      - 6789:6789
    restart: unless-stopped