# gpu-local 基础设施

**主机**：jixian@gpu-local（LAN: 192.168.0.190）  
**GPU**：RTX 4090  
**用途**：ComfyUI 图像/视频生成、LightRAG 知识图谱、Caddy 反代

## 主要服务

| 服务 | 端口 | 访问地址 |
|------|------|----------|
| ComfyUI (gpu0) | 8188 | comfyui.suchka.me |
| ComfyUI (gpu1/cuda:1) | 8189 | comfyui-gpu1.suchka.me |
| LightRAG | 9621 | lightrag.dev.suchka.me |
| Caddy 反代 | 80/443 | — |
| Velvet 网站 | 8099 | velvet.dev.suchka.me |
| Branding 网站 | 8100 | branding.dev.suchka.me |
| CineCog 前端 | 3100（本机） | cinecog.dev.suchka.me |

## ComfyUI Docker 挂载

| 容器路径 | 宿主路径 | 持久化 |
|----------|----------|--------|
| `/root/ComfyUI` | `~/work/comfyui/ComfyUI` | ✅ |
| `/root/.local` | `~/work/comfyui/python-packages` | ✅ |
| `/root/user-scripts/` | 无挂载 | ❌ 重启消失 |

⚠️ pip install 前必须 `export PIP_USER=true`

### 双 GPU 性能问题排查（2026-04-23）
- **现象**：双 GPU 运行时出现 VRAM 消耗异常和 OOM。
- **根因**：错误修改了 `docker-compose.yml` 限制单卡执行（`device_ids: ['0']`, `CUDA_VISIBLE_DEVICES=0`, `--normalvram`），导致单卡显存压力过大。
- **规范**：必须保持 `count: all`, `CUDA_VISIBLE_DEVICES=0,1` 和 `--highvram` 配置以实现正常的双卡并行调度。修改配置前务必本地备份并同步给 Jixian。

## Caddy 配置

- 配置文件：`/proj/share/etc/caddy/Caddyfile`
- wildcard DNS：`*.dev.suchka.me` 和 `*.ai.regdesk.co` → gpu-local
- 修改后：`docker exec caddy caddy reload --config /etc/caddy/Caddyfile`
- 密码哈希（admin）：`$2a$14$lTncftLfSU4jgkKEbNNNFexjpMhFf9TlAal/O99Dk9iilVEHhg5lW`

## LightRAG

- Docker 容器：`kai-lightrag`
- 镜像：`ghcr.io/hkuds/lightrag:latest`
- 数据持久化：Docker volume
- WebUI：https://lightrag.dev.suchka.me（admin/jixiandasha）
- 查询工具：`lightrag-query__lightrag_query`

## 文件交换

- 临时目录：`/storage/tmp_exchange/`
- ⚠️ 用完必须立即清理

## 相关

- [AI-视频生产管线](AI-视频生产管线.md)
- [CineCog-Studio](../entities/CineCog-Studio.md)