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.ymlindex c7157c6f4..69fcd6972 100644--- a/.github/workflows/release.yml+++ b/.github/workflows/release.yml@@ -550,6 +550,9 @@ jobs:needs: [release, validate]runs-on: ubuntu-latesttimeout-minutes: 25+ permissions:+ contents: read+ packages: writesteps:- 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: 推送版本号与 edgerun: |- 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"+ donedoneproject-board:diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 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.mdindex 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.mdnew file mode 100644index 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 已经推完;重试发布作业即可,两边标签都会补齐。