# 03 运维与排障

## 日志

```bash
docker compose logs -f backend
docker compose logs -f worker
docker compose logs -f frontend
docker compose logs -f minio
```

## 健康检查

```bash
curl http://localhost:8000/health
curl -I http://localhost:3000
curl http://localhost:9000/minio/health/live
```

## 备份

PostgreSQL：

```bash
docker compose exec postgres pg_dump -U seguser segserver > segserver.sql
```

MinIO 数据：

```bash
docker run --rm -v seg_server_docker_minio-data:/data -v "$PWD":/backup alpine \
  tar czf /backup/minio-data.tgz -C /data .
```

## 恢复

PostgreSQL：

```bash
cat segserver.sql | docker compose exec -T postgres psql -U seguser segserver
```

MinIO：先停止服务，再恢复数据卷内容。

```bash
docker compose down
docker run --rm -v seg_server_docker_minio-data:/data -v "$PWD":/backup alpine \
  sh -c 'cd /data && tar xzf /backup/minio-data.tgz'
docker compose up -d
```

## 常见问题

### 页面能打开，但图片或帧缩略图打不开

检查 `.env` 的 `PUBLIC_HOST`。它必须是浏览器可访问的主机名或 IP。修改后执行：

```bash
docker compose up -d --build backend worker
```

### 前端请求后端失败

检查 `CORS_ORIGINS` 是否包含当前前端访问地址，例如：

```env
CORS_ORIGINS=["http://192.168.3.11:3000","http://localhost:3000"]
```

### AI 模型不可用

最小镜像默认不安装 PyTorch/SAM2，也不包含权重。普通标注功能不受影响。需要 AI 推理时按 `doc/02-deployment.md` 扩展 GPU 镜像并挂载权重。

### 恢复演示出厂设置失败

确认演示文件存在：

```bash
ls demo/演视LC视频序列.mp4
ls demo/演视DICOM序列/*.dcm
```

缺少演示文件时，系统仍可正常使用，但恢复演示出厂设置会提示找不到演示数据。