# 🚀 快速开始 - Filament Admin

## 一键部署（推荐）

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

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

# 2. 部署服务
make deploy

# 3. 验证部署
make verify
```

### 方法 2：使用脚本

```bash
# 1. 构建
./build.sh

# 2. 部署
./deploy.sh

# 3. 验证
./verify.sh
```

### 方法 3：使用 Docker Compose

```bash
# 构建并启动
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**

---

## 🔧 常用命令

```bash
# 查看日志
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` 文件：

```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
```

---

## 🔍 故障排除

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

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

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

### 查看详细日志
```bash
make logs
```

---

## 📚 更多文档

- 完整部署指南：[DEPLOYMENT.md](./DEPLOYMENT.md)
- 架构说明：[README.md](./README.md)

---

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