一分钟搭建影视站,支持Docker等部署方式
ci(docker): 镜像双发布 GHCR 与 Docker Hub(bestzwei/libretv),凭据缺失时自动降级为仅 GHCR
bestZwei2f760b323ef1
diff --git a/.github/workflows/docker-publish.yml b/.github/workflows/docker-publish.ymlindex 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/libretvjobs:# 先跑类型检查与单测,避免把坏版本推成镜像@@ -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: metauses: docker/metadata-action@v5with:@@ -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 }}/digestsrun: |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.mdindex 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 并打 gitgit 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))。## 安全说明