跳转到内容
supastack
浏览文档
WebTanStack Start

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/tanstack/configuration.md (or send Accept: text/markdown).

配置

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

询问本指南
打开方式

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

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

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

corepack pnpm --filter @supastack/web-tanstack dev

你最先真正要改的设置

存储库根部的 .env.example 是套件认识的全部设置清单；不在那个文件里的名字就不存在。开头你只会动少数几个——其余保持默认，直到某篇提供商指南要求它们。

各应用读哪个文件：根部 .env 供给迁移命令，apps/web-tanstack/.env.local 供给 TanStack Start 服务器，apps/mobile/.env.local 供给 Expo。改一个文件不会配置其余几个，所以 DATABASE_URL 同时存在于根部 .env 和 apps/web-tanstack/.env.local。

  • APP_URL——应用所在的地址；本地是 http://localhost:3000，生产环境是你的域名。
  • DATABASE_URL——迁移与服务器共用的 Postgres 连接字符串。
  • AUTH_SECRET 和 CREDENTIAL_ENCRYPTION_KEY——生成的机密；node scripts/setup-env.mjs 会替你填好（该助手随 TanStack 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

如果你想继续完成设置，可以阅读《设置数据库》。