🚀 部署指南
AstrNest 提供多种部署方式，您可以根据自己的需求选择最适合的方案：
部署方式对比
| 部署方式 | 适用场景 | 复杂度 | 推荐指数 | 状态 |
|---|---|---|---|---|
| 推荐部署 | 生产环境、团队使用 | ⭐⭐ | ⭐⭐⭐⭐⭐ | ✅ 可用 |
| Docker 部署 | 容器化部署、快速测试 | ⭐⭐ | ⭐⭐⭐⭐ | ✅ 可用 |
| 直接部署 | 开发环境、学习测试 | ⭐⭐⭐ | ⭐⭐⭐ | ✅ 可用 |
| Serverless 部署 | 云原生、弹性伸缩 | ⭐⭐⭐⭐ | ⭐⭐ | 🚧 开发中 |
环境要求
Docker 部署（推荐）
- Docker: 20.10+
- Docker Compose: 2.0+
- 至少 2GB 内存
- 至少 5GB 磁盘空间
传统部署
- Java: JDK 21+
- Node.js: 18+
- MySQL: 5.7+/8.0+
- 内存: 至少 2GB
- 磁盘空间: 至少 5GB
快速选择
部署前准备
无论选择哪种部署方式，都需要先完成以下准备工作：
1. 克隆项目
bash
git clone <repository-url>
cd AstrNest2. 配置环境变量
bash
# 复制环境变量模板
cp .env.example .env
# 编辑 .env 文件，配置必要参数
# 必须修改：数据库密码、管理员密码、站点域名3. 关键配置项
| 配置项 | 说明 | 示例 |
|---|---|---|
MYSQL_ROOT_PASSWORD | MySQL root 密码 | ChangeThisRootPass! |
MYSQL_PASSWORD | MySQL 应用密码 | ChangeThisDbPass! |
ASTRNEST_ADMIN_PASSWORD | 管理员密码 | StrongAdminPass123! |
PUBLIC_SITE_URL | 站点域名 | https://yourdomain.com |
VITE_API_BASE_URL | API 地址 | http://localhost:8080 |
⚠️ 安全提示：请勿使用默认密码，生产环境务必使用强密码！
部署流程概览
Docker Compose 部署流程
bash
# 1. 配置环境变量
cp .env.example .env
# 编辑 .env 文件
# 2. 启动服务
docker compose --env-file .env up -d
# 3. 验证部署
curl http://localhost:8080/actuator/health传统部署流程
bash
# 1. 初始化数据库
mysql -u root -p < backend/db/init.sql
# 2. 启动后端
cd backend
./mvnw spring-boot:run
# 3. 启动前端（新终端）
cd frontend
npm install
npm run dev默认访问地址
部署完成后，可以通过以下地址访问：
| 服务 | 地址 | 说明 |
|---|---|---|
| 前端界面 | http://localhost | Web UI |
| 后端 API | http://localhost:8080 | REST API |
| API 文档 | http://localhost:8080/swagger-ui/index.html | Swagger UI |
| 健康检查 | http://localhost:8080/actuator/health | 服务状态 |
默认管理员账号
- 用户名:
admin - 密码:
chenxi123
⚠️ 重要：首次登录后请立即修改默认密码！
生产环境检查清单
部署到生产环境前，请确认以下事项：
- [ ] 修改了所有默认密码（数据库、管理员）
- [ ] 配置了正确的站点域名
- [ ] 启用了 HTTPS/SSL
- [ ] 配置了邮件服务
- [ ] 配置了 AI 内容审核（可选）
- [ ] 配置了数据备份策略
- [ ] 配置了监控告警
- [ ] 配置了防火墙规则
获取帮助
如果在部署过程中遇到问题：
选择适合您的部署方式开始使用 AstrNest！