快速开始
Zenith Admin 是一个基于 Hono + React 19 + Drizzle ORM 的 npm monorepo 项目。
如果你想在本地把项目和文档站都跑起来,建议按下面的顺序执行。
环境要求
- Node.js >= 18
- npm
- PostgreSQL
- Redis(用于会话持久化,默认连接本地
127.0.0.1:6379)
安装依赖
在仓库根目录执行:
bash
npm install配置环境变量
后端 packages/server/.env
ini
DATABASE_URL=postgresql://postgres:postgres@localhost:5432/zenith_admin
JWT_SECRET=your-secret-key
PORT=3300
# Redis 连接(默认连接本地无密码 Redis)
REDIS_URL=redis://127.0.0.1:6379
# 带密码示例: REDIS_URL=redis://:your_password@127.0.0.1:6379/0
# REDIS_KEY_PREFIX=zenith: # 所有 key 的命名空间前缀(默认 zenith:)前端 packages/web/.env
ini
VITE_API_BASE_URL=http://localhost:3300
VITE_APP_TITLE=Zenith Admin初始化数据库
bash
npm run db:migrate
npm run db:seed启动业务项目
bash
# 同时启动后端与前端
npm run dev
# 或分别启动
npm run dev:server
npm run dev:web默认地址:
- 后端:
http://localhost:3300 - 前端:
http://localhost:5373
启动文档站
bash
npm run docs:dev默认地址:http://localhost:4177