kurihada
88967a238f
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 月)
71 lines
1.5 KiB
Markdown
71 lines
1.5 KiB
Markdown
# 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
|
||
```
|