快速开始
环境要求
- Node.js 20+(推荐 22;VitePress 2 依赖正则
/v标志,Node 16/18 会直接报错) - MySQL(初始化脚本可用仓库 / 项目中的
pangza_admin.sql) - Redis(限流 / 防重复提交需要;Auth 会话默认可走内存)
安装后端
bash
cd pangza-admin-express
npm installbash
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