Immich 日志排查实战从备份卡住到修好的最短路径【免费下载链接】immichHigh performance self-hosted photo and video management solution.项目地址: https://gitcode.com/GitHub_Trending/im/immichImmich 的照片备份突然卡住、相册转圈不停、容器反复重启界面几乎从不报错而真正的病因藏在 Immich 日志里。这篇实操指南教你三招一条命令找到日志藏在哪一张表按症状对号入座再挑两个最高频的故障跟到底最后把日志调到话最多的状态并导出留档。 日志都藏在哪儿一张表定位所有组件Immich 的日志不落在某个文件里而是跟着容器走——每个服务自己往标准输出打Docker 帮你收着。执行docker ps -a看一眼各容器的状态列只要有容器不显示Up故障大概率就出在它身上不用再往下翻了。组件日志在哪儿查看命令后端服务 immich-server容器标准输出docker logs immich_server --tail 200机器学习 immich-machine-learning容器标准输出JSON 控制台格式配置见machine-learning/immich_ml/log_conf.jsondocker logs immich_machine_learning --tail 200数据库 immich-postgres容器标准输出docker logs immich_postgres --tail 100缓存 immich-redis容器标准输出docker logs immich_redis --tail 100前端 Web 界面浏览器开发者工具 Console按 F12 打开想看滚动更新而不是一次性快照把命令换成docker logs -f immich_server然后一边操作 App 一边盯输出新产生的日志会实时蹦出来。 快车道症状对号入座30 秒给出第一动作症状日志特征第一动作手机备份卡住服务端出现上传报错或 5xxdocker logs immich_server --tail 200定位报错行相册一直转圈看不到 ML 服务心跳或任务积压先查 ML 容器是否Up容器反复重启日志里Connection refused to postgres、EACCESdocker ps -a确认谁在重启再读它最后的输出人脸识别永远不完成ML 日志里模型加载失败、显存报错docker logs immich_machine_learning --tail 200Web 界面打不开后端日志有启动崩溃堆栈docker logs immich_server看最后一屏日志级别怎么选何时用INFO / WARN日常默认只留运行状态与警告DEBUG排查疑难问题前临时打开查完调回否则磁盘和眼睛都吃不消 慢车道两个高频故障跟到底数据库连不上server 反复重启的典型病因现象是immich_server不停重启日志里刷Connection refused。执行docker ps -a看immich_postgres若它不在线先执行docker logs immich_postgres --tail 100。若输出里有No space left on device说明磁盘写满了清理空间后重启 postgres 即可若 postgres 本身Up那就去核对.env里的DB_PASSWORD、DB_USERNAME、DB_DATABASE_NAME三行与数据库容器是否匹配变量定义见docker/example.env执行docker-compose up -d让配置生效。ML 服务超时相册转圈的另一个常客现象是 Web 端加载缓慢、人脸聚类迟迟不动服务端日志提示连不上机器学习服务。执行docker logs immich_machine_learning --tail 200看到模型加载失败或 CUDA 报错 → 多为显存不足或镜像选错回 compose 文件换回cpu镜像再启动看到进程根本没起来 → 执行docker restart immich_machine_learning注意模型缓存卷model-cache不要删否则要重新下模型。修完可以顺手进 Web 端 Administration → Server Stats确认服务恢复在线。 让日志多说话DEBUG 级别与一键导出平时日志默认 INFO 级别排查时想让它多说点把级别临时调到 DEBUG 即可后端与 ML 服务共用同一个变量名。在.env文件末尾加一行IMMICH_LOG_LEVELdebug然后执行docker-compose up -d重启生效复现你的操作再从滚动输出里抓证据查完把这一行删掉日志立刻恢复安静。导出留档只需一条命令docker-compose logs --tail1000 immich-debug-logs.txt生成一个纯文本文件包含各组件最近 1000 行日志排查和求助都靠它。 收尾三条值得养成的习惯每周扫一眼docker ps -a有容器不是Up状态就当天处理。改动配置前先执行一次日志导出出了问题能对比前后差异。看到 WARN 别忽略——它往往是 ERROR 的前奏。小贴士去社区提 issue 前附上脱敏后的.env密码打码加immich-debug-logs.txt日志片段别人能少走 80% 的弯路你也更快拿到答案。【免费下载链接】immichHigh performance self-hosted photo and video management solution.项目地址: https://gitcode.com/GitHub_Trending/im/immich创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考