update

.env.example

@@ -1,58 +1,63 @@
-# Fashion API 环境变量示例
-#
-# 复制为 .env 供 docker-compose / 容器注入；也可直接以环境变量形式注入。
-# 本文件只作模板，不含真实密钥。密钥也可在本地「终端交互启动」时按提示填写（写回 config.local.yml）。
-#
-# 加载优先级：环境变量 > config.yml > config.local.yml > 交互提示（仅本地 TTY）
-# 注意：config.yml 中以下敏感项已留空，必须二选一提供：
-#   JWT_SECRET / DB_PASSWORD / INGEST_SECRET / HASHID_SECRET / S4_AK / S4_SK
+# ============================================================
+# 生产环境变量模板：复制为 .env 后填写（.env 已在 .gitignore 中）
+#   cp .env.example .env
+# 生成随机密钥：openssl rand -hex 32
+# ============================================================
 
-# ---- 服务 ----
-SERVER_PORT=8090
-GIN_MODE=release
-SSG_PORT=8091
-SSG_TOKEN=
-BACKSTAGE_PORT=8092
-HASHID_SECRET=
-
-# ---- 数据库 (PostgreSQL + pgvector) ----
-DB_HOST=127.0.0.1
-DB_PORT=5432
+# ---- 数据库 ----
 DB_USER=fashion
-DB_PASSWORD=
 DB_NAME=fashion
-DB_LOG_LEVEL=warn
+# 上线必改：不要沿用开发库口令
+DB_PASSWORD=
 
-# ---- JWT ----
+# ---- 后端密钥（必填，缺了容器拒绝启动）----
+# 公开 ID 混淆盐：上线后不要再改，改了所有旧链接失效
+HASHID_SECRET=
 JWT_SECRET=
-JWT_EXPIRE_HOURS=168
-JWT_REFRESH_EXPIRE_HOURS=720
-
-# ---- 爬虫上报 HMAC ----
+# 爬虫上报 HMAC 密钥：须与爬虫端 config.yml 的 ingest.secret 完全一致
 INGEST_SECRET=
-INGEST_TTL=300
-INGEST_DOWNLOAD_PROXY=
+# SSG 内部接口令牌（可选，留空则只依赖回环绑定）
+SSG_TOKEN=
 
-# ---- 公开接口前端 JS 签名 ----
-CLIENT_SIGN_ENABLED=false
-CLIENT_SIGN_SECRET=
-CLIENT_SIGN_TTL=30
-
-# ---- 跨域（CORS）：逗号分隔的具体域名，覆盖 config.yml 的 allow_origins ----
-CORS_ALLOW_ORIGINS=https://xisoa.com,https://www.xisoa.com
-
-# ---- 按 IP 速率限制（令牌桶，防刷兜底）----
-RATE_LIMIT_ENABLED=false
-RATE_LIMIT_RPS=20
-RATE_LIMIT_BURST=40
-
-# ---- 缤纷云 S4 (S3 兼容，图片存储) ----
+# ---- 对象存储（缤纷云 S4）----
 S4_ENABLED=true
+# 从开发机 configs/config.local.yml 取，或到控制台重新生成子账户密钥
 S4_AK=
 S4_SK=
 S4_BUCKET=toomstudio
 S4_ENDPOINT=https://s3.bitiful.net
 S4_REGION=cn-east-1
+# 留空自动推导为 https://<bucket>.s3.bitiful.net
 S4_BASE_URL=
-S4_STYLE_DISPLAY=high
-S4_STYLE_THUMB=thumb
+
+# ---- 目录与访问 ----
+# 前端仓库位置（服务器 /opt/fashion 下默认 ../test）
+WEB_DIR=../test
+# 前端 nginx 监听端口（有宿主机 nginx/宝塔占用 80 时改成 8080 再由外层反代）
+HTTP_PORT=80
+CORS_ALLOW_ORIGINS=https://xisoa.com,https://www.xisoa.com
+
+# ---- 限流（生产建议开启）----
+RATE_LIMIT_ENABLED=true
+RATE_LIMIT_RPS=20
+RATE_LIMIT_BURST=40
+
+# ---- 入库 worker（下载并发 1~16，Vogue 实测 4 较稳）----
+INGEST_IMAGE_CONCURRENCY=4
+# 图片下载代理，留空直连；仅作用于下载，不影响上传与数据库
+INGEST_DOWNLOAD_PROXY=
+
+# ---- 视觉服务（可选，默认关闭）----
+VISION_ENABLED=false
+VISION_ENDPOINT=http://127.0.0.1:8900
+
+# ---- 构建 ----
+# 服务器拉 Go 依赖的代理
+GOPROXY=https://goproxy.cn,direct
+
+# ---- 代码分支 ----
+# deploy.sh 会把后端仓与前端仓都切到该分支并快进拉取；临时换分支：
+#   GIT_BRANCH=dev ./deploy.sh all
+# 不想拉代码（例如手动 checkout 了某个提交）时加 --no-pull
+# 注意：本项目远程默认分支是 main（不是 master），日常开发在 dev 上
+GIT_BRANCH=main