Vibany-2：项目开发部署-账号准备

欢迎访问 Ship Vibany 项目，本篇我们将介绍 Vibany 开发部署相关信息，包括部署 Web 项目前所需的域名、数据库、对象存储、支付与 AI 模型等账号与 API 密钥的完整准备流程

---

本节内容

• 必要服务的注册
  • ENV：.env.example
  • 文档：manuals/quickstart

准备好以下内容：

• GitHub 账号
• 域名
  • 填写：NEXT_PUBLIC_APP_URL
  • 购买：Namecheap、Cloudflare
• Vercel 账号（推荐使用 Pro 计划）
  • 注册：https://vercel.com/
  • CRON_SECRET：https://vercel.com/docs/cron-jobs
  • TIMEOUT_SECONDS：
    • Project Settings – Functions – Fluid Compute
    • 免费版设置为 60（不够用）
    • Pro 版设置为 790
    • VPS 部署则设置为 2000
• Clerk 账号（用于用户管理）
  • 注册用户 – 创建项目 – Set your Clerk API keys
    • NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_
    • CLERK_SECRET_KEY=sk_
    • 注意：
      • pk_test_ 开头为 development 环境
      • 生产服需要 create production instance（需要有域名）
        • pk_live_ 开头的 key
        • 跟随引导操作/在群里讨论（推荐）
        • 查看文档
  • 保持不变的 env
    • CLERK_SIGN_IN_FALLBACK_REDIRECT_URL=/draw
    • CLERK_SIGN_UP_FALLBACK_REDIRECT_URL=/draw
• Neon PostgreSQL 数据库账号
  • DATABASE_URL：PostgreSQL 数据库连接地址
  • 可注册的服务：
    • Neon
      • 新建 Project
      • Dashboard – Connect
      • Copy snippet
    • Supabase
      • 创建 Project
      • 保存好密码
      • Connect – Direct Connection
      • 复制地址 – 替换密码
    • 自建
• Cloudflare 账号（用于 R2 对象存储）
  • 登录：https://dash.cloudflare.com/login
  • 相关 env：# Cloudflare R2 Storage
    • R2 对象存储
    • 创建存储桶
    • API – 管理 API 令牌
    • R2_ACCOUNT_ID=endpoint 中 url 的第一部分
    • R2_ACCESS_KEY_ID=访问密钥 ID
    • R2_SECRET_ACCESS_KEY=机密访问密钥
    • R2_BUCKET_NAME=存储桶 id（推荐全小写英文名）
    • R2_PUBLIC_URL_PREFIX
      • 存储桶
      • 设置
      • 自定义域 – 添加 – cname 配置（推荐）
        • url 要加 https:// 前缀
      • 公共开发 URL – 启用（不推荐）
• AI 模型 API 密钥（Tuzi、XAI 或 OpenAI）
  • 兔子
    • TUZI_API_URL=https://api.tu-zi.com/v1
    • TUZI_API_KEY=在 https://api.tu-zi.com/token 创建
    • TUZI_MODEL_IMAGE_SMALL=gpt-4o-image
    • TUZI_MODEL_IMAGE=gpt-4o-image-vip
    • TUZI_MODEL_IMAGE_VIP=gpt-4o-image-vip
    • 如有需要则改动下面的环境变量，否则跟 default 分组保持一致
      • TUZI_OPENAI_API_URL=https://api.tu-zi.com/v1
      • TUZI_OPENAI_API_KEY=
      • TUZI_OPENAI_MODEL_IMAGE=gpt-image-1
  • XAI 和 OpenAI 的相关配置
    • 配置 constants/draw/models.ts
    • XAI 对应 draw-model-grok-2（设置 disabled 为 true 可关闭）
    • OpenAI 对应 draw-model-raw-openai（设置 disabled 为 true 可关闭）
    • 模型选项关闭后可以不改相关的 env
  • 火山
    • 开通管理 – 一键开通所有模型
    • API Key 管理 – 创建 API Key
• 支付服务账号（支付宝/微信支付或 Stripe）
  • NEXT_PUBLIC_WXPAY_DISABLED=设置为 on 则禁用
  • NEXT_PUBLIC_ALIPAY_DISABLED=设置为 on 则禁用
  • NEXT_PUBLIC_STRIPE_DISABLED=设置为 on 则禁用
  • 微信/支付宝：dulupay
    • 注册
    • 支付通道 – 申请签约
    • 授权域名
    • 客服
    • 获取 API
      • PAY_PID=商户 ID
      • PAY_PUBLIC_KEY=平台公钥
      • PAY_MERCHANT_PRIVATE_KEY=商户私钥（在 商户后台->个人资料->API信息 页面，点击【生成商户RSA密钥对】，生成后注意保存【商户私钥】。对接接口时只需要用到【平台公钥】与【商户私钥】。）
  • 信用卡/国际：stripe

项目开发（后续）

• 依赖服务
  • 数据库：PostgreSQL，比如 Neon
  • 服务器：Vercel 或自有 VPS
  • 文件存储：Cloudflare R2
  • API：openai image model
• 环境变量：manuals/quickstart
• 本地开发：manuals/quickstart

项目部署（后续）

• 部署文档 https://ship.vibany.com/manuals/deployment/

---

相关链接：

• 官方网站：https://ship.vibany.com
• 产品地址：https://cn.vibany.com
• 产品手册：https://ship.vibany.com/manuals