ghcr.io/home-operations/qbittorrent:5.1.1

容器

一系列具有特定观点的容器镜像集合

使命宣言

特性

标签不可变性

此处构建的容器不使用传统意义上的不可变标签（如 linuxserver.io 或 Bitnami 所采用的方式）。相反，我们坚持固定镜像的 sha256 摘要。虽然此方法视觉上不够直观，但能确保功能稳定性和不可变性。

如果将镜像固定到 sha256 摘要，https://github.com/renovatebot/renovate 等工具可基于摘要或版本变化更新容器。

无 Root 权限

默认情况下，我们的大多数容器以非 root 用户（65534:65534）运行，您可以通过更新配置文件更改用户/组。

Docker Compose

services:
  home-assistant:
    image: ghcr.io/home-operations/home-assistant:2025.5.1
    container_name: home-assistant
    user: 1000:1000 # 数据卷权限必须与此用户:组匹配
    read_only: true # 可能需要将其他目录挂载为 tmpfs
    tmpfs:
      - /tmp:rw
    # ...

Kubernetes

apiVersion: apps/v1
kind: Deployment
metadata:
  name: home-assistant
  # ...
spec:
  # ...
  template:
    # ...
    spec:
      containers:
        - name: home-assistant
          image: ghcr.io/home-operations/home-assistant:2025.5.1
          securityContext: # 可能需要将其他目录挂载为 emptyDir
            allowPrivilegeEscalation: false
            capabilities:
              drop:
                - ALL
            readOnlyRootFilesystem: true
          volumeMounts:
            - name: tmp
              mountPath: /tmp
          # ...
      securityContext:
        runAsUser: 1000
        runAsGroup: 1000
        fsGroup: 65534 # (需要 CSI 支持)
        fsGroupChangePolicy: OnRootMismatch # (需要 CSI 支持)
      volumes:
        - name: tmp
          emptyDir: {}
      # ...
  # ...

向应用程序传递参数

某些应用程序仅允许通过命令行参数而非环境变量进行特定配置。对于此类情况，请参考 Kubernetes 文档中关于为容器定义命令和参数的部分。然后按如下方式指定所需参数：

args:
  - --port
  - "8080"

配置卷

对于需要持久化配置数据的应用程序，配置卷在容器内硬编码为 /config。在大多数情况下，此路径无法更改。

验证镜像签名

这些容器镜像使用 https://github.com/actions/attest-build-provenance action 进行签名。

要验证镜像是否由 GitHub CI 构建，请使用以下命令：

gh attestation verify --repo home-operations/containers oci://ghcr.io/home-operations/${APP}:${TAG}

或使用 https://github.com/sigstore/cosign%EF%BC%9A

cosign verify-attestation --new-bundle-format --type slsaprovenance1 \
  --certificate-oidc-issuer "https://token.actions.githubusercontent.com" \
  --certificate-identity-regexp "^https://github.com/home-operations/containers/.github/workflows/app-builder.yaml@refs/heads/main" \
  ghcr.io/home-operations/${APP}:${TAG}

不支持的特性

本仓库不支持同一应用程序的多个"渠道"。例如：

• *******、Radarr、Lidarr 和 Sonarr 仅发布 develop 分支，不发布 master（稳定）分支。
• qBittorrent 仅发布带有 LibTorrent 2.x 的版本。更多信息请参见 https://github.com/home-operations/containers/issues/848%E3%80%82

此方法确保一致性并专注于简化构建流程。

贡献指南

我们鼓励尽可能使用官方上游容器镜像。但在以下情况下，为本仓库贡献可能是合理的：

• 上游应用程序仍在积极维护。
• 并且满足以下条件之一：
  • 不存在官方镜像。
  • 官方镜像不支持多架构构建。
  • 官方镜像使用 s6-overlay、gosu 或其他非常规初始化机制。
  • 不标记发布版本。

弃用政策

本仓库中的容器可能因以下原因被弃用：

1. 上游应用程序不再积极维护。
2. 存在符合本仓库使命宣言的官方上游容器。
3. 维护负担不可持续，例如频繁构建失败或不稳定。

[!NOTE] 已弃用的容器将通过发布公告通知，并在注册表中保留 6 个月后移除。

致谢

本仓库的灵感和理念来自 home-ops 社区、hotio.dev 以及 linuxserver.io 的贡献者。