math_cms/QUICKSTART.md

🚀 快速开始 - Filament Admin

一键部署（推荐）

方法 1：使用 Make 命令（最简单）

# 1. 构建镜像（国内加速）
make build

# 2. 部署服务
make deploy

# 3. 验证部署
make verify

方法 2：使用脚本

# 1. 构建
./build.sh

# 2. 部署
./deploy.sh

# 3. 验证
./verify.sh

方法 3：使用 Docker Compose

# 构建并启动
docker compose -f docker-compose.prod.yml up -d --build

# 查看状态
docker compose -f docker-compose.prod.yml ps

---

📋 系统要求

• Docker >= 20.10
• Docker Compose >= 2.0
• 内存 >= 1GB
• 磁盘空间 >= 2GB

---

🌐 访问应用

部署完成后，访问：http://localhost:5019/admin

---

🔧 常用命令

# 查看日志
make logs
# 或
docker compose -f docker-compose.prod.yml logs -f

# 重启服务
make restart
# 或
docker compose -f docker-compose.prod.yml restart

# 停止服务
make stop
# 或
docker compose -f docker-compose.prod.yml down

# 启动服务
make up
# 或
docker compose -f docker-compose.prod.yml up -d

---

⚙️ 配置环境

编辑 .env 文件：

APP_NAME="Filament Admin"
APP_ENV=production
APP_DEBUG=false
APP_URL=http://your-domain.com

# 数据库配置
DB_CONNECTION=mysql
DB_HOST=mysql
DB_PORT=3306
DB_DATABASE=filament_admin
DB_USERNAME=root
DB_PASSWORD=your_password

---

🔍 故障排除

端口被占用

# 查看端口占用
lsof -i :5019

# 修改端口（编辑 docker-compose.prod.yml）
ports:
  - "8080:8000"  # 改为 8080

权限问题

# 修复权限
sudo chown -R $USER:$USER storage bootstrap/cache
chmod -R 775 storage bootstrap/cache

查看详细日志

make logs

---

📚 更多文档

• 完整部署指南：DEPLOYMENT.md
• 架构说明：README.md

---

优化亮点：

• ✅ 国内镜像加速（构建时间 5-8 分钟）
• ✅ 镜像体积优化（~400MB）
• ✅ 前端预编译（无需手动构建）
• ✅ 生产级缓存优化