LogoTanStarter 文档
LogoTanStarter 文档
首页模板介绍代码库快速开始环境配置部署网站
网站配置

功能集成

Cloudflare数据库存储身份验证邮件
支付
AI邮件订阅通知分析聊天框联盟营销

功能定制

元数据页面落地页博客组件用户管理密钥管理

代码库

项目结构代码检查编辑器设置更新代码库
X (Twitter)

环境配置

为您的 TanStarter 应用程序配置环境变量

TanStarter 需要一些环境变量才能正常运行,本文档介绍如何逐步设置这些环境变量。

环境变量

网站配置

变量描述
VITE_BASE_URL网站的 URL,例如
http://localhost:3000 用于开发环境,
https://your-domain.com 用于生产环境

Cloudflare

在 Cloudflare 文档中学习如何获取和配置 Token。

变量描述
CLOUDFLARE_ACCOUNT_IDCloudflare 账户 ID(用于 Wrangler CLI 和 Cloudflare REST API)
CLOUDFLARE_API_TOKENCloudflare API 令牌(用于 Wrangler CLI 和 Cloudflare REST API)

数据库

在数据库设置文档中学习如何设置数据库。

变量描述
CLOUDFLARE_DATABASE_IDCloudflare D1 数据库 ID(用于 Drizzle Kit 远程操作)

存储

在存储设置文档中学习如何设置存储。

TanStarter 使用 Cloudflare R2 binding 进行存储,无需配置额外的环境变量。

身份验证

在身份验证设置文档中学习如何设置身份验证。

变量描述
BETTER_AUTH_SECRET用于哈希令牌和签名 Cookie 的随机字符串
GOOGLE_CLIENT_IDGoogle OAuth 客户端 ID(可选)
GOOGLE_CLIENT_SECRETGoogle OAuth 客户端密钥(可选)

邮件

在 邮件设置 文档中学习如何设置邮件功能。

TanStarter 支持 Resend 和 Cloudflare Email Service 作为邮件服务提供商。

变量描述
RESEND_API_KEYResend 邮件服务的 API 密钥

注意: 使用 Resend 时,RESEND_API_KEY 可在邮件模块和邮件订阅模块之间共享。

变量描述
CLOUDFLARE_ACCOUNT_IDCloudflare 账户 ID
CLOUDFLARE_API_TOKENCloudflare API 令牌,需要具有 Email Sending Write 权限

支付

在支付设置文档中学习如何设置支付。

TanStarter 支持 Stripe 和 Creem 作为支付提供商。

在 Stripe 设置 文档中学习如何设置 Stripe。

变量描述
VITE_PAYMENT_PROVIDER设置为 stripe 以启用 Stripe 支付提供商
STRIPE_SECRET_KEYStripe 密钥
STRIPE_WEBHOOK_SECRETStripe Webhook 签名密钥
VITE_STRIPE_PRICE_PRO_MONTHLY专业计划月度订阅的 Stripe 价格 ID
VITE_STRIPE_PRICE_PRO_YEARLY专业计划年度订阅的 Stripe 价格 ID
VITE_STRIPE_PRICE_LIFETIME终身计划的 Stripe 价格 ID

在 Creem 设置 文档中学习如何设置 Creem。

变量描述
VITE_PAYMENT_PROVIDER设置为 creem 以启用 Creem 支付提供商
CREEM_API_KEYCreem API 密钥
CREEM_WEBHOOK_SECRETCreem 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_KEYfal.ai API 密钥,用于图像生成,请在 fal.ai Dashboard 创建

邮件订阅

在 邮件订阅设置 文档中学习如何设置邮件订阅。

TanStarter 支持 Resend 和 Beehiiv 作为邮件订阅服务提供商。

变量描述
RESEND_API_KEYResend 邮件订阅服务的 API 密钥(与邮件模块共享)

注意: 使用 Resend 时,RESEND_API_KEY 可在邮件模块和邮件订阅模块之间共享。

变量描述
BEEHIIV_API_KEYBeehiiv 邮件订阅服务的 API 密钥
BEEHIIV_PUBLICATION_IDBeehiiv 邮件订阅服务的 Publication ID

通知

在通知设置文档中学习如何设置通知。

变量描述
DISCORD_WEBHOOK_URLDiscord Webhook URL,用于接收通知
FEISHU_WEBHOOK_URL飞书 Webhook URL,用于接收通知

统计分析

在统计分析设置文档中学习如何设置统计分析。

变量描述
VITE_GOOGLE_ANALYTICS_IDGoogle Analytics ID
VITE_UMAMI_WEBSITE_IDUmami Analytics 网站 ID
VITE_UMAMI_SCRIPTUmami Analytics 脚本 URL
VITE_PLAUSIBLE_SCRIPTPlausible Analytics 脚本 URL
VITE_CLARITY_PROJECT_IDClarity Analytics 项目 ID

聊天框

在聊天框设置文档中学习如何设置聊天框。

变量描述
VITE_CRISP_WEBSITE_IDCrisp Chat ID,用于网站在线客服功能

联盟营销

在联盟营销设置文档中学习如何设置联盟营销。

变量描述
VITE_AFFILIATE_AFFONSO_IDAffonso 联盟营销 ID
VITE_AFFILIATE_PROMOTEKIT_IDPromoteKit 联盟营销 ID

验证环境变量

要验证环境变量是否正确设置,请运行:

pnpm run dev

如果一切配置正确,您的应用程序应该可以正常启动并运行,没有任何与环境相关的错误。

视频教程

下一步

现在您的环境已经设置好了,探索这些相关主题:

网站配置

配置网站设置

快速开始

TanStarter 模板快速开始

数据库

配置数据库

部署

部署到 Cloudflare Workers

快速开始

学习如何在几分钟内设置和运行您的 TanStarter 网站

部署网站

学习如何将您的 TanStarter 项目部署到 Cloudflare Workers

目录

环境变量
网站配置
Cloudflare
数据库
存储
身份验证
邮件
支付
AI
邮件订阅
通知
统计分析
聊天框
联盟营销
验证环境变量
视频教程
下一步