Dokploy 与环境变量

在 Dokploy(或同类面板)中部署与配置环境变量。

原则

  • 密钥与连接串只放在部署平台或受控环境中,勿提交到仓库。
  • 常见变量:DATABASE_URL、AUTH_SECRET、AUTH_URL、NEXT_PUBLIC_WEB_URL、可选 CRON_SECRET_KEY、Web Push 的 VAPID 等。

操作流程

  1. 项目 → 应用 → 环境变量。
  2. 保存后 重新部署 / 重启,使进程读取新变量。
  3. 在日志中确认 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 专用表。
Dokploy 与环境变量 | 追踪狗文档