环境变量
提示
由于 Nexty 提供了多个仓库,不同仓库环境变量有差异,请访问对应的环境变量说明:
网站基础配置
| 环境变量 | 是否必须 | 引入版本 | 说明 |
|---|---|---|---|
NEXT_PUBLIC_SITE_URL | 必须 | 1.x | 网站访问地址 • 本地开发时填写启动地址,默认为 http://localhost:3000• 生产环境请填写你的实际域名 |
NEXT_PUBLIC_PRICING_PATH | 必须 | 2.x | 和实际定价计划的页面对应,默认是 /#pricing |
NEXT_PUBLIC_LOCALE_DETECTION | 必须 | 1.x | 语言检测模式,推荐设置为 false• 设为 true:启用 next-intl 自动检测,会根据浏览器语言自动跳转到对应语言页面• 设为 false:使用 Nexty.dev 内置的 SEO 友好语言检测器 |
NEXT_PUBLIC_OPTIMIZED_IMAGES | 可选 | 2.x | 是否启用图片优化,推荐设置为 true,这样能够节省 Vercel 图片优化资源 |
NEXT_PUBLIC_LOGIN_MODE | 可选 | 2.x | 选择登录模式:page 是打开登录页 /login,dialog 是打开登录弹框 |
NEXT_PUBLIC_COOKIE_CONSENT_ENABLED | 可选 | 3.1.6 | 是否启用 Cookie 同意弹框 |
提示
Nexty.dev 的语言检测器会在用户首次访问时检查浏览器语言,如果与当前页面语言不一致,会弹出友好的切换提示。这种方式减少了不必要的重定向,对 SEO 更加友好。
数据库
查看数据库集成步骤。
| 环境变量 | 是否必须 | 引入版本 | 说明 |
|---|---|---|---|
DATABASE_URL | 必须 | 3.0.0 |
授权
查看授权集成步骤。
| 环境变量 | 是否必须 | 引入版本 | 说明 |
|---|---|---|---|
BETTER_AUTH_SECRET | 可选 | 3.0.0 | 使用命令 openssl rand -base64 32 生成 |
NEXT_PUBLIC_GITHUB_CLIENT_ID | 可选 | 3.0.0 | |
GITHUB_CLIENT_SECRET | 可选 | 3.0.0 | |
NEXT_PUBLIC_GOOGLE_CLIENT_ID | 可选 | 3.0.0 | |
GOOGLE_CLIENT_SECRET | 可选 | 3.0.0 |
Cloudflare Turnstile
查看 Turnstile 集成步骤。
| 环境变量 | 是否必须 | 引入版本 | 说明 |
|---|---|---|---|
NEXT_PUBLIC_TURNSTILE_SITE_KEY | 可选 | 2.x | 填写则会开启 Cloudfalre Turnstile |
TURNSTILE_SECRET_KEY | 可选 | 3.0.0 |
Resend 邮件服务
查看 Resend 集成步骤。
| 环境变量 | 是否必须 | 引入版本 | 说明 |
|---|---|---|---|
RESEND_API_KEY | 可选 | 1.x | Resend API 访问密钥 |
RESEND_AUDIENCE_ID | 可选 | 1.x | Resend 受众群体 ID |
ADMIN_EMAIL | 可选 | 1.x | 管理员邮箱地址,用作邮件发送方 |
ADMIN_NAME | 可选 | 1.x | 管理员姓名,用作邮件发送方显示名称 |
Upstash Redis
查看 Upstash 集成步骤。
| 环境变量 | 是否必须 | 引入版本 | 说明 |
|---|---|---|---|
UPSTASH_REDIS_REST_URL | 可选 | 1.x | Redis 数据库 URL |
UPSTASH_REDIS_REST_TOKEN | 可选 | 1.x | Redis 访问令牌 |
DAY_MAX_SUBMISSIONS | 可选 | 1.x | 每日最大提交次数限制 |
Stripe
查看 Stripe 集成步骤。
| 环境变量 | 是否必须 | 引入版本 | 说明 |
|---|---|---|---|
NEXT_PUBLIC_ENABLE_STRIPE | 必须 | 1.x | 是否启用 Stripe 支付功能 • 设为 true:启用 Stripe 支付功能• 设为 false:关闭支付功能,关闭时下列配置项可以不填 |
NEXT_PUBLIC_DEFAULT_CURRENCY | 可选 | 1.x | 默认支付货币 |
STRIPE_SECRET_KEY | 可选 | 1.x | Stripe 私有密钥 |
STRIPE_PUBLISHABLE_KEY | 可选 | 1.x | Stripe 公开密钥 |
STRIPE_WEBHOOK_SECRET | 可选 | 1.x | Stripe Webhook 签名密钥 |
STRIPE_CUSTOMER_PORTAL_URL | 可选 | 1.x | 用户订阅管理页面 URL,为用户提供订阅信息展示和退订的入口,默认为 /dashboard/subscription 页面 |
STRIPE_RADAR_EARLY_FRAUD_WARNING_TYPE | 可选 | 3.1.9 | 用于设置触发 Stripe Radar 早期欺诈警告的响应行为 |
STRIPE_RADAR_EARLY_FRAUD_WARNING_TYPE 用于设置触发 Stripe Radar 早期欺诈警告的响应行为:
可选值及其含义:
- "refund,email": 自动退款并向管理员发送邮件通知
- "refund": 仅自动退款
- "email": 仅向管理员发送邮件通知(不自动退款)
- 留空或不设置则不处理
如需 Discord 提醒,可自行扩展环境变量的可选值,并利用 lib/discord/notifications.ts 中的方法实现 Discord 通知。
Cloudflare R2 存储
查看 Cloudflare R2 集成步骤。
| 环境变量 | 是否必须 | 引入版本 | 说明 |
|---|---|---|---|
R2_ACCOUNT_ID | 可选 | 1.x | R2 存储账户 ID |
R2_ACCESS_KEY_ID | 可选 | 1.x | R2 访问密钥 ID |
R2_SECRET_ACCESS_KEY | 可选 | 1.x | R2 私有访问密钥 |
R2_BUCKET_NAME | 可选 | 1.x | R2 存储桶名称 |
R2_PUBLIC_URL | 可选 | 1.x | R2 存储桶公共访问 URL |
AI 模型集成
| 环境变量 | 是否必须 | 引入版本 | 说明 |
|---|---|---|---|
OPENAI_API_KEY | 可选 | 1.x | OpenAI API 密钥 |
DEEPSEEK_API_KEY | 可选 | 1.x | DeepSeek API 密钥 |
ANTHROPIC_API_KEY | 可选 | 1.x | Anthropic API 密钥 |
XAI_API_KEY | 可选 | 1.x | XAI API 密钥 |
GOOGLE_GENERATIVE_AI_API_KEY | 可选 | 1.x | Google API 密钥 |
REPLICATE_API_TOKEN | 可选 | 1.x | Replicate API 令牌 |
OPENROUTER_API_KEY | 可选 | 1.x | OpenRouter API 密钥 |
FIRECRAWL_API_KEY | 可选 | 3.1.7 | Firecrawl API 密钥 |
AI 翻译功能
定价计划编辑页面、博客编辑页面提供了 AI 多语言翻译功能,需要在此处配置对应的 AI 模型才能使用。
| 环境变量 | 是否必须 | 引入版本 | 说明 |
|---|---|---|---|
NEXT_PUBLIC_AI_PROVIDER | 可选 | 1.x | AI 模型服务提供商,如:xai |
NEXT_PUBLIC_AI_MODEL_ID | 可选 | 1.x | AI 模型标识符,如:grok-3 |
数据分析与广告
| 环境变量 | 是否必须 | 引入版本 | 说明 |
|---|---|---|---|
NEXT_PUBLIC_GOOGLE_ID | 可选 | 1.x | Google Analytics |
NEXT_PUBLIC_BAIDU_TONGJI | 可选 | 1.x | 百度统计 |
NEXT_PUBLIC_PLAUSIBLE_SRC | 可选 | 2.x | Plausible 脚本源地址 |
NEXT_PUBLIC_PLAUSIBLE_DOMAIN | 可选 | 2.x | Plausible 分析域名 |
PLAUSIBLE_API_KEY | 可选 | 3.1.2 | Plausible API Key |
PLAUSIBLE_URL | 可选 | 3.1.2 | Plausible 服务器地址 |
NEXT_PUBLIC_GOOGLE_ADSENSE_ID | 可选 | 1.x | Google AdSense |
Discord WidgetBot
| 环境变量 | 是否必须 | 引入版本 | 说明 |
|---|---|---|---|
NEXT_PUBLIC_DISCORD_INVITE_URL | 可选 | 2.x | Discord 邀请链接 |
DISCORD_WEBHOOK_URL | 可选 | 3.1.7 | Discord Notify Webhook URL |
Affiliate(Tolt.io)
查看 Tolt 集成步骤。
| 环境变量 | 是否必须 | 引入版本 | 说明 |
|---|---|---|---|
NEXT_PUBLIC_TOLT_ID | 可选 | 2.x | Tolt.io Affiliate ID |