这次记录一个轻量服务器上的 Immich 升级问题。

环境是 Docker Compose 部署，升级时执行：

```bash
docker compose pull && docker compose up -d
```

命令没有直接失败，Web 页面也能打开，但新上传照片没有缩略图，人脸识别和重复照片任务都没有明显进度。

## 先看版本和容器

先把当前环境记下来：

```bash
grep -n "IMMICH_VERSION\\|UPLOAD_LOCATION\\|DB_DATA_LOCATION" .env
docker compose ps
docker compose config | sed -n '/image:/p'
```

我的判断是：页面能打开只能说明 server 起了，不代表 database、machine learning 和存储目录都正常。

## 镜像入口先验证

这台轻量服务器访问 GHCR 不太稳定，所以我先单独拉几个镜像：

```bash
docker pull ghcr.1ms.run/immich-app/immich-server:v2
docker pull ghcr.1ms.run/immich-app/immich-machine-learning:v2
docker pull ghcr.1ms.run/immich-app/postgres:14-vectorchord0.4.3-pgvectors0.2.0
```

这一步只是确认镜像入口能拉通，不代表相册索引问题已经解决。后面还要看数据库和文件目录。

## 看数据库和 server 日志

```bash
docker compose logs --tail=200 immich-server
docker compose logs --tail=200 database
```

如果日志里出现 `Reindexing clip_index` 或 `Reindexing face_index`，但没有错误，我不会马上重启。照片比较多或机器性能弱的时候，索引重建可能需要时间。

## 检查上传目录

```bash
docker compose exec immich-server sh -lc 'ls -lah /data | head'
docker compose exec immich-server sh -lc 'touch /data/.write-test && rm /data/.write-test'
```

如果 `/data` 写不进去，新照片、缩略图和转码文件都可能出问题。

同时确认备份目录：

```bash
ls -lah ./library/backups | tail
```

这里要注意，数据库备份不包含照片和视频原文件，照片目录还是要单独备份。

## 最后处理 machine learning

如果缩略图恢复了，但人脸识别或搜索没有恢复，再看：

```bash
docker compose logs --tail=200 immich-machine-learning
```

这次排查下来，我把顺序固定成：镜像入口、数据库迁移、存储权限、machine learning、任务队列。不要因为页面能打开就认为升级完成，也不要因为索引慢就直接重装。

命令没有直接失败，Web 页面也能打开，但新上传照片没有缩略图，人脸识别和重复照片任务都没有明显进度。

轻量服务器上 Immich 升级后相册索引卡住排查记录

云计算

运维

后端

这篇文章记录了轻量服务器上使用Docker Compose部署的Immich相册升级后，Web页面正常但缩略图生成失败、人脸识别无进展的排查过程。文章核心思路是：页面可访问仅代表server服务正常，升级成功需依次确认镜像拉取、数据库迁移、存储目录权限及Machine-Learning服务。作者提供了从检查环境变量、容器状态、服务日志到验证文件写入权限的系统性排查步骤，强调不要因索引重建耗时或页面正常而误判升级完成。

人脸识别

数据库

服务器

容器

2026采购季 | AI焕新·智启新局

4核4G3M云服务器 新用户低至38元/年！

lighthouse

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

这篇文章记录了轻量服务器上使用Docker Compose部署的Immich相册升级后，Web页面正常但缩略图生成失败、人脸识别无进展的排查过程。文章核心思路是：页面可访问仅代表server服务正常，升级成功需依次确认镜像拉取、数据库迁移、存储目录权限及Machine-Learning服务。作者提供了从检查环境变量、容...

轻量服务器上 Immich 升级后相册索引卡住排查记录-腾讯云开发者社区-腾讯云

轻量服务器上 Immich 升级后相册索引卡住排查记录

轻量服务器上 Immich 升级后相册索引卡住排查记录

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐