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
+18 -11
View File
@@ -8,7 +8,8 @@
|------|------|
| 系统 | Ubuntu 24.04, 16 核, 12GB RAM |
| 存储 | 1TB NVMe SSD(后续加机械硬盘) |
| Web 服务 | Nginx Proxy Manager (Docker) |
| 反向代理 | Caddy (Docker) |
| Docker 网络 | `nginx`(所有服务加入此网络互通) |
| 内网穿透 | frpc |
| 照片管理 | Immich |
| 知识库 | MkDocs Material |
@@ -17,20 +18,26 @@
## 📋 服务列表
| 服务 | 说明 |
|------|------|
| Immich | 照片/视频管理 + AI 标签 |
| Immich API | Immich 后端 API |
| Nginx Proxy Manager | 反向代理管理面板 |
| Gitea | 自托管 Git 服务 |
| Minio | S3 兼容对象存储 |
| Java app.jar | Spring Boot 应用 |
| Java auth-backend | 认证后端 |
所有公网流量经 Caddy(TLS 终结)转发到各后端服务。
| 服务 | 域名 | 说明 |
|------|------|------|
| Caddy | — | 反向代理,自动 Let's Encrypt TLS |
| MkDocs | [note.kurihada.com](https://note.kurihada.com) | 知识库(本页面) |
| Artalk | 同域 `/artalk/` | 评论系统 |
| Immich | [photo.kurihada.com](https://photo.kurihada.com) | 照片/视频管理 + AI 标签 |
| Gitea | [git.kurihada.com](https://git.kurihada.com) | 自托管 Git 服务 |
| MinIO | [minio.kurihada.com](https://minio.kurihada.com) | S3 兼容对象存储 |
| Alist | [pan.kurihada.com](https://pan.kurihada.com) | 网盘文件管理 |
| Vaultwarden | [pass.kurihada.com](https://pass.kurihada.com) | 密码管理器 |
| WordPress | [www.kurihada.com](https://www.kurihada.com) | 博客 |
---
## 📝 技术笔记
- [MkDocs 知识库部署](mkdocs部署.md) — MkDocs Material 构建 + Caddy 静态文件服务
- [旁路由 + 去广告 部署](旁路由部署.md) — sing-box + AdGuard Home 旁路由架构、配置路径、已知问题
- [Artalk 评论系统](artalk评论系统.md) — 自托管评论系统,Docker 部署 + MkDocs 集成
- [Immich 照片管理](immich部署.md) — 自托管照片服务,AI 标签 + 人脸识别
- [旁路由部署](旁路由部署.md) — sing-box + AdGuard Home 架构、部署、踩坑笔记
- [旁路由使用指南](旁路由使用/Linux.md) — 各平台客户端配置(Linux / Windows / macOS / Android / iPhone