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 月)
This commit is contained in:
2026-06-04 11:58:36 +08:00
parent 155b347d3f
commit 88967a238f
15 changed files with 295 additions and 61 deletions
+70
View File
@@ -0,0 +1,70 @@
# 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
```