diff --git a/.env.example b/.env.example
index 8a66b82..21ce3e3 100644
--- a/.env.example
+++ b/.env.example
@@ -4,10 +4,18 @@
 WOC_USER=admin
 WOC_PASSWORD=wechat
 
-# 镜像版本：默认 latest；上线后建议钉到具体版本（如 v1.0.0）以便可控升级。
+# 镜像版本：默认 latest；上线后建议钉到具体版本（如 1.0.0，注意不带 v）以便可控升级。
 # 同时作用于面板镜像和新建微信实例所用镜像。
 WOC_VERSION=latest
 
+# 镜像源前缀（registry + 命名空间）。默认 GHCR 官方。
+# 中国大陆网络拉 ghcr.io 常 TLS 超时，可改用 GHCR 反代镜像（前提：GHCR 包已设为 Public）：
+#   WOC_IMAGE_PREFIX=ghcr.nju.edu.cn/gloridust      # 南京大学镜像站反代 ghcr.io（较稳定）
+# 反代会把 ghcr.io/gloridust/xxx 映射为 <反代>/gloridust/xxx。
+# 若用自己的国内仓库（阿里云 ACR / 腾讯 TCR / 华为 SWR），填该仓库的完整前缀即可，例如：
+#   WOC_IMAGE_PREFIX=registry.cn-hangzhou.aliyuncs.com/你的命名空间
+WOC_IMAGE_PREFIX=ghcr.io/gloridust
+
 # 宿主用户 uid/gid（飞牛上用 `id` 命令查看；单用户 NAS 一般是 1000）。
 # 透传给每个微信实例容器，决定面板数据与微信数据卷的属主。
 WOC_PUID=1000
diff --git a/docker-compose.yml b/docker-compose.yml
index 35f13db..b2e8bc9 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -3,7 +3,8 @@
 # 镜像全部从 GHCR 拉取，无需本地构建。要改配置：复制 .env.example 为 .env 后修改。
 services:
   panel:
-    image: ghcr.io/gloridust/woc-panel:${WOC_VERSION:-latest}
+    # 镜像源前缀默认 GHCR；大陆网络拉不动时改 .env 的 WOC_IMAGE_PREFIX 切到国内反代（见 .env.example）。
+    image: ${WOC_IMAGE_PREFIX:-ghcr.io/gloridust}/woc-panel:${WOC_VERSION:-latest}
     container_name: woc-panel
     # pull_policy 用默认（missing）：本地已有同名镜像就直接用，没有才去 GHCR 拉。
     # 这样「发布前本地自构建」与「线上拉取」都能用同一份 compose。
@@ -11,8 +12,8 @@ services:
 
     environment:
       - PORT=8080
-      # 新建微信实例时使用的镜像（多架构，amd64/arm64 自动匹配）
-      - WOC_WECHAT_IMAGE=ghcr.io/gloridust/wechat-on-cloud:${WOC_VERSION:-latest}
+      # 新建微信实例时使用的镜像（多架构，amd64/arm64 自动匹配）；前缀同样跟随 WOC_IMAGE_PREFIX。
+      - WOC_WECHAT_IMAGE=${WOC_IMAGE_PREFIX:-ghcr.io/gloridust}/wechat-on-cloud:${WOC_VERSION:-latest}
       # 透传给每个微信实例容器（KasmVNC 基础镜像用它们降权运行）
       - PUID=${WOC_PUID:-1000}
       - PGID=${WOC_PGID:-1000}