chore(deploy): 更新 GHCR 默认镜像与部署说明

- 将部署示例中的默认镜像改为仓库对应的 GHCR 地址。
- 补充单容器部署时的镜像确认说明。
- 更新 GitHub Actions 的路径忽略规则，避免文档和示例配置变更触发发布流程。

.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:

README.md

@@ -59,8 +59,8 @@ docker compose up -d --build
 ```bash
 cd deploy
 cp .env.example .env
-# 修改 .env 里的域名、管理员密码，以及 LANQIN_IMAGE
+# 修改 .env 里的域名、管理员密码，确认 LANQIN_IMAGE
-# LANQIN_IMAGE=ghcr.io/<owner>/<repo>:latest
+# 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`。
+

deploy/.env.example

@@ -5,16 +5,16 @@
 # =========================
 # Docker 镜像
 # =========================
-# 单容器部署镜像。默认 local 表示本机 docker compose up --build 构建。
+# 单容器部署镜像。默认使用你的 GHCR 镜像。
-# 如果使用 GitHub Actions 发布到 GHCR，改成：ghcr.io/<owner>/<repo>:latest
+# 如果只想本机构建，可以临时改成 lanqin-email:local 后执行 docker compose up -d --build。
-LANQIN_IMAGE=lanqin-email:local
+LANQIN_IMAGE=ghcr.io/lanqin996/lanqin-email:latest
 
 # 多容器调试版镜像。只在 docker-compose.stack.yml 中使用。
-LANQIN_API_IMAGE=lanqin-email-api:local
+LANQIN_API_IMAGE=ghcr.io/lanqin996/lanqin-email-api:latest
-LANQIN_WEB_IMAGE=lanqin-email-web:local
+LANQIN_WEB_IMAGE=ghcr.io/lanqin996/lanqin-email-web:latest
-LANQIN_POSTFIX_IMAGE=lanqin-email-postfix:local
+LANQIN_POSTFIX_IMAGE=ghcr.io/lanqin996/lanqin-email-postfix:latest
-LANQIN_DOVECOT_IMAGE=lanqin-email-dovecot:local
+LANQIN_DOVECOT_IMAGE=ghcr.io/lanqin996/lanqin-email-dovecot:latest
-LANQIN_OPENDKIM_IMAGE=lanqin-email-opendkim:local
+LANQIN_OPENDKIM_IMAGE=ghcr.io/lanqin996/lanqin-email-opendkim:latest
 
 # =========================
 # 对外访问地址
@@ -110,3 +110,4 @@ LANQIN_MAIL_REFRESH_SECONDS=30
 # =========================
 # 容器时区。
 TZ=Asia/Shanghai
+

deploy/README.md

@@ -41,18 +41,18 @@ docker compose logs -f lanqin-email
 默认发布镜像：
 
 ```text
-ghcr.io/<owner>/<repo>:latest
+ghcr.io/lanqin996/lanqin-email:latest
-ghcr.io/<owner>/<repo>-api:latest
+ghcr.io/lanqin996/lanqin-email-api:latest
-ghcr.io/<owner>/<repo>-web:latest
+ghcr.io/lanqin996/lanqin-email-web:latest
-ghcr.io/<owner>/<repo>-postfix:latest
+ghcr.io/lanqin996/lanqin-email-postfix:latest
-ghcr.io/<owner>/<repo>-dovecot:latest
+ghcr.io/lanqin996/lanqin-email-dovecot:latest
-ghcr.io/<owner>/<repo>-opendkim:latest
+ghcr.io/lanqin996/lanqin-email-opendkim:latest
 ```
 
-单容器部署时，把 `.env` 里的 `LANQIN_IMAGE` 改成你的 GHCR 镜像：
+单容器部署时，确认 `.env` 里的 `LANQIN_IMAGE` 是你的 GHCR 镜像：
 
 ```env
-LANQIN_IMAGE=ghcr.io/<owner>/<repo>: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。
+