Files
notebook/docs/技术/immich部署.md
T
kurihada 88967a238f fix: 全面修订技术文档 — 修复 P0/P1/P2 共 16 项审查问题
P0(必须修复):
- 技术/index.md: Web 服务 NPM → Caddy,补充服务列表和域名
- 旁路由部署.md: VPS OS CentOS → Debian,补全安装命令
- 旁路由部署.md: 新增 systemd-resolved DNS 端口冲突解决步骤
- mkdocs.yml: 删除冗余 index.md 子项,空分类用简单链接
- artalk评论系统.md: docker-compose.yml 补全环境变量

P1(建议修复):
- Linux.md: 区分旁路由本机 vs 局域网其他机器两种场景
- Android.md: 移除不支持的 Clash Meta,添加私人 DNS 冲突警告
- macOS.md: 终端命令补注视说明占位符需替换
- 旅行/index.md: 添加赛里木湖 2026 游记链接
- mkdocs部署.md: 补充 Docker 网络创建、首次启动、LE 邮箱配置
- artalk评论系统.md: 修正环境变量与配置文件矛盾说明

P2(优化):
- 首页: 添加评论区说明、修正 Immich 链接为公网域名
- 旁路由部署.md: 加固有章节目录(无锚点纯文本)
- 摄影/3D打印/日记 index.md: 充实引导内容
- 新增 Immich 部署文档
- 统一 callout 风格: ?> 改为 !!! tip
- GitHub Stars 加时间限定 (截至 2026 年 6 月)
2026-06-04 11:58:36 +08:00

1.5 KiB
Raw Blame History

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


日常管理

# 查看状态
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 索引访问)

备份

# 备份照片库
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 了解破坏性变更。

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