Skip to content

快速开始

环境要求

  • Node.js 20+(推荐 22;VitePress 2 依赖正则 /v 标志,Node 16/18 会直接报错)
  • MySQL(初始化脚本可用仓库 / 项目中的 pangza_admin.sql
  • Redis(限流 / 防重复提交需要;Auth 会话默认可走内存)

安装后端

bash
cd pangza-admin-express
npm install
bash
cp .env.example .env

关键变量见 环境配置。至少配置好 MySQL;开启加密或使用限流/防重时请保证 Redis 可用。

启动

bash
npm run dev      # 热重载,默认端口 3990
npm run build
npm start

验证接口

公开配置:

bash
curl http://localhost:3990/api/sys_config/public

登录(账号以库内数据为准):

bash
curl http://localhost:3990/api/user/login \
  -H "Content-Type: application/json" \
  -d "{\"username\":\"admin\",\"password\":\"你的密码\"}"

统一响应:

json
{
  "code": 200,
  "message": "操作成功",
  "data": {}
}

受保护接口在请求头携带 Authorization: <token>。鉴权细节见 Auth

启动管理端(可选)

bash
cd pangza-admin-ui
npm install
npm run dev

说明见 管理端 UI

本地预览本文档

bash
cd pangza-admin-express-doc
npm install
npm run docs:dev

下一步

基于 VitePress 构建