环境配置
为您的 ShipSaaS 应用程序配置环境变量
ShipSaaS 需要一些环境变量才能正常运行，本文档介绍如何逐步设置这些环境变量。
环境变量
网站配置
| 变量 | 描述 |
|---|---|
| VITE_BASE_URL | 网站的 URL，例如 http://localhost:3000 用于开发环境，https://your-domain.com 用于生产环境 |
Cloudflare
在 Cloudflare 文档中学习如何获取和配置 Token。
| 变量 | 描述 |
|---|---|
| CLOUDFLARE_ACCOUNT_ID | Cloudflare 账户 ID（用于 Wrangler CLI 和 Cloudflare REST API） |
| CLOUDFLARE_API_TOKEN | Cloudflare API 令牌（用于 Wrangler CLI 和 Cloudflare REST API） |
数据库
在数据库设置文档中学习如何设置数据库。
| 变量 | 描述 |
|---|---|
| CLOUDFLARE_DATABASE_ID | Cloudflare D1 数据库 ID（用于 Drizzle Kit 远程操作） |
存储
在存储设置文档中学习如何设置存储。
ShipSaaS 使用 Cloudflare R2 binding 进行存储，无需配置额外的环境变量。
身份验证
在身份验证设置文档中学习如何设置身份验证。
| 变量 | 描述 |
|---|---|
| BETTER_AUTH_SECRET | 用于哈希令牌和签名 Cookie 的随机字符串 |
| GOOGLE_CLIENT_ID | Google OAuth 客户端 ID（可选） |
| GOOGLE_CLIENT_SECRET | Google OAuth 客户端密钥（可选） |
邮件
在 邮件设置 文档中学习如何设置邮件功能。
ShipSaaS 支持 Resend 和 Cloudflare Email Service 作为邮件服务提供商。
Cloudflare Email
| 变量 | 描述 |
|---|---|
| RESEND_API_KEY | Resend 邮件服务的 API 密钥 |
注意： 使用 Resend 时，RESEND_API_KEY 可在邮件模块和邮件订阅模块之间共享。
Resend
| 变量 | 描述 |
|---|---|
| CLOUDFLARE_ACCOUNT_ID | Cloudflare 账户 ID |
| CLOUDFLARE_API_TOKEN | Cloudflare API 令牌，需要具有 Email Sending Write 权限 |
支付
在支付设置文档中学习如何设置支付。
ShipSaaS 支持 Stripe 和 Creem 作为支付提供商。
Stripe
在 Stripe 设置 文档中学习如何设置 Stripe。
| 变量 | 描述 |
|---|---|
| VITE_PAYMENT_PROVIDER | 设置为 stripe 以启用 Stripe 支付提供商 |
| STRIPE_SECRET_KEY | Stripe 密钥 |
| STRIPE_WEBHOOK_SECRET | Stripe Webhook 签名密钥 |
| VITE_STRIPE_PRICE_PRO_MONTHLY | 专业计划月度订阅的 Stripe 价格 ID |
| VITE_STRIPE_PRICE_PRO_YEARLY | 专业计划年度订阅的 Stripe 价格 ID |
| VITE_STRIPE_PRICE_LIFETIME | 终身计划的 Stripe 价格 ID |
Creem
在 Creem 设置 文档中学习如何设置 Creem。
| 变量 | 描述 |
|---|---|
| VITE_PAYMENT_PROVIDER | 设置为 creem 以启用 Creem 支付提供商 |
| CREEM_API_KEY | Creem API 密钥 |
| CREEM_WEBHOOK_SECRET | Creem Webhook 签名密钥 |
| CREEM_DEBUG | 设置为 true 以使用 Creem 测试环境（可选） |
| VITE_CREEM_PRODUCT_PRO_MONTHLY | 专业计划月度订阅的 Creem 产品 ID |
| VITE_CREEM_PRODUCT_PRO_YEARLY | 专业计划年度订阅的 Creem 产品 ID |
| VITE_CREEM_PRODUCT_LIFETIME | 终身计划的 Creem 产品 ID |
AI
在 AI 设置 文档中学习如何设置 AI 功能。
| 变量 | 描述 |
|---|---|
| FAL_API_KEY | fal.ai API 密钥，用于图像生成，请在 fal.ai Dashboard 创建 |
邮件订阅
在 邮件订阅设置 文档中学习如何设置邮件订阅。
ShipSaaS 支持 Resend 和 Beehiiv 作为邮件订阅服务提供商。
Resend
| 变量 | 描述 |
|---|---|
| RESEND_API_KEY | Resend 邮件订阅服务的 API 密钥（与邮件模块共享） |
注意： 使用 Resend 时，RESEND_API_KEY 可在邮件模块和邮件订阅模块之间共享。
Beehiiv
| 变量 | 描述 |
|---|---|
| BEEHIIV_API_KEY | Beehiiv 邮件订阅服务的 API 密钥 |
| BEEHIIV_PUBLICATION_ID | Beehiiv 邮件订阅服务的 Publication ID |
通知
在通知设置文档中学习如何设置通知。
| 变量 | 描述 |
|---|---|
| DISCORD_WEBHOOK_URL | Discord Webhook URL，用于接收通知 |
| FEISHU_WEBHOOK_URL | 飞书 Webhook URL，用于接收通知 |
统计分析
在统计分析设置文档中学习如何设置统计分析。
| 变量 | 描述 |
|---|---|
| VITE_GOOGLE_ANALYTICS_ID | Google Analytics ID |
| VITE_UMAMI_WEBSITE_ID | Umami Analytics 网站 ID |
| VITE_UMAMI_SCRIPT | Umami Analytics 脚本 URL |
| VITE_PLAUSIBLE_SCRIPT | Plausible Analytics 脚本 URL |
| VITE_CLARITY_PROJECT_ID | Clarity Analytics 项目 ID |
聊天框
在聊天框设置文档中学习如何设置聊天框。
| 变量 | 描述 |
|---|---|
| VITE_CRISP_WEBSITE_ID | Crisp Chat ID，用于网站在线客服功能 |
联盟营销
在联盟营销设置文档中学习如何设置联盟营销。
| 变量 | 描述 |
|---|---|
| VITE_AFFILIATE_AFFONSO_ID | Affonso 联盟营销 ID |
| VITE_AFFILIATE_PROMOTEKIT_ID | PromoteKit 联盟营销 ID |
验证环境变量
要验证环境变量是否正确设置，请运行：
bun run dev如果一切配置正确，您的应用程序应该可以正常启动并运行，没有任何与环境相关的错误。
下一步
现在您的环境已经设置好了，探索这些相关主题：
-
网站配置 - 配置网站设置
-
获取 ShipSaaS - ShipSaaS 模板快速开始
-
数据库 - 配置数据库
-
部署 - 部署到 Cloudflare Workers