文档高级开发者设置

开发者设置

在本地设置 Draftly 代码库,用于开发或自托管。

先决条件

要在本地运行 Draftly,您需要: - 带有 npm 或 pnpm 的 Node.js 18+ - 一个 Firebase 项目(已启用 Firestore、Auth、Storage) - API 密钥:Google Gemini、Fal.ai(可选)、API-Easy(用于 Veo 视频和 Nano Banana 图像) - 一个 Dodo Payments 账户(用于账单 webhook — 开发时可选)

克隆与安装

bash
git clone https://github.com/draftly-space/draftly-client.git
cd draftly-client
npm install
cp .env.example .env.local

使用您的 Firebase 配置和 API 密钥编辑 .env.local,然后运行开发服务器。

环境变量

变量描述必需
GOOGLE_AI_KEY用于网站 HTML 生成的 Gemini API 密钥
NEXT_PUBLIC_FIREBASE_*Firebase 客户端配置(6 个变量)
FIREBASE_SERVICE_ACCOUNTFirebase Admin SDK JSON (base64)
FAL_KEYFal.ai — Seedream 图像,LTX 视频扩展用于完整媒体
APIEASY_KEYAPI-Easy — Veo 3.1 视频,Nano Banana 图像用于视频
DODO_PAYMENTS_KEYDodo Payments 账单 webhook 密钥用于账单
CLOUDFLARE_ZONE_ID用于发布时清除 CDN 缓存的 Cloudflare 区域用于 CDN

运行开发服务器

bash
npm run dev

打开 http://localhost:3000。3D 构建器位于 http://localhost:3000/3d-builder