环境配置

本章节将指导您配置 Ship Vibany 所需的各种环境变量和第三方服务。正确的环境配置是确保应用正常运行的关键步骤。

环境变量概述

Ship Vibany 使用 .env.local 文件存储所有环境变量。这些变量分为以下几个主要类别：

基本配置 - 应用 URL、调试模式等基本设置
数据库配置 - Neon PostgreSQL 数据库连接信息
认证配置 - Clerk 用户管理服务的密钥和设置
支付系统配置 - 支付宝/微信支付和 Stripe 支付的 API 密钥
AI 模型配置 - Tuzi、XAI 和 OpenAI 的 API 配置
存储配置 - Cloudflare R2 对象存储的访问密钥和设置
Cron 任务配置 - 定时任务的密钥和超时设置

环境变量模板

以下是一个基本的环境变量模板，您可以根据实际情况进行修改：

# 基本配置
NEXT_PUBLIC_DEBUG=false
NEXT_PUBLIC_APP_URL=https://yourdomain.com

# Vercel Cron 配置
CRON_SECRET=your_cron_secret_key
TIMEOUT_SECONDS=790

# 数据库配置
DATABASE_URL=postgres://user:password@host/database

# Clerk 身份验证
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_your_publishable_key
CLERK_SECRET_KEY=sk_your_secret_key
CLERK_SIGN_IN_FALLBACK_REDIRECT_URL=/draw
CLERK_SIGN_UP_FALLBACK_REDIRECT_URL=/draw

# 支付系统配置
PAY_API_URL=https://epayapi.wxda.net
PAY_PID=your_payment_id
PAY_PUBLIC_KEY=your_payment_public_key
PAY_MERCHANT_PRIVATE_KEY=your_merchant_private_key
STRIPE_SECRET_KEY=sk_test_your_stripe_secret_key
STRIPE_WEBHOOK_SECRET=whsec_your_stripe_webhook_secret

# AI 模型配置
TUZI_API_URL=https://api.tu-zi.com/v1
TUZI_API_KEY=sk_your_tuzi_api_key
TUZI_MODEL_IMAGE=gpt-4o-image-vip
TUZI_MODEL_IMAGE_VIP=gpt-4o-image-vip
TUZI_MODEL_IMAGE_SMALL=gpt-4o-image
XAI_API_URL=https://api.xai.com/v1
XAI_API_KEY=xai-your_xai_api_key
XAI_API_MODEL_IMAGE=grok-2-image-latest
OPENAI_API_URL=https://api.openai.com/v1
OPENAI_API_KEY=sk_your_openai_api_key
OPENAI_MODEL_IMAGE=gpt-image-1
OPENAI_MODEL_IMAGE_SMALL=dall-e-3

# Cloudflare R2 存储配置
R2_ACCOUNT_ID=your_account_id
R2_ACCESS_KEY_ID=your_access_key_id
R2_SECRET_ACCESS_KEY=your_secret_access_key
R2_BUCKET_NAME=your_bucket_name
R2_PUBLIC_URL_PREFIX=https://your-bucket-name.r2.dev

配置指南

请点击以下链接，查看各项服务的详细配置指南：

注意事项

所有环境变量都应该保密，不要将包含实际密钥的 .env.local 文件提交到代码仓库
在部署到 Vercel 时，需要在 Vercel 项目设置中添加所有环境变量
某些服务（如 Stripe）在测试环境和生产环境使用不同的 API 密钥，请注意区分
定期更新 API 密钥以提高安全性