快速开始

本指南将帮助您快速上手 Ship Vibany，从获取代码到部署上线，只需几个简单步骤。

前置条件

在开始之前，请确保您已准备好以下内容：

• GitHub 账号
• Vercel 账号（推荐使用 Pro 计划）
• Clerk 账号（用于用户管理）
• Neon PostgreSQL 数据库账号
• Cloudflare 账号（用于 R2 对象存储）
• 支付服务账号（支付宝/微信支付或 Stripe）
• AI 模型 API 密钥（Tuzi、XAI 或 OpenAI）

步骤 1：获取代码

首先，克隆项目代码库并安装依赖：

git clone https://github.com/vibany-shipping/vibany-next
cd vibany-next
npm install

步骤 2：配置环境变量

在项目根目录创建一个 .env.local 文件，并按照 .env.example 文件的示例配置所有必要的环境变量。

主要环境变量包括：

• 基本配置（应用 URL 等）
• 数据库连接信息
• Clerk 认证密钥
• 支付系统配置
• AI 模型 API 配置
• Cloudflare R2 存储配置

详细的环境变量配置请参考环境配置章节。

步骤 3：本地开发测试

配置完环境变量后，启动开发服务器进行本地测试：

npm run dev

访问 http://localhost:3000 查看应用运行情况。

步骤 4：部署到 Vercel

确认本地测试无误后，将应用部署到 Vercel：

1. 在 Vercel 控制台创建新项目
2. 连接到您的 GitHub 仓库
3. 配置所有环境变量
4. 点击部署按钮

详细的部署步骤请参考Vercel 部署章节。

步骤 5：配置域名

部署成功后，为您的应用配置自定义域名：

1. 在 Vercel 项目设置中添加自定义域名
2. 按照 Vercel 提供的说明配置 DNS 记录
3. 等待 DNS 生效（通常需要几分钟到几小时）

详细的域名配置请参考域名配置章节。

后续步骤

完成以上步骤后，您的应用已经成功上线！接下来您可以：

• 配置管理员账号
• 设置产品价格和套餐
• 自定义网站内容
• 开始营销和推广

更多详细信息，请参考运营管理章节。