math_cms/QUICK-REF.md

🚀 快速参考 - Filament Admin 部署

一键部署（3 步完成）

# 1️⃣ 检查配置
make check-config

# 2️⃣ 构建镜像
make build

# 3️⃣ 部署服务
make deploy

完整流程

📋 部署前准备

# 检查系统要求
make check-config

# 或手动检查
./check-config.sh

🏗️ 构建镜像

# 方法 1：使用 Make（推荐）
make build

# 方法 2：使用脚本
./build.sh

# 方法 3：直接 Docker
docker compose -f docker-compose.prod.yml build --no-cache

🚀 部署应用

# 方法 1：使用 Make（推荐）
make deploy

# 方法 2：使用脚本
./deploy.sh

# 方法 3：直接 Docker
docker compose -f docker-compose.prod.yml up -d

✅ 验证部署

# 方法 1：使用 Make
make verify

# 方法 2：使用脚本
./verify.sh

# 方法 3：手动验证
curl http://localhost:5019/admin
docker compose -f docker-compose.prod.yml ps

🔧 常用操作

查看状态

# 容器状态
docker compose -f docker-compose.prod.yml ps

# 实时日志
make logs
# 或
docker compose -f docker-compose.prod.yml logs -f

# 最近 100 行日志
docker compose -f docker-compose.prod.yml logs --tail=100

启停操作

# 重启
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

清理资源

# 清理容器和镜像
make clean
# 或
docker compose -f docker-compose.prod.yml down -v
docker system prune -f

🌐 访问信息

• 管理后台：http://localhost:5019/admin
• 健康检查：docker compose -f docker-compose.prod.yml ps

⚙️ 重要配置

.env 文件关键配置

APP_ENV=production         # 生产环境
APP_DEBUG=false            # 关闭调试
APP_URL=http://localhost:5019

DB_CONNECTION=sqlite       # 或 mysql/pgsql
KNOWLEDGE_API_BASE=...     # 知识图谱 API 地址
QUESTION_BANK_API_BASE=... # 题库 API 地址

端口修改

编辑 docker-compose.prod.yml：

ports:
  - "8080:8000"  # 改为您需要的端口

使用 MySQL 数据库

1. 编辑 .env：

   DB_CONNECTION=mysql
   DB_HOST=mysql
   DB_PORT=3306
   DB_DATABASE=filament_admin
   DB_USERNAME=filament_user
   DB_PASSWORD=your_password
   

2. 取消 docker-compose.prod.yml 中 MySQL 服务注释

🐛 故障排除

端口占用

# 查看占用进程
lsof -i :5019

# 解决：修改端口或停止占用进程

权限错误

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

构建失败

# 清理重新构建
docker system prune -a
make build

查看详细错误

make logs

📚 更多资源

• 📖 详细部署指南
• 🚀 快速开始
• 📊 部署总结

📞 支持命令

# 查看所有命令
make help

# 检查配置
make check-config

# 验证部署
make verify

---

提示：生产环境部署前，请务必：

1. ✅ 修改 .env 中的 API 地址
2. ✅ 设置强密码
3. ✅ 配置域名和 SSL
4. ✅ 设置定期备份