尧图网站建设 
Immich 日志调试指南4 步排查备份失败与容器报错【免费下载链接】immichHigh performance self-hosted photo and video management solution.项目地址: https://gitcode.com/GitHub_Trending/im/immich照片备份到 Immich 失败网页转圈、人脸聚类一直不生成你却完全不知道从哪查起这篇 Immich 日志调试指南按 4 步带你定位问题多数常见故障 10 分钟内就能查到原因。第一步先判断你的问题在哪一层先看结论Immich 分前端、后端、机器学习、数据库几层不同症状该看的日志不一样先分类再动手能省一半时间。对照下表找到你所在的那一行再去第二步取对应组件的日志。典型症状怀疑组件该看哪份日志手机备份失败、网页无响应、登录报错后端服务immich_server 容器日志人脸聚类不生成、文字搜索无效机器学习服务immich_machine_learning 容器日志登录加载失败、后端反复报错数据库immich_postgres 容器日志视频播放失败、转码卡住后端 机器资源immich_server 日志 服务器资源占用没明显报错但整体很慢资源 / 任务队列immich_server 日志 docker stats 输出第二步找到日志入口按部署方式分Docker 部署绝大多数人是 Docker 部署容器日志没有单独的文件容器输出就是日志。下面这条命令实时跟踪后端日志-f 表示持续跟随类似 tail -fdocker compose logs -f immich_server预期效果终端持续滚动打印日志行看到 ERROR 开头的行就是问题现场想同时看所有组件把命令里的 immich_server 去掉即可。本地开发开发模式下后端日志直接打印在启动它的终端里不用找日志文件。如果没有源码先克隆仓库git clone https://gitcode.com/GitHub_Trending/im/immich cd immich/server pnpm install pnpm run start:dev预期效果终端持续输出服务启动过程和各请求的日志出问题后往上翻终端内容即可。面板部署群晖 / Portainer 等如果你没有终端入口就在面板里打开容器列表找到名为 immich_server 的容器点进日志标签页效果和 docker logs 完全一样。机器有 SSH 的话上面两条 docker compose logs 命令都照样可用。第三步照着信号找原因数据库连接失败你会看到的日志长这样ERROR [postgres] password authentication failed for user postgres FATAL: database connection failed它通常意味着.env 里的数据库密码和数据库实际初始化时用的密码对不上多发生在部署后改过 DB_PASSWORD 的情况。先做这几件事打开 .env 文件就在 docker-compose.yml 旁边核对 DB_PASSWORD 是不是当初部署用的值。数据库已初始化后改密码不会生效建议先改回旧密码确实要换密码则需要重建数据库。⚠️ 重建会丢数据动手前先备份。改完执行 docker compose up -d 重启再回日志里确认没有新报错。如果上面的都不是继续往下看。ML 服务无响应你会看到的日志长这样ERROR [MachineLearningRepository] connect ECONNREFUSED ::1:3003 WARN [MachineLearningRepository] retrying in 5s它通常意味着后端连不上 3003 端口的机器学习服务容器没起来或还在下载模型没启动完。先做这几件事执行 docker compose ps看 immich_machine_learning 是否显示为 healthy。没起来或反复重启就抓它的日志docker compose logs --tail100 immich_machine_learning。首次用 CPU 推理要下载模型耗时较长耐心等待启动完成同时确认 model-cache 卷所在磁盘有足够空间。如果还是没解决继续往下看。存储目录写不进去你会看到的日志长这样EACCES: permission denied, open /data/upload/2025/08/photo.jpg它通常意味着.env 里 UPLOAD_LOCATION 指向的宿主机目录容器用户没有写权限。先做这几件事确认 UPLOAD_LOCATION 指向的目录在宿主机上真实存在。检查该目录权限群晖等系统还要确认共享文件夹授权给了 Docker。修复后 docker compose up -d 重启再上传一张照片验证。第四步还搞不定时的进阶手段开 DEBUG 级日志在 .env 里加一行 IMMICH_LOG_LEVELdebug再执行 docker compose up -d immich_server预期看到服务端开始打印每个 API 请求的状态码和耗时日志中间件会自动打码密码等敏感字段。注意一旦用环境变量设置了级别网页设置里的日志级别就不再生效可选级别从低到高为 verbose、debug、log、warn、error、fatal。看资源占用执行 docker stats预期看到一张各容器 CPU、内存的实时表格若服务器内存长期顶到上限说明是机器资源不够而不是代码问题。看后台统计页打开网页管理界面的 Server Stats 页面预期能一眼看到各用户照片数、视频数和总存储方便核对备份了多少、占了多少。收尾求助之前先准备好这些提 issue 前备好这 3 样能省掉大量来回沟通脱敏后的 .env 配置把 DB_PASSWORD 打码其余键值保留。出错时间段的日志片段建议覆盖报错前后约 1000 行。版本与环境Immich 版本号、容器镜像 tag、Docker 跑在什么系统上。下面这条命令会把三个关键组件最近 1000 行日志导出到一个文件直接附进 issuedocker compose logs --tail1000 immich_server immich_machine_learning immich_postgres immich-debug-logs.txt排完障想继续深入可以去官方文档的开发者与故障排查章节看看或在项目社区渠道提问——手里带着日志回复通常更快。【免费下载链接】immichHigh performance self-hosted photo and video management solution.项目地址: https://gitcode.com/GitHub_Trending/im/immich创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Immich 日志调试指南：4 步排查备份失败与容器报错
Immich 日志调试指南4 步排查备份失败与容器报错【免费下载链接】immichHigh performance self-hosted photo and video management solution.项目地址: https://gitcode.com/GitHub_Trending/im/immich照片备份到 Immich 失败网页转圈、人脸聚类一直不生成你却完全不知道从哪查起这篇 Immich 日志调试指南按 4 步带你定位问题多数常见故障 10 分钟内就能查到原因。第一步先判断你的问题在哪一层先看结论Immich 分前端、后端、机器学习、数据库几层不同症状该看的日志不一样先分类再动手能省一半时间。对照下表找到你所在的那一行再去第二步取对应组件的日志。典型症状怀疑组件该看哪份日志手机备份失败、网页无响应、登录报错后端服务immich_server 容器日志人脸聚类不生成、文字搜索无效机器学习服务immich_machine_learning 容器日志登录加载失败、后端反复报错数据库immich_postgres 容器日志视频播放失败、转码卡住后端 机器资源immich_server 日志 服务器资源占用没明显报错但整体很慢资源 / 任务队列immich_server 日志 docker stats 输出第二步找到日志入口按部署方式分Docker 部署绝大多数人是 Docker 部署容器日志没有单独的文件容器输出就是日志。下面这条命令实时跟踪后端日志-f 表示持续跟随类似 tail -fdocker compose logs -f immich_server预期效果终端持续滚动打印日志行看到 ERROR 开头的行就是问题现场想同时看所有组件把命令里的 immich_server 去掉即可。本地开发开发模式下后端日志直接打印在启动它的终端里不用找日志文件。如果没有源码先克隆仓库git clone https://gitcode.com/GitHub_Trending/im/immich cd immich/server pnpm install pnpm run start:dev预期效果终端持续输出服务启动过程和各请求的日志出问题后往上翻终端内容即可。面板部署群晖 / Portainer 等如果你没有终端入口就在面板里打开容器列表找到名为 immich_server 的容器点进日志标签页效果和 docker logs 完全一样。机器有 SSH 的话上面两条 docker compose logs 命令都照样可用。第三步照着信号找原因数据库连接失败你会看到的日志长这样ERROR [postgres] password authentication failed for user postgres FATAL: database connection failed它通常意味着.env 里的数据库密码和数据库实际初始化时用的密码对不上多发生在部署后改过 DB_PASSWORD 的情况。先做这几件事打开 .env 文件就在 docker-compose.yml 旁边核对 DB_PASSWORD 是不是当初部署用的值。数据库已初始化后改密码不会生效建议先改回旧密码确实要换密码则需要重建数据库。⚠️ 重建会丢数据动手前先备份。改完执行 docker compose up -d 重启再回日志里确认没有新报错。如果上面的都不是继续往下看。ML 服务无响应你会看到的日志长这样ERROR [MachineLearningRepository] connect ECONNREFUSED ::1:3003 WARN [MachineLearningRepository] retrying in 5s它通常意味着后端连不上 3003 端口的机器学习服务容器没起来或还在下载模型没启动完。先做这几件事执行 docker compose ps看 immich_machine_learning 是否显示为 healthy。没起来或反复重启就抓它的日志docker compose logs --tail100 immich_machine_learning。首次用 CPU 推理要下载模型耗时较长耐心等待启动完成同时确认 model-cache 卷所在磁盘有足够空间。如果还是没解决继续往下看。存储目录写不进去你会看到的日志长这样EACCES: permission denied, open /data/upload/2025/08/photo.jpg它通常意味着.env 里 UPLOAD_LOCATION 指向的宿主机目录容器用户没有写权限。先做这几件事确认 UPLOAD_LOCATION 指向的目录在宿主机上真实存在。检查该目录权限群晖等系统还要确认共享文件夹授权给了 Docker。修复后 docker compose up -d 重启再上传一张照片验证。第四步还搞不定时的进阶手段开 DEBUG 级日志在 .env 里加一行 IMMICH_LOG_LEVELdebug再执行 docker compose up -d immich_server预期看到服务端开始打印每个 API 请求的状态码和耗时日志中间件会自动打码密码等敏感字段。注意一旦用环境变量设置了级别网页设置里的日志级别就不再生效可选级别从低到高为 verbose、debug、log、warn、error、fatal。看资源占用执行 docker stats预期看到一张各容器 CPU、内存的实时表格若服务器内存长期顶到上限说明是机器资源不够而不是代码问题。看后台统计页打开网页管理界面的 Server Stats 页面预期能一眼看到各用户照片数、视频数和总存储方便核对备份了多少、占了多少。收尾求助之前先准备好这些提 issue 前备好这 3 样能省掉大量来回沟通脱敏后的 .env 配置把 DB_PASSWORD 打码其余键值保留。出错时间段的日志片段建议覆盖报错前后约 1000 行。版本与环境Immich 版本号、容器镜像 tag、Docker 跑在什么系统上。下面这条命令会把三个关键组件最近 1000 行日志导出到一个文件直接附进 issuedocker compose logs --tail1000 immich_server immich_machine_learning immich_postgres immich-debug-logs.txt排完障想继续深入可以去官方文档的开发者与故障排查章节看看或在项目社区渠道提问——手里带着日志回复通常更快。【免费下载链接】immichHigh performance self-hosted photo and video management solution.项目地址: https://gitcode.com/GitHub_Trending/im/immich创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考