git clone https://github.com/vibany-shipping/vibany-next
cd vibany-next
npm install
要在本地运行应用程序,您需要:
.env 文件 中所示设置所需的环境变量。npm install 安装所需依赖项。npm run dev 启动开发服务器。在根目录中创建一个 .env.local 文件,包含以下变量:
# 调试模式
NEXT_PUBLIC_DEBUG=
# 应用URL
NEXT_PUBLIC_APP_URL=https://yourdomain.com
# Vercel Cron 任务密钥(用于保护定时任务API)
CRON_SECRET=your_cron_secret_key
# Cron 任务超时时间(秒)
TIMEOUT_SECONDS=790
# Neon PostgreSQL 数据库连接URL
DATABASE_URL=postgres://user:password@host/database
# Clerk 公钥和密钥
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_your_publishable_key
CLERK_SECRET_KEY=sk_your_secret_key
# 登录和注册后的重定向URL
CLERK_SIGN_IN_FALLBACK_REDIRECT_URL=/draw
CLERK_SIGN_UP_FALLBACK_REDIRECT_URL=/draw
# 支付宝/微信支付API配置
PAY_API_URL=https://api.dulupay.com
PAY_PID=your_payment_id
PAY_PUBLIC_KEY=your_payment_public_key
PAY_MERCHANT_PRIVATE_KEY=your_merchant_private_key
# Stripe支付配置
STRIPE_SECRET_KEY=sk_test_your_stripe_secret_key # 测试环境使用sk_test_,生产环境使用sk_live_
STRIPE_WEBHOOK_SECRET=whsec_your_stripe_webhook_secret # Stripe webhook签名密钥
AI 模型的配置包括 Tuzi、XAI 和 OpenAI 的 API 配置。
# Tuzi API配置
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配置
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配置
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 存储注册
# 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
Vercel 注册地址:https://vercel.com
本项目使用 Vercel 进行部署,需要特别注意以下配置:
.env.local 中的环境变量项目根目录下的 vercel.json 文件包含以下重要配置:
{
"functions": {
"app/api/**/*": {
"maxDuration": 800
}
},
"crons": [
{
"path": "/api/public/clear",
"schedule": "*/5 * * * *"
},
{
"path": "/api/public/backup?type=hourly",
"schedule": "0 * * * *"
},
{
"path": "/api/public/backup/fix",
"schedule": "15,45 * * * *"
}
]
}
maxDuration: 800:设置 API 路由的最大执行时间为 800 秒(约 13 分钟)项目配置了以下定时任务:
/api/public/clear)/api/public/backup?type=hourly)/api/public/backup/fix)重要提示:Vercel 的 Cron Jobs 功能需要 Pro 或 Enterprise 计划才能使用。
在 Vercel 部署时,需要手动配置以下内容:
环境变量设置:
.env.local 中的环境变量项目设置:
npm run build 作为构建命令.next,通常不需要修改域名配置:
付费计划升级:
本项目集成了支付系统,需要特别注意以下配置:
申请支付接口:
PAY_PID、PAY_PUBLIC_KEY 和 PAY_MERCHANT_PRIVATE_KEY支付宝/微信支付回调配置:
https://yourdomain.com/api/public/epay/notifyStripe 支付配置:
STRIPE_SECRET_KEY)https://yourdomain.com/api/public/stripe/notifycheckout.session.completed 和 payment_intent.succeededSTRIPE_WEBHOOK_SECRET)支付安全:
Vercel 相关费用:
数据库费用:
存储费用:
API 调用费用:
Clerk 费用:
支付系统费用:
本地开发:
npm run dev
构建项目:
npm run build
部署到 Vercel:
npm i -g vercel
vercel
项目使用 Drizzle ORM 进行数据库管理(以下操作在生产构建时会自动完成):
生成迁移文件:
npm run db:generate
应用迁移:
npm run db:migrate
注意:不要手动创建 @drizzle/migrations/ 目录下的 SQL 文件,这些文件由 Drizzle ORM 自动生成。
函数执行超时:
vercel.json 中的 maxDuration 设置正确环境变量问题:
Cron 任务未执行:
支付宝/微信支付回调失败:
Stripe Webhook 通知失败:
STRIPE_WEBHOOK_SECRET 是否正确配置stripe listen --forward-to localhost:3000/api/public/stripe/notify订单状态不同步:
AI 模型调用失败:
存储问题: