ghcr.io/home-operations/qbittorrent:5.2.4

容器

一组带有特定观点的容器镜像集合

使命宣言

特性

标签不可变性

此处构建的容器不使用传统意义上的不可变标签（如 https://fleet.linuxserver.io/ 或 https://bitnami.com/stacks/containers 所采用的方式）。相反，我们坚持固定镜像的 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@sha256:516ae5c85089b3f2960cf2a21dc3c105356969499964fabf0b0358e5f3a7e0a2
    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@sha256:516ae5c85089b3f2960cf2a21dc3c105356969499964fabf0b0358e5f3a7e0a2
          securityContext: # 可能需要将额外目录挂载为 emptyDir
            allowPrivilegeEscalation: false
            capabilities:
              drop:
                - ALL
            readOnlyRootFilesystem: true
          volumeMounts:
            - name: tmp
              mountPath: /tmp
          # ...
      securityContext:
        runAsUser: 1000
        runAsGroup: 1000
        fsGroup: 1000 # (需要 CSI 支持)
        fsGroupChangePolicy: OnRootMismatch # (需要 CSI 支持)
      volumes:
        - name: tmp
          emptyDir: {}
      # ...
  # ...

向应用传递参数

某些应用仅允许通过命令行参数而非环境变量进行特定配置。有关此类情况，请参考 Kubernetes 文档中关于https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/的部分。然后，如下所示指定所需参数：

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：

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。

这种方式确保了一致性并专注于简化构建流程。

贡献

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

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

弃用

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

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

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

致谢

本仓库的灵感和想法来自 home-ops 社区、https://hotio.dev/ 以及 https://www.linuxserver.io/ 的贡献者。