linuxserver/hydra2

镜像概述和主要用途

linuxserver/hydra2 是由 LinuxServer.io 团队提供的 Docker 容器镜像，用于运行 Hydra2 应用。Hydra2 是一款针对 NZB 索引器的元搜索应用，作为 NZBmegasearcH 的"精神继任者"，同时也是初代 NZBHydra 应用的进化版本。该应用提供对多个原始及基于 newznab 的索引器的便捷访问，支持从 NZBHydra V1 迁移配置。

重要提示：此镜像已被弃用。LinuxServer.io 团队将继续在新镜像 linuxserver/nzbhydra2 下发布更新。从旧版本迁移时，建议备份原有配置以避免兼容性问题。支持从 V1 迁移的最后一个版本为 linuxserver/hydra2:v2.10.2-ls49。

核心功能和特性

LinuxServer.io 容器特性

• 定期应用更新：及时跟进上游应用版本更新
• 简化用户映射：通过 PUID/PGID 轻松配置容器内用户权限
• 自定义基础镜像：集成 s6 overlay 进程管理系统
• 高效资源利用：每周基础 OS 更新，通过跨镜像共享通用层减少存储空间占用、 downtime 和带宽消耗
• 定期安全更新：持续修复基础镜像及应用安全漏洞

Hydra2 应用特性

• 多索引器支持：整合多个原始及基于 newznab 协议的 NZB 索引器
• 配置迁移：支持从 NZBHydra V1 迁移配置（需注意兼容性）
• 统一搜索接口：提供单一入口搜索多个索引器资源
• 元数据聚合：整合不同索引器的搜索结果，优化排序和展示

使用场景和适用范围

适用于需要整合多个 NZB 索引器、简化 NZB 文件搜索流程的用户。典型场景包括：

• 个人媒体服务器管理员，需通过统一接口搜索 NZB 资源
• NZB 索引器重度用户，希望聚合多个平台的搜索结果
• 从 NZBHydra V1 迁移的用户，需要无缝过渡到新版本

详细使用方法和配置说明

支持的架构

该镜像支持多种架构，通过 Docker 清单实现多平台识别。直接拉取 linuxserver/hydra2 即可获取对应架构的镜像，也可通过标签指定特定架构：

版本标签

Docker 部署示例

docker run 命令

bash
docker create \
  --name=hydra2 \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Europe/London \
  -p 5076:5076 \
  -v <数据存储路径>:/config \
  -v <NZB下载路径>:/downloads \
  --restart unless-stopped \
  linuxserver/hydra2

docker-compose 配置

兼容 docker-compose v2 架构：

yaml
---
version: "2.1"
services:
  hydra2:
    image: linuxserver/hydra2
    container_name: hydra2
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Europe/London
    volumes:
      - <数据存储路径>:/config  # 存放配置文件
      - <NZB下载路径>:/downloads  # NZB文件下载目录
    ports:
      - 5076:5076  # Web界面端口
    restart: unless-stopped

参数说明

容器运行参数采用 <外部>:<内部> 格式定义，具体说明如下：

环境变量从文件读取（Docker Secrets）

可通过 FILE__ 前缀从文件加载环境变量，例如：

bash
-e FILE__PASSWORD=/run/secrets/mysecretpassword

上述命令会将 /run/secrets/mysecretpassword 文件内容作为 PASSWORD 环境变量的值。

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

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

通过以下命令获取当前用户的 UID 和 GID：

bash
id username
# 输出示例：uid=1000(dockeruser) gid=1000(dockergroup) groups=1000(dockergroup)

应用设置

容器启动后，通过 <主机IP>:5076 访问 Web 管理界面。首次使用需完成以下配置：

1. 添加 NZB 索引器（原始或基于 newznab 协议）
2. 配置 NZB 下载应用连接（如 SABnzbd、NZBGet）
3. （如从 V1 迁移）导入旧配置文件（建议先备份 V1 配置）

Docker Mods

LinuxServer.io 提供多种 Docker Mods 以扩展容器功能。访问上方链接查看该镜像支持的 Mods。

支持信息

• 容器内 shell 访问：

  bash
  docker exec -it hydra2 /bin/bash
  

• 实时查看容器日志：

  bash
  docker logs -f hydra2
  

• 查看容器版本：

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

• 查看镜像版本：

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

更新方法

LinuxServer.io 镜像通常为静态版本，需通过更新镜像并重建容器来更新应用（部分应用如 nextcloud、plex 除外）。以下是常用更新方法：

通过 Docker Run/Create 更新

1. 拉取最新镜像：

   bash
   docker pull linuxserver/hydra2
   

2. 停止并删除当前容器：

   bash
   docker stop hydra2 && docker rm hydra2
   

3. 使用原参数重建容器（配置文件通过卷挂载保留）：

   bash
   docker create [原参数] linuxserver/hydra2
   

4. 启动新容器：

   bash
   docker start hydra2
   

5. 清理旧镜像：

   bash
   docker image prune
   

通过 Docker Compose 更新

1. 拉取最新镜像（或指定服务）：

   bash
   docker-compose pull  # 更新所有服务
   # 或
   docker-compose pull hydra2  # 仅更新hydra2
   

2. 重建并启动容器：

   bash
   docker-compose up -d  # 更新所有服务
   # 或
   docker-compose up -d hydra2  # 仅更新hydra2
   

3. 清理旧镜像：

   bash
   docker image prune
   

通过 Watchtower 自动更新（适用于忘记原始参数时）

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

注意：LinuxServer.io 不推荐使用自动更新工具，建议手动更新以避免配置冲突。

本地构建

如需自定义镜像，可通过以下步骤本地构建：

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

ARM 架构构建：在 x86_64 硬件上构建 ARM 镜像需先注册 qemu-user-static：

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

然后使用对应架构的 Dockerfile：

bash
docker build -f Dockerfile.aarch64 -t linuxserver/hydra2:arm64v8-latest .

版本历史

• 2020年4月19日：镜像已弃用，新镜像迁移至 linuxserver/nzbhydra2。
• 2020年1月8日：切换至 Python 3。
• 2020年1月5日：添加 dev 标签用于预发布版本。
• 2019年3月23日：切换至新基础镜像，使用 arm32v7 标签。
• 2019年2月11日：添加流水线逻辑及多架构支持。
• 2018年8月18日：升级 Java 版本至 10（bionic 系统中显示为版本 11）。
• 2018年8月10日：基于 Ubuntu Bionic 重建。
• 2018年4月15日：Dockerfile 中修改端口为 5076。
• 2018年1月11日：初始发布。