5 分钟创建第一个站点

本教程面向第一次使用 ReactPress 的终端用户，全程无需克隆仓库或配置 Docker。

第 1 步：安装 CLI

npm install -g @fecommunity/reactpress@beta

第 2 步：初始化站点

在任意空目录执行：

mkdir my-blog && cd my-blog
reactpress init

init 会自动完成：

1. 生成 .reactpress/config.json 与 .env
2. 初始化 SQLite 数据库
3. 启动 API、Admin 与默认主题
4. 在终端打印访问地址

成功后可看到类似输出：

服务	地址
访客站	http://localhost:3001
管理后台	http://localhost:3001/admin/
API	http://localhost:3002/api
健康检查	http://localhost:3002/api/health

第 3 步：登录 Admin

1. 浏览器打开 http://localhost:3001/admin/
2. 使用默认账号登录：admin / admin
3. 首次登录后请立即修改密码（设置 → 账户）

安全提示

生产环境切勿使用默认密码。部署前务必修改 ADMIN_USER / ADMIN_PASSWD 或在 Admin 中更新账户。

第 4 步：安装并启用主题

若访客站 :3001 尚未显示内容，在 Admin 中：

1. 进入 外观 → 主题
2. 从 catalog 安装 reactpress-theme-starter（或 hello-world 入门主题）
3. 点击 启用

启用后刷新 http://localhost:3001 即可看到访客站点。

第 5 步：发布第一篇文章

1. Admin 左侧 文章 → 新建
2. 填写标题与 Markdown 正文
3. 选择分类 / 标签（可选）
4. 点击右上角 发布
5. 在 http://localhost:3001 查看效果

图文步骤见 如何创建第一篇博客。

第 6 步：验证 API（可选）

curl http://localhost:3002/api/health

返回 {"status":"ok"} 表示 API 正常。Headless 接入见 Headless API 指南。

遇到问题？

reactpress doctor          # 环境与服务诊断
reactpress logs --follow   # 实时 API 日志
reactpress stop            # 停止服务后重新 init

更多排错见 故障排查。

接下来学什么？

你是…	推荐阅读
内容创作者	使用指南：内容管理
站点管理员	站点设置与 SEO
前端开发者	主题开发
全栈 / 集成	Headless API
准备上线	生产环境部署