Dokploy 与环境变量
在 Dokploy(或同类面板)中部署与配置环境变量。
原则
- 密钥与连接串只放在部署平台或受控环境中,勿提交到仓库。
- 常见变量:
DATABASE_URL、AUTH_SECRET、AUTH_URL、NEXT_PUBLIC_WEB_URL、可选CRON_SECRET_KEY、Web Push 的 VAPID 等。
操作流程
- 项目 → 应用 → 环境变量。
- 保存后 重新部署 / 重启,使进程读取新变量。
- 在日志中确认 Next.js 正常启动。
Cron 变量名
接口鉴权读取的是 CRON_SECRET_KEY。若面板上曾用其他名称,请与代码一致。
同步
部署方式或必填变量有变时,请更新本页与 status/changelog。
Dependencies
环境变量(全应用代表性清单,在面板中配置)
DATABASE_URL— PostgreSQL。AUTH_SECRET及与 OAuth 一致的回调基地址。NEXT_PUBLIC_WEB_URL— 站点根 URL(结账与回调)。CRON_SECRET_KEY— 外网定时器访问 Cron。ADMIN_EMAILS、NEXT_PUBLIC_ADMIN_EMAILS— Admin 白名单。- 支付:
PAY_PROVIDER、STRIPE_PRIVATE_KEY、STRIPE_WEBHOOK_SECRET、CREEM_API_KEY、CREEM_WEBHOOK_SECRET、CREEM_PRODUCTS、CREEM_ENV、NEXT_PUBLIC_PROJECT_NAME、NEXT_PUBLIC_PAY_CANCEL_URL。 - 推送:
NEXT_PUBLIC_VAPID_PUBLIC_KEY、VAPID_PRIVATE_KEY、VAPID_SUBJECT— Notifications。 - Web3:
NEXT_PUBLIC_WEB3_ENABLED、NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID、NEXT_PUBLIC_SUPPORTED_CHAINS、NEXT_PUBLIC_WEB3_APP_URL— Web3 认证。
数据库
- 单库全表:
src/db/schema.ts;无 Dokploy 专用表。