From f91b3143da1518a57d143c625c36104a71653637 Mon Sep 17 00:00:00 2001 From: LanQin Date: Mon, 15 Jun 2026 22:19:24 +0800 Subject: [PATCH] =?UTF-8?q?=20chore(deploy):=20=E6=9B=B4=E6=96=B0=20GHCR?= =?UTF-8?q?=20=E9=BB=98=E8=AE=A4=E9=95=9C=E5=83=8F=E4=B8=8E=E9=83=A8?= =?UTF-8?q?=E7=BD=B2=E8=AF=B4=E6=98=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 将部署示例中的默认镜像改为仓库对应的 GHCR 地址。 - 补充单容器部署时的镜像确认说明。 - 更新 GitHub Actions 的路径忽略规则，避免文档和示例配置变更触发发布流程。 --- .github/workflows/docker.yml | 6 ++++++ README.md | 5 +++-- deploy/.env.example | 17 +++++++++-------- deploy/README.md | 17 +++++++++-------- 4 files changed, 27 insertions(+), 18 deletions(-) diff --git a/.github/workflows/docker.yml b/.github/workflows/docker.yml index 56686cb..ea6f1c8 100644 --- a/.github/workflows/docker.yml +++ b/.github/workflows/docker.yml @@ -7,7 +7,13 @@ on: - master tags: - "v*" + paths-ignore: + - "**/*.md" + - "deploy/.env.example" pull_request: + paths-ignore: + - "**/*.md" + - "deploy/.env.example" workflow_dispatch: permissions: diff --git a/README.md b/README.md index 4223b5a..3761bf3 100644 --- a/README.md +++ b/README.md @@ -59,8 +59,8 @@ docker compose up -d --build ```bash cd deploy cp .env.example .env -# 修改 .env 里的域名、管理员密码，以及 LANQIN_IMAGE -# LANQIN_IMAGE=ghcr.io//:latest +# 修改 .env 里的域名、管理员密码，确认 LANQIN_IMAGE +# LANQIN_IMAGE=ghcr.io/lanqin996/lanqin-email:latest docker compose pull docker compose up -d ``` @@ -88,3 +88,4 @@ docker compose -f docker-compose.stack.yml up -d --build - 服务器部署：`deploy/.env.example` 默认使用 `LANQIN_SMTP_HOST=127.0.0.1`，发件会交给同容器内 Postfix。 - 收件同步：Postfix/Dovecot 收到的 Maildir 邮件会由 API 的 Maildir worker 同步到 SQLite 后展示在 Webmail。 - Maildir worker 通过 `LANQIN_MAILDIR_ROOT` 和 `LANQIN_MAILDIR_SCAN_SECONDS` 控制，默认服务器路径为 `/var/mail/vhosts`。 + diff --git a/deploy/.env.example b/deploy/.env.example index 0cf99d5..3e4e4bc 100644 --- a/deploy/.env.example +++ b/deploy/.env.example @@ -5,16 +5,16 @@ # ========================= # Docker 镜像 # ========================= -# 单容器部署镜像。默认 local 表示本机 docker compose up --build 构建。 -# 如果使用 GitHub Actions 发布到 GHCR，改成：ghcr.io//:latest -LANQIN_IMAGE=lanqin-email:local +# 单容器部署镜像。默认使用你的 GHCR 镜像。 +# 如果只想本机构建，可以临时改成 lanqin-email:local 后执行 docker compose up -d --build。 +LANQIN_IMAGE=ghcr.io/lanqin996/lanqin-email:latest # 多容器调试版镜像。只在 docker-compose.stack.yml 中使用。 -LANQIN_API_IMAGE=lanqin-email-api:local -LANQIN_WEB_IMAGE=lanqin-email-web:local -LANQIN_POSTFIX_IMAGE=lanqin-email-postfix:local -LANQIN_DOVECOT_IMAGE=lanqin-email-dovecot:local -LANQIN_OPENDKIM_IMAGE=lanqin-email-opendkim:local +LANQIN_API_IMAGE=ghcr.io/lanqin996/lanqin-email-api:latest +LANQIN_WEB_IMAGE=ghcr.io/lanqin996/lanqin-email-web:latest +LANQIN_POSTFIX_IMAGE=ghcr.io/lanqin996/lanqin-email-postfix:latest +LANQIN_DOVECOT_IMAGE=ghcr.io/lanqin996/lanqin-email-dovecot:latest +LANQIN_OPENDKIM_IMAGE=ghcr.io/lanqin996/lanqin-email-opendkim:latest # ========================= # 对外访问地址 @@ -110,3 +110,4 @@ LANQIN_MAIL_REFRESH_SECONDS=30 # ========================= # 容器时区。 TZ=Asia/Shanghai + diff --git a/deploy/README.md b/deploy/README.md index 99064cc..22b0e4d 100644 --- a/deploy/README.md +++ b/deploy/README.md @@ -41,18 +41,18 @@ docker compose logs -f lanqin-email 默认发布镜像： ```text -ghcr.io//:latest -ghcr.io//-api:latest -ghcr.io//-web:latest -ghcr.io//-postfix:latest -ghcr.io//-dovecot:latest -ghcr.io//-opendkim:latest +ghcr.io/lanqin996/lanqin-email:latest +ghcr.io/lanqin996/lanqin-email-api:latest +ghcr.io/lanqin996/lanqin-email-web:latest +ghcr.io/lanqin996/lanqin-email-postfix:latest +ghcr.io/lanqin996/lanqin-email-dovecot:latest +ghcr.io/lanqin996/lanqin-email-opendkim:latest ``` -单容器部署时，把 `.env` 里的 `LANQIN_IMAGE` 改成你的 GHCR 镜像： +单容器部署时，确认 `.env` 里的 `LANQIN_IMAGE` 是你的 GHCR 镜像： ```env -LANQIN_IMAGE=ghcr.io//:latest +LANQIN_IMAGE=ghcr.io/lanqin996/lanqin-email:latest ``` 然后在服务器执行： @@ -102,3 +102,4 @@ docker compose -f docker-compose.stack.yml up -d --build - 建议在服务器或边缘网关配置 HTTPS。 - 云厂商通常默认封禁 25 端口，需要单独申请解封。 - SQLite 适合 V1 单机部署；多节点部署前迁移到 PostgreSQL，并把 Postfix/Dovecot maps 改为 PostgreSQL。 +