CLI：开始之前

本章覆盖部署命令执行前的准备工作，请勿跳过。

1. 你要部署的是什么

ZShip 不是单页项目，它包括：

• 10 个后端 Worker
• 2 个前端应用（web 和 admin）
• 9 个 D1 数据库
• 1 个 KV namespace（支付服务）
• 1 个 R2 bucket（CDN 服务）

你部署的是基于 Cloudflare 的完整系统，而不是一个网站。

2. 需要的账号

至少需要：

• Cloudflare 账号
• Git 仓库副本
• 能运行 Node.js 的机器

可选：

• Stripe 账号（支付）
• Creem 账号（Creem 支付）
• Google OAuth 应用（Google 登录）

3. 如何获取源码

方式 A：GitHub Fork

1. 将官方模板 fork 到你的 GitHub 账号或组织
2. 克隆你的 fork 到本地

优点：保留上游关系；后续同步更新更方便。

方式 B：复制后新建仓库

1. 下载官方代码
2. 新建 Git 仓库
3. 推送代码

优点：历史更干净；更像自己的项目。

推荐使用 GitHub Fork 以便长期维护。

4. 安装本地工具

确保已安装：

• Node.js 22 或更高
• pnpm
• Git

验证：

node -v
pnpm -v
git --version

5. 克隆并安装依赖

git clone <你的仓库地址>
cd zship
pnpm install

6. 登录 Wrangler

npx wrangler login

授权后验证：

npx wrangler whoami

7. 第一遍部署不要改

• Worker 名称：保持 zship-node1-auth、zship-node2-support 等
• Pages 项目名：保持 web 和 admin
• app_key：先用 demo，系统跑通后再换成你的真实 key

8. 检查清单

继续之前确认：

• 已决定 Fork 还是复制
• 仓库已克隆到本地
• pnpm install 已完成
• npx wrangler login 和 npx wrangler whoami 成功
• 第一遍会保持默认服务名