For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /zh/docs/web/configuration.md (or send Accept: text/markdown).
配置
让应用配置保持显式，供应商凭证留在服务端。
进行一项配置更改并检查它
从正在运行的 Web 应用程序开始。在编辑器中打开apps/web/.env.local；如果不存在，请使用 Web 教程将 .env.example 复制到那里。对于无害的首次检查，请找到 EMAIL_PROVIDER=local 并将其保留在本地。此设置将产品电子邮件发送到本地预览而不是真正的收件箱。不要将 KEY=value 线粘贴到终端中。
对于您启用的每项服务，请遵循该提供商的设置指南，仅替换指定值，保存文件，使用 Ctrl + C 停止 Web 服务器，然后使用以下命令重新启动。如果验证指定了丢失的密钥，请重新打开此文件并将该密钥与提供程序指南进行比较。仅对数据库迁移使用的值保持 root .env 同步；单独复制它不会配置 Next.js。
corepack pnpm --filter @supastack/web dev你最先真正要改的设置
存储库根部的 .env.example 是套件认识的全部设置清单；不在那个文件里的名字就不存在。开头你只会动少数几个——其余保持默认，直到某篇提供商指南要求它们。
各应用读哪个文件：根部 .env 供给迁移命令，apps/web/.env.local 供给 Next.js 服务器，apps/mobile/.env.local 供给 Expo。改一个文件不会配置其余几个，所以 DATABASE_URL 同时存在于根部 .env 和 apps/web/.env.local。
APP_URL——应用所在的地址；本地是http://localhost:3000，生产环境是你的域名。DATABASE_URL——迁移与服务器共用的 Postgres 连接字符串。AUTH_SECRET和CREDENTIAL_ENCRYPTION_KEY——生成的机密；node scripts/setup-env.mjs会替你填好（该助手随 Web 存储库和 All Platforms monorepo 附带）。- 提供商选择器——
EMAIL_PROVIDER、AI_PROVIDER、BILLING_PROVIDER、JOB_PROVIDER、CAPTCHA_PROVIDER——各自决定运行哪个适配器；local/fake/off默认值不需要账户。 RESEND_API_KEY、STRIPE_SECRET_KEY等提供商机密——只在对应提供商指南要求时再添加。
从环境示例开始
根目录的 .env.example 是配置清单。共享校验在 packages/config。把选定的应用环境与供应商模式放在一起审阅；本地界面并不等于生产凭证策略。
无凭证的参考模式要求 local/test 应用配置与 fake/本地供应商。选择生产供应商会改变运行要求。
让密钥留在 API 之后
认证密钥、数据库凭证、供应商密钥、Stripe 密钥与 Trigger 凭证都属于服务端。绝不要给它们加 NEXT_PUBLIC_ 或 EXPO_PUBLIC_ 前缀。安装过程中不要打印它们，也不要把它们放进错误响应。
浏览器只拿到公开配置与允许的模型别名。工作区归属、权限决策、预算与供应商选择都由服务端强制执行。
先用再信：检查变更
通过现有的 config 包校验配置，并运行相关的确定性测试。准备好验证真实集成时，再走单独 opt-in 的供应商冒烟路径。
corepack pnpm test
corepack pnpm check
corepack pnpm build如果你想继续完成设置，可以阅读《设置数据库》。