Skip to content

armgit / peach

Public Imported from GitHub
0

Peach: Local-first video metadata scraper and media manager.

feat(release): Docker 镜像同时发布到 ghcr.io

longmeidao1724967f8a73
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index c7157c6f4..69fcd6972 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -550,6 +550,9 @@ jobs:
needs: [release, validate]
runs-on: ubuntu-latest
timeout-minutes: 25
+ permissions:
+ contents: read
+ packages: write
steps:
- uses: actions/checkout@v7
- uses: actions/setup-python@v7
@@ -566,11 +569,19 @@ jobs:
with:
username: ${{ vars.DOCKERHUB_USERNAME }}
password: ${{ secrets.DOCKERHUB_TOKEN }}
+ - uses: docker/login-action@v4
+ with:
+ registry: ghcr.io
+ username: ${{ github.actor }}
+ password: ${{ github.token }}
+ # Docker Hub 是应用内更新与 Watchtower 认的来源,先推;ghcr 推同一镜像,挂到仓库侧栏的 Packages(ADR-0147)。
- name: 推送版本号与 edge
run: |
- for tag in "${GITHUB_REF_NAME#v}" edge; do
- docker tag longmeidao/peach:candidate "longmeidao/peach:$tag"
- docker push "longmeidao/peach:$tag"
+ for image in longmeidao/peach ghcr.io/peach-mitao/peach; do
+ for tag in "${GITHUB_REF_NAME#v}" edge; do
+ docker tag longmeidao/peach:candidate "$image:$tag"
+ docker push "$image:$tag"
+ done
done
project-board:
diff --git a/CHANGELOG.md b/CHANGELOG.md
index c12860a8c..13b57e0c0 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -25,6 +25,10 @@ Removed / Fixed / Security。
## [未发布]
+### 新增
+
+- **更新**:Docker 镜像同时发布到 `ghcr.io/peach-mitao/peach`,Docker Hub 拉取受限时可以改用。
+
## [0.55.1] - 2026-11-05
### 修复
diff --git a/docs/DOCKER.md b/docs/DOCKER.md
index 13dbe5206..a475e8ceb 100644
--- a/docs/DOCKER.md
+++ b/docs/DOCKER.md
@@ -1,6 +1,6 @@
# Docker 部署
-Peach 的 Docker 镜像用于单人 VPS 与 NAS,通过浏览器管理,镜像仓库为 [longmeidao/peach](https://hub.docker.com/r/longmeidao/peach)。每次发布推送版本号标签,并把 `edge` 更新为同一镜像;版本号标签对应发布提交。当前镜像目标为 `linux/amd64`;ARM NAS 尚未验收。2026-10-15 在 WSL 的独立 Docker Engine 中,用正式锁定依赖通过空数据卷初始化、非 root、鉴权、配置保存、合成视频扫描、HTTP Range、配置重载与重启持久化验收。
+Peach 的 Docker 镜像用于单人 VPS 与 NAS,通过浏览器管理,镜像仓库为 [longmeidao/peach](https://hub.docker.com/r/longmeidao/peach),同一镜像也发布到 [ghcr.io/peach-mitao/peach](https://github.com/peach-mitao/peach/pkgs/container/peach),拉取受 Docker Hub 频率限制时可以改用后者;配置页的检查更新与 Watchtower 一键更新仍以 Docker Hub 为准。每次发布推送版本号标签,并把 `edge` 更新为同一镜像;版本号标签对应发布提交。当前镜像目标为 `linux/amd64`;ARM NAS 尚未验收。2026-10-15 在 WSL 的独立 Docker Engine 中,用正式锁定依赖通过空数据卷初始化、非 root、鉴权、配置保存、合成视频扫描、HTTP Range、配置重载与重启持久化验收。
Docker 不使用桌面托盘。在网页配置中添加媒体目录时,只需填写容器内实际目录,例如 `/media`;Peach 自动保存所需的路径配置。Windows 安装包、macOS 源码运行和 Docker 的入口分别见 [README](../README.md#下载与使用)。
diff --git a/docs/adr/0147-image-also-published-to-ghcr.md b/docs/adr/0147-image-also-published-to-ghcr.md
new file mode 100644
index 000000000..03f7b8bd6
--- /dev/null
+++ b/docs/adr/0147-image-also-published-to-ghcr.md
@@ -0,0 +1,20 @@
+# ADR-0147:镜像同时发布到 ghcr.io
+
+- 状态:已采纳
+- 日期:2026-11-05
+- 关系:扩展 [ADR-0105](0105-linux-headless-container.md) 的镜像仓库;发布顺序沿用 [ADR-0121](0121-release-rehearsal-and-atomic-publication.md)
+
+## 背景
+
+镜像只推 Docker Hub 的 `longmeidao/peach`,仓库页侧栏的 Packages 是空的,从 GitHub 找不到镜像。Docker Hub 对匿名拉取限频,NAS 与 VPS 用户偶尔撞上。`Dockerfile` 已带 `org.opencontainers.image.source` 指向本仓库,推到组织的 ghcr 后 GitHub 会把包挂到仓库上。
+
+## 决策
+
+**一、发布作业把同一个已验收镜像推到 `ghcr.io/peach-mitao/peach`。** 版本号与 `edge` 两个标签与 Docker Hub 一致,先推 Docker Hub,再推 ghcr。登录用作业自带的 `GITHUB_TOKEN`(`packages: write`),不新增凭据。
+
+**二、Docker Hub 仍是主来源。** 配置页检查更新(`docker_update.py`)与 Watchtower 一键更新照旧按 Docker Hub 判断新版本;ghcr 只是多一个拉取地址。
+
+## 代价
+
+- 组织下新建的包默认私有,首次发布后要由维护者在包设置里改成公开,匿名才能拉取。
+- ghcr 推送失败时,Docker Hub 已经推完;重试发布作业即可,两边标签都会补齐。