# 相册无法访问排查记录（2026-09-10）

## 现象
- 用户反馈相册 http://192.168.31.76:8900 无法访问。

## 排查过程
| 检查项 | 结果 |
|---|---|
| 进程 `sync-agent.js` / `server.js` | **均不存在** |
| 端口 8900 监听 | 未监听 |
| 本机/局域网 HTTP | 均超时（HTTP 000） |
| 本机是否重启 | 否（uptime 20 天 15 小时） |
| web.log / sync.log | 无任何报错；sync 最后一条 2026-09-10 01:36 CST（UTC 17:36），此后两个进程同时消失 |
| 系统 OOM 记录（dmesg/journalctl） | 未找到（可能已被 19 小时日志轮转覆盖） |
| crontab | 本用户之前无任何定时任务（排除外部 cron 误杀） |

## 结论
- **根因未完全定位**：非重启、非崩溃日志、无 OOM 实锤。两进程在同一时刻静默消失，最可能是当时内存压力触发 OOM 或被外部 SIGKILL，记录已被轮转覆盖。
- 当前内存充足（11Gi 可用），负载正常。

## 处置
1. **已恢复服务**：`galleryctl.sh start` 拉起 sync-agent + server，本地与局域网 HTTP 200，缩略图预热 370 条正常入队。
2. **新增保活机制**：`~/Downloads/comfyui-gallery/watchdog.sh` + 用户 crontab 每分钟执行——
   - 检测：8900 端口无响应 **或** sync-agent 进程缺失 → 自动拉起整个相册；
   - 日志：`/home/zyw/Downloads/gallery-watchdog.log`；
   - 已实测：主动停服 → watchdog 检测 → 自动拉起成功（2026-09-10 20:28 记录）。

## 建议
- 若再次出现"两进程同时消失"，优先查 `gallery-watchdog.log` 的拉起时间点，并配合当时内存压力判断是否 OOM。
- 可考虑给相册做 systemd 单元（Restart=always），比 cron 保活更稳；需要时说一声即可迁移。