签入版本

docker/.env.example

@@ -2,6 +2,11 @@
 # Docker Compose 环境变量模板
 # 用法：复制为同目录 .env（同目录被 .gitignore 与 .dockerignore 双重排除）
 #      copy .env.example .env
+# 说明：本文件使用 MYSQL_HOST 等友好名，由 docker-compose.yml 的
+#      environment 块映射为 GF_ 规范键（如 GF_DATABASE_DEFAULT_LINK）
+#      注入容器——应用只认 GF_ 前缀键，勿将友好名原样透传给应用
+# 注意：值中含 $ 须写成 $$（compose 变量插值会吞掉单 $，
+#      如密码 abc#$^ 应写为 abc#$$^）
 # ============================================================
 
 # ===== 应用 =====

docker/Dockerfile

@@ -8,7 +8,7 @@
 #   - builder 只负责编译，runtime 仅含二进制 + 运行时资产，镜像最小化
 #   - 运行时资产四件：manifest/config、manifest/data(ip2region.xdb)、
 #     resource(字体/swagger)、templates(代码生成器模板)
-#   - 敏感配置不改镜像内文件，运行时用 GF_GENV_ 前缀环境变量覆盖
+#   - 敏感配置不改镜像内文件，运行时用 GF_ 前缀环境变量覆盖
 #     （见 manifest/config/config.yaml 头部说明）
 #   - 源码 COPY 放在依赖下载之后，保护 go mod 层缓存
 #

docker/docker-compose.yml

@@ -21,17 +21,17 @@ services:
     restart: always
     ports:
       - "${APP_PORT:-8000}:8000"
-    # 敏感/环境相关配置一律 GF_GENV_ 前缀覆盖，不改镜像内 config.yaml
-    # （GF_GENV_ 键名 = 配置路径大写下划线，如 file.uploadDir → GF_GENV_FILE_UPLOADDIR）
+    # 敏感/环境相关配置一律 GF_ 前缀覆盖，不改镜像内 config.yaml
+    # （GF_ 键名 = 配置路径大写下划线，如 file.uploadDir → GF_FILE_UPLOADDIR）
     environment:
       TZ: Asia/Shanghai
-      GF_GENV_DATABASE_DEFAULT_LINK: "mysql:${MYSQL_USER:-root}:${MYSQL_PASSWORD:-root}@tcp(${MYSQL_HOST:-mysql}:${MYSQL_HOST_PORT:-3306})/${MYSQL_DATABASE:-easygoadmin.goframe.elevue}?charset=utf8mb4&parseTime=true&loc=Local"
-      GF_GENV_REDIS_DEFAULT_ADDRESS: "${REDIS_HOST:-redis}:${REDIS_HOST_PORT:-6379}"
-      GF_GENV_REDIS_DEFAULT_PASS: "${REDIS_PASSWORD:-123456}"
-      GF_GENV_FILE_UPLOADDIR: "/data/upload"
-      GF_GENV_JWT_SECRET: "${JWT_SECRET:-please-change-this-jwt-secret}"
-      GF_GENV_CAPTCHA_BYPASSCODE: ""        # 生产环境清空万能验证码
-      GF_GENV_APP_ERRORMSG: "false"         # 生产环境关闭详细错误信息
+      GF_DATABASE_DEFAULT_LINK: "mysql:${MYSQL_USER:-root}:${MYSQL_PASSWORD:-root}@tcp(${MYSQL_HOST:-mysql}:${MYSQL_HOST_PORT:-3306})/${MYSQL_DATABASE:-easygoadmin.goframe.elevue}?charset=utf8mb4&parseTime=true&loc=Local"
+      GF_REDIS_DEFAULT_ADDRESS: "${REDIS_HOST:-redis}:${REDIS_HOST_PORT:-6379}"
+      GF_REDIS_DEFAULT_PASS: "${REDIS_PASSWORD:-123456}"
+      GF_FILE_UPLOADDIR: "/data/upload"
+      GF_JWT_SECRET: "${JWT_SECRET:-please-change-this-jwt-secret}"
+      GF_CAPTCHA_BYPASSCODE: ""        # 生产环境清空万能验证码
+      GF_APP_ERRORMSG: "false"         # 生产环境关闭详细错误信息
     volumes:
       # 上传文件持久化（两段式上传的 temp 与正式目录都在 uploadDir 下）
       - ../upload:/data/upload