# OMS 后端生产环境变量模板(此文件提交 git,供服务器上创建真实 .env 用;真实 .env 不入库) # # 服务器上的真实文件位置:/www/wwwroot/oms.gztbyc.com/api/shared-config/.env # cp env.production.example /www/wwwroot/oms.gztbyc.com/api/shared-config/.env && vim ... # (通常不用手工建:本地 tools/config/env.production.local 发布时会自动传上去) # 各版本目录(v1 / v2)下必须各有一份 .env:config.default.js 的 dotenv 只读「进程工作目录」下的 .env, # 而实例的工作目录就是各自的版本目录。发布脚本会在目标版本目录缺少 .env 时自动从 deployRoot/.env 复制一份 # (已存在则不覆盖,便于个别版本目录单独调整)。 # —— MySQL(必填)—— # ⚠️ 服务器本机 MySQL 监听 3306;不配置时 database/config.js 的默认值是 3307(本地开发库端口), # 会出现 ECONNREFUSED 127.0.0.1:3307 导致实例启动失败 MYSQL_HOST=127.0.0.1 MYSQL_PORT=3306 MYSQL_USER=__FILL_MYSQL_USER__ MYSQL_PASSWORD=__FILL_MYSQL_PASSWORD__ MYSQL_DATABASE=oms # —— Redis(必填)—— # 未设置 REDIS_PASSWORD 时 config.default.js 会回落到默认值 qwe2019,生产请显式写明 REDIS_HOST=127.0.0.1 REDIS_PORT=6379 REDIS_PASSWORD=__FILL_REDIS_PASSWORD__ # —— JWT(必填)—— # 生产必须单独设置,不要使用 config.default.js 里的开发默认值 JWT_SECRET=__FILL_RANDOM_SECRET__ JWT_EXPIRES_IN=2h JWT_RENEW_THRESHOLD=1800 # —— 上传文件目录(必填)—— # 必须放在 deployRoot 下、版本目录之外,v1 / v2 才能共用同一份上传文件 UPLOAD_DIR=/www/wwwroot/oms.gztbyc.com/api/uploads # —— 对外回调地址(可选)—— # 外部系统(WMS 等)回推 /openapi 时展示/使用的地址;不配则按请求 Host 动态生成 # 单站点部署下与前端同源,Nginx 需把 /openapi 也反代到后端(见 tools/DEPLOY.md) OMS_CALLBACK_BASE_URL=https://oms.gztbyc.com # —— 跨域白名单(可选)—— # 生产前后端同源(https://<站点域名>/api),默认不配即可;默认只放行本地开发 localhost:5173 # 直连后端地址调试或另有前端站点时再配:CORS_ORIGINS=http://example.com,https://example.com # —— 实例监听端口(双实例发布必填且两套必须不同)—— # v1 → 6090、v2 → 6091,需与 backend/config/deploy.config.local.cjs 的 ports 一致。 # 注意:端口由 config/config.default.js 的 config.cluster 读取本变量(默认 6090)。 # (不要写在 config.local.js 里:egg 只在 env=local 时加载该文件,生产不生效) # 两套实例用同一端口会抢端口(EADDRINUSE),表现为发布健康检查一直不通过。 EGG_PORT=6090 # —— 邮件(生产必填;不配置 SMTP_HOST 时验证码只写日志、前端收不到)—— # ⚠️ 未配置时 sendCode 会走「仅记录日志」分支:邮件不发出, # 但 email_logs 仍写 status=1(成功),排查时别只看这张表 # ⚠️ 本文件必须是 LF 行尾:用 CRLF 写入会让 dotenv 把 \r 带进值里, # 典型症状是 getaddrinfo ENOTFOUND smtp.qq.com(主机名尾部多了个 \r) # SMTP_HOST=smtp.qq.com # SMTP_PORT=465 # SMTP_SECURE=true # SMTP_USER= # SMTP_PASS= # SMTP_FROM= # —— AI 收件人智能识别(可选;不配置时该接口返回 400 提示)—— # DEEPSEEK_API_KEY= # —— 其它可选(有默认值,一般不用改)—— # REQUEST_LOG_KEEP_DAYS=60 # REQUEST_LOG_MAX_BODY=2000 # CACHE_TTL_USER=600 # CACHE_TTL_PRINCIPAL=600 # CACHE_TTL_PRINCIPAL_OPTIONS=600 # EMAIL_CODE_INTERVAL=60 # EMAIL_CODE_DAILY_LIMIT=10 # —— 微信登录网关(公众号扫码登录 / 扫码绑定,可选;不配置时微信相关接口返回 400 提示)—— # 在网关管理台(https://gateway.gztbyc.com)单独创建「生产环境」接入应用,拿到 appKey / appSecret 填入; # 网关的应用配置里「服务端通知地址」固定填 https://{生产域名}/api/wx/notify # ⚠️ appSecret 只保存在服务端:禁止写入前端代码、文档或二维码内容 # ⚠️ 生产与开发环境必须各自使用不同的 appKey / appSecret,互不复用 # WX_GATEWAY_BASE_URL=https://gateway.gztbyc.com WX_GATEWAY_APP_KEY=__FILL_WX_APP_KEY__ WX_GATEWAY_APP_SECRET=__FILL_WX_APP_SECRET__