# Immich 照片管理

> 自托管照片管理服务，支持 AI 标签、人脸识别、RAW 预览、多用户。域名 `photo.kurihada.com`。

---

## 架构

Immich 由 4 个容器组成，部署在 `~/docker/immich/`：

| 容器 | 镜像 | 说明 |
|------|------|------|
| immich_server | ghcr.io/immich-app/immich-server | 主服务 + API |
| immich_postgres | pgvector/pgvector | 数据库（PostgreSQL + pgvector） |
| immich_redis | valkey/valkey | 缓存 |
| immich_machine_learning | ghcr.io/immich-app/immich-machine-learning | AI 智能搜索/人脸识别 |

通过 Caddy 反代 `photo.kurihada.com → immich_server:2283`。

---

## 日常管理

```bash
# 查看状态
cd ~/docker/immich && docker compose ps

# 查看日志
docker logs immich_server -f

# 更新
docker compose pull && docker compose up -d

# 完整重启
docker compose down && docker compose up -d
```

---

## 存储

| 内容 | 路径 |
|------|------|
| 照片库 | `~/docker/immich/library/` |
| 数据库 | PostgreSQL（容器内） |
| 外部库（RAW） | `~/aa/`（只读挂载，Immich 索引访问） |

---

## 备份

```bash
# 备份照片库
rsync -av ~/docker/immich/library/ /backup/immich-library/

# 备份数据库（推荐用 pg_dump）
docker exec immich_postgres pg_dump -U postgres immich > /backup/immich-db-$(date +%Y%m%d).sql
```

---

## 更新

Immich 发版频繁（~每月），更新前务必查看 [Release Notes](https://github.com/immich-app/immich/releases) 了解破坏性变更。

```bash
cd ~/docker/immich
docker compose pull
docker compose up -d
```