06. 首次初始化你的系统

恭喜你。

如果你已经走到这一章，说明：

• 资源已经创建了
• Worker 已经部署了
• Pages 也已经部署了

但是系统还不能算真正可用。

你还要做第一次初始化。

0. 这一步建议开着 Dev Console

建议你把 Dev Console 继续开着。

为什么：

• 你登录后台时，如果某个后端接口报错
• 你可以立刻去 本地启动 或日志区域看服务输出
• 不用来回切一堆终端窗口

1. 先登录后台

后台地址一般是：

• https://admin.example.com

当前后台的管理员登录，不是”邮箱 + 密码”。

而是：

• 直接输入 ADMIN_SECRET

这个值就是你在：

• backend/node1-auth-service/wrangler.jsonc

里设置的那个管理员密钥。

如果你忘了自己填了什么

回去看你刚才填的 ADMIN_SECRET。

如果登录一直 401

通常只有 3 种可能：

1. 你输入错了
2. 线上部署的 ADMIN_SECRET 不是你现在看到的值
3. node1-auth-service 根本没重新部署

2. 第一遍请先创建一个 demo 项目

进入后台后，先打开：

• Projects

然后创建第一个项目。

第一遍推荐这样填

• app_key: demo
• name: 你的产品名
• domain: 你的主站域名

为什么第一遍推荐 demo：

• 仓库很多默认值就是 demo
• 你先用它把流程跑通，最省事

等你确认系统完全没问题，再把前端环境变量切到你自己的 app_key。

3. 如果你要开支付，继续配支付通道

进入后台：

• Pay Channels
• Price Config

你至少要做这几件事：

1. 新增 Stripe 或 Creem 通道
2. 把 demo 项目绑定到这个支付通道
3. 给 demo 创建价格方案

如果你不做这一步：

• 定价页可能能打开
• 但用户无法真正完成支付

4. 如果你要开 AI，继续配模型

进入后台：

• AI

你需要至少确认：

• AI Gateway 已经配置
• 至少有一个模型启用
• 模型有价格配置

如果你不做这一步：

• AI 聊天页面可能能打开
• 但发消息时会报错

5. 如果你要让官网更像一个真站点，补这几块内容

进入后台后，建议至少补下面几块：

• Banners
• Friend Links
• Blog
• Templates

这样你的站点不会一打开就是空壳子。

6. 检查签到、支持、通知这些辅助模块

不是第一天必须，但建议你至少看一眼：

• Check-in Schedule
• Notifications
• Notify Settings
• Tickets
• Feedback

这样你能更快发现哪个服务没有连通。

7. 如果你准备切到自己的 app_key

等 demo 已经跑通以后，再做下面的事情：

1. 在后台新建你自己的项目，例如 mybrand
2. 把支付、价格、AI、横幅、博客内容也配置到这个 app_key
3. 去 Pages 项目里把 APP_KEY 从 demo 改成 mybrand
4. 重新部署对应前端

不要反过来做。

很多人一上来就把前端改成自己的 app_key，但后台还没建这个项目。

最后看到的就是：

• 页面能打开
• 数据全是空
• 自己还不知道为什么

8. 这一章结束前，你应该已经满足的条件

• 你能用 ADMIN_SECRET 登录后台
• 后台里已经有一个 demo 项目
• 如果你要支付，支付通道已经配置
• 如果你要 AI，模型配置已经补好