SABnzbd Kubernetes镜像文档

概述

SABnzbd是一款流行的Usenet客户端，用于下载、管理Usenet网络中的内容，支持任务队列管理、自动解压缩、文件修复等功能，并提供直观的Web管理界面。本镜像专为Kubernetes环境构建，优化了容器化部署特性，可直接在Kubernetes集群中运行，满足容器化环境下的Usenet内容获取需求。

源码地址：[***]

核心功能与特性

• Usenet协议支持：兼容标准NNTP协议，可连接各类Usenet服务器进行内容下载
• 任务队列管理：通过Web界面可视化管理下载任务，支持优先级调整、暂停/恢复等操作
• 自动化处理：内置自动解压缩、损坏文件修复、冗余数据清理功能，简化后期处理流程
• Kubernetes适配：容器化设计支持集群资源调度，可通过Kubernetes控制器实现高可用部署
• 配置持久化：支持通过Kubernetes持久卷（PV/PVC）存储配置文件和下载数据，确保服务重启后状态不丢失

使用场景

• 家庭媒体中心：在Kubernetes集群中部署，作为媒体内容获取工具，配合Plex、Emby等媒体服务器构建家庭影音系统
• 内容管理系统：企业或团队用于自动化获取Usenet中的特定内容（如技术文档、开源资源）并进行集中管理
• 开发测试环境：快速部署Usenet客户端进行协议测试、下载性能验证等开发场景

使用方法与配置说明

部署到Kubernetes集群

以下是在Kubernetes中部署SABnzbd的基础Deployment配置示例：

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: sabnzbd
  namespace: media  # 建议使用专用命名空间隔离资源
spec:
  replicas: 1  # 根据需求调整副本数
  selector:
    matchLabels:
      app: sabnzbd
  template:
    metadata:
      labels:
        app: sabnzbd
    spec:
      containers:
      - name: sabnzbd
        image: gitlab.com/k3s-media/sabnzbd:latest  # 使用最新镜像版本
        ports:
        - containerPort: 8080  # Web管理界面默认端口
        volumeMounts:
        - name: sabnzbd-config  # 挂载配置文件存储卷
          mountPath: /config
        - name: sabnzbd-downloads  # 挂载下载数据存储卷
          mountPath: /downloads
        env:
        - name: TZ  # 设置容器时区（如亚洲/上海）
          value: "Asia/Shanghai"
        - name: PUID  # 运行进程的用户ID（避免权限问题）
          value: "1000"
        - name: PGID  # 运行进程的用户组ID
          value: "1000"
      volumes:
      - name: sabnzbd-config
        persistentVolumeClaim:
          claimName: sabnzbd-config-pvc  # 配置文件PVC名称
      - name: sabnzbd-downloads
        persistentVolumeClaim:
          claimName: sabnzbd-downloads-pvc  # 下载数据PVC名称

持久化存储配置

为确保配置和下载数据不丢失，需创建对应的持久卷声明（PVC）：

配置文件PVC示例

yaml
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: sabnzbd-config-pvc
  namespace: media
spec:
  accessModes:
    - ReadWriteOnce  # 单节点读写权限（根据存储类型调整）
  resources:
    requests:
      storage: 1Gi  # 配置文件体积较小，1Gi通常足够

下载数据PVC示例

yaml
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: sabnzbd-downloads-pvc
  namespace: media
spec:
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: 100Gi  # 根据预期下载量调整（建议不小于50Gi）

环境变量说明

访问与初始化配置

1. 暴露服务：通过Kubernetes Service或Ingress暴露Web界面端口（以NodePort为例）：

   yaml
   apiVersion: v1
   kind: Service
   metadata:
     name: sabnzbd-service
     namespace: media
   spec:
     type: NodePort
     selector:
       app: sabnzbd
     ports:
     - port: 8080
       nodePort: 30080  # 集群节点可访问的端口
   

2. 访问界面：通过http://<集群节点IP>:30080打开SABnzbd Web管理界面
3. 初始化设置：首次访问需配置Usenet服务器信息（主机地址、端口、账号密码），完成后即可添加下载任务

注意：具体配置细节（如高级参数、自定义插件支持）请参考源码仓库文档，以上内容基于SABnzbd标准功能及Kubernetes镜像通用特性整理。