> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# 配置

让应用配置保持显式，供应商凭证留在服务端。

## 进行一项配置更改并检查它

从正在运行的 Web 应用程序开始。在编辑器中打开apps/web/.env.local；如果不存在，请使用 Web 教程将 .env.example 复制到那里。对于无害的首次检查，请找到 EMAIL_PROVIDER=local 并将其保留在本地。此设置将产品电子邮件发送到本地预览而不是真正的收件箱。不要将 KEY=value 线粘贴到终端中。

对于您启用的每项服务，请遵循该提供商的设置指南，仅替换指定值，保存文件，使用 Ctrl + C 停止 Web 服务器，然后使用以下命令重新启动。如果验证指定了丢失的密钥，请重新打开此文件并将该密钥与提供程序指南进行比较。仅对数据库迁移使用的值保持 root .env 同步；单独复制它不会配置 Next.js。

[查找配置密钥](https://supastack.dev/zh/docs/web/project-structure.md)

[了解如何运行命令和编辑文件](https://supastack.dev/zh/docs/web/terminal-basics.md)

```
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
```


如果你想继续完成设置，可以阅读《[设置数据库](https://supastack.dev/zh/docs/web/setup-database.md)》。


## 下一篇

[构建你的第一个功能](https://supastack.dev/zh/docs/web/first-feature.md)