Skip to content

一分钟搭建影视站,支持Docker等部署方式

ci(docker): 镜像双发布 GHCR 与 Docker Hub(bestzwei/libretv),凭据缺失时自动降级为仅 GHCR

bestZwei2f760b323ef1
diff --git a/.github/workflows/docker-publish.yml b/.github/workflows/docker-publish.yml
index 6a37041..aa782fe 100644
--- a/.github/workflows/docker-publish.yml
+++ b/.github/workflows/docker-publish.yml
@@ -1,12 +1,16 @@
name: docker-publish
-# 推送版本 tag(如 v2.0.1)时自动构建并发布镜像到 GHCR;
+# 推送版本 tag(如 v2.0.1)时自动构建并发布镜像到 GHCR 与 Docker Hub;
# 也可在 Actions 页面手动触发。
-# 无需配置任何 secrets:使用内置 GITHUB_TOKEN 推送 ghcr.io。
+# GHCR 使用内置 GITHUB_TOKEN,无需配置 secrets;Docker Hub 需在仓库
+# Settings → Secrets and variables → Actions 配置 DOCKER_USERNAME 与
+# DOCKER_PASSWORD(Docker Hub 的 Access Token),未配置时自动降级为仅发布 GHCR。
#
# 多架构构建拆分:amd64 与 arm64 各自跑在原生 runner 上(GitHub 公开仓库
# 免费提供 ubuntu-24.04-arm),按 digest 推送后合并 manifest。QEMU 跨架构
# 模拟 npm ci / next build 极慢且不稳(Illegal instruction 崩溃),不再使用。
+# Docker Hub 不重新构建:merge 阶段用 imagetools 把 GHCR 的同一组 digest
+# 复制过去,两个 registry 的多架构镜像 digest 完全一致。
on:
push:
@@ -20,6 +24,8 @@ permissions:
env:
REGISTRY: ghcr.io
+ # Docker Hub 双发布目标(固定仓库,无需按 owner 推导)
+ DOCKERHUB_IMAGE: docker.io/bestzwei/libretv
jobs:
# 先跑类型检查与单测,避免把坏版本推成镜像
@@ -128,6 +134,15 @@ jobs:
username: ${{ github.actor }}
password: ${{ secrets.GITHUB_TOKEN }}
+ # Docker Hub 双发布:凭据未配置时整段跳过(仅发布 GHCR),不影响既有流程
+ - name: 登录 Docker Hub
+ if: ${{ secrets.DOCKER_PASSWORD != '' }}
+ uses: docker/login-action@v3
+ with:
+ registry: docker.io
+ username: ${{ secrets.DOCKER_USERNAME }}
+ password: ${{ secrets.DOCKER_PASSWORD }}
+
- id: meta
uses: docker/metadata-action@v5
with:
@@ -137,12 +152,36 @@ jobs:
type=semver,pattern={{major}}.{{minor}}
type=raw,value=latest
+ # 与 GHCR 同一组标签规则;标签在各自的 imagetools create 里使用
+ - id: meta-hub
+ if: ${{ secrets.DOCKER_PASSWORD != '' }}
+ uses: docker/metadata-action@v5
+ with:
+ images: ${{ env.DOCKERHUB_IMAGE }}
+ tags: |
+ type=semver,pattern={{version}}
+ type=semver,pattern={{major}}.{{minor}}
+ type=raw,value=latest
+
# 纯 registry 元数据操作:把 build job 已推上来的两个架构 digest
# 组装成多架构 manifest 并打标签。不要在这里用 build-push-action——
# 那会触发一次重新构建(无 context 时更会直接失败)。
- - name: 创建并推送多架构 manifest
+ # 标签改从各自 meta 步骤的 outputs.tags 展开:metadata-action 会导出
+ # 同名的 DOCKER_METADATA_OUTPUT_JSON 环境变量,跑两次会互相覆盖,
+ # 不能再用该环境变量区分两个 registry。
+ - name: 创建并推送多架构 manifest(GHCR)
+ working-directory: ${{ runner.temp }}/digests
+ run: |
+ docker buildx imagetools create \
+ $(printf -- '-t %s ' ${{ steps.meta.outputs.tags }}) \
+ $(printf '${{ steps.image.outputs.name }}@sha256:%s ' *)
+
+ # 跨 registry 复制:从 GHCR 的架构 digest 拉取后推到 Docker Hub,
+ # 镜像内容(含 manifest digest)与 GHCR 完全一致,无需重新构建
+ - name: 复制多架构 manifest 到 Docker Hub
+ if: ${{ secrets.DOCKER_PASSWORD != '' }}
working-directory: ${{ runner.temp }}/digests
run: |
docker buildx imagetools create \
- $(jq -cr '.tags | map("-t " + .) | join(" ")' <<< "$DOCKER_METADATA_OUTPUT_JSON") \
+ $(printf -- '-t %s ' ${{ steps.meta-hub.outputs.tags }}) \
$(printf '${{ steps.image.outputs.name }}@sha256:%s ' *)
diff --git a/README.md b/README.md
index cd6473e..eb0a2ea 100644
--- a/README.md
+++ b/README.md
@@ -61,8 +61,9 @@ docker compose pull && docker compose up -d
> ⚠️ **生产部署必须通过 HTTPS 访问**(localhost 除外):生产模式下会话 cookie 带 `Secure` 标记,浏览器只在 HTTPS(或 localhost)下保存它。因此用 `http://服务器IP:端口` 访问时,会出现"密码正确却无法登录"的现象——登录请求实际成功,但 cookie 被浏览器丢弃。请通过反向代理(Nginx / Caddy / Traefik)或 Cloudflare 等为站点套上 TLS 后再对外提供服务;本地开发用 `localhost` 不受影响。
-镜像发布在 GHCR:`ghcr.io/librespark/libretv`(`latest` / `主.次` / 完整版本号三个 tag,
-`linux/amd64` 与 `linux/arm64` 双架构)。需要固定版本时在 `.env` 中设置
+镜像发布在 GHCR 与 Docker Hub:`ghcr.io/librespark/libretv` 与 `docker.io/bestzwei/libretv`
+(`latest` / `主.次` / 完整版本号三个 tag,`linux/amd64` 与 `linux/arm64` 双架构,
+两个 registry 的镜像 digest 一致)。需要固定版本时在 `.env` 中设置
`LIBRETV_IMAGE=ghcr.io/librespark/libretv:2.0.1`。
> 版本号以 `package.json` 为单一来源,部署后可用 `/api/status` 返回的 `version` 字段核对。详见[部署文档](https://github.com/bestZwei/LibreTV-Next/wiki/Deployment)。
@@ -172,7 +173,7 @@ npm version patch # 或 minor / major;会更新 package.json 并打 git
git push && git push --tags
```
-CI 校验通过后自动构建并推送 `ghcr.io/librespark/libretv:<版本>`(详见[部署文档](https://github.com/bestZwei/LibreTV-Next/wiki/Deployment))。
+CI 校验通过后自动构建并推送 `ghcr.io/librespark/libretv:<版本>` 与 `docker.io/bestzwei/libretv:<版本>`(详见[部署文档](https://github.com/bestZwei/LibreTV-Next/wiki/Deployment))。
## 安全说明