ZuSpaceX

赛博像素风个人主站 · 全栈开源

官方文档 · 在线体验

ZuSpaceX 是一套围绕内容展示 + 内容管理 + AI 问答设计的全栈个人主站系统，赛博像素风，页面美观精致，适合作为个人品牌站点的二开基础。

zuSpaceX/
├── client/               # React + Vite 前端
│   └── src/
│       ├── pages/        # 公开站点页面
│       ├── admin/        # 管理后台页面
│       ├── components/   # 通用组件
│       ├── api/          # 接口封装
│       └── router/       # 路由配置
├── server/               # NestJS 服务端
│   └── src/
│       ├── modules/      # 业务模块（article / project / agent …）
│       ├── entities/     # TypeORM 实体
│       └── common/       # 中间件、过滤器、日志
├── docs/                 # VitePress 文档站
├── build.sh              # 前后端联合构建
└── Dockerfile            # Docker 容器化部署

环境要求：

• Node.js ≥ 18
• pnpm ≥ 8
• MySQL 8.x

# 服务端
cd server
pnpm install
npm run start:dev

# 前端（新终端）
cd client
pnpm install
pnpm run dev

bash build.sh

脚本依次构建前端、将产物并入服务端，最终产物在 server/dist。将 server/dist、server/views、server/public、server/package.json 上传至服务器，在服务器上执行：

npm run start:prod

Dockerfile 内已包含前后端完整构建逻辑，推送代码到容器部署平台后平台会自动完成构建和部署，无需本地预先构建。

docker build -t zuspace . && docker run -p 8080:8080 zuspace

• 当前项目不包含数据库，运行前请先手动建库建表，使用 /sql 下的建表语句。
• 建表完成后需要在项目中完成数据库账号的配置
• 具体接入配置在 server/src/config/mysql.config.ts，具体操作见文档

• 当前项目的作者分身能力底层依赖大模型，当前项目内不包含模型配置，请先配置个人的模型 api-key
• 具体接入配置在server/src/modules/agent/llm.config.ts，具体操作见文档

首页

坦克大战

博客列表

博客详情

项目展示

留言板

个人中心

AI 分身聊天

后台管理

原创设计，独立开发，部分图片 AI 生成，欢迎交流学习，也欢迎关注我的公众号。

CC BY-NC 4.0 - 个人使用，禁止商业用途