ghcr.io/home-operations/qbittorrent:5.2.2

容器

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

使命宣言

特性

标签不可变性

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

如果将镜像固定到 sha256 摘要，像https://github.com/renovatebot/renovate%E8%BF%99%E6%A0%B7%E7%9A%84%E5%B7%A5%E5%85%B7%E5%8F%AF%E4%BB%A5%E5%9F%BA%E4%BA%8E%E6%91%98%E8%A6%81%E6%88%96%E7%89%88%E6%9C%AC%E5%8F%98%E6%9B%B4%E6%9D%A5%E6%9B%B4%E6%96%B0%E5%AE%B9%E5%99%A8%E3%80%82

无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的贡献者。