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
+33 -4
View File
@@ -100,7 +100,15 @@ git commit -m "描述改动" # 提交 Markdown 源码
## 三、Caddy 部署
### 3.1 docker-compose.yml
### 3.1 前置:创建 Docker 网络
```bash
docker network create nginx
```
所有通过 Caddy 反代的服务都加入 `nginx` 网络,容器间通过容器名互相访问。
### 3.2 docker-compose.yml
Caddy 部署在 `~/docker/caddy/`
@@ -125,7 +133,25 @@ networks:
external: true
```
### 3.2 Caddyfile 中 kb 的配置
### 3.3 首次启动
```bash
cd ~/docker/caddy && docker compose up -d
```
启动前确认 `~/kb/site/` 目录存在(需先执行过 `mkdocs build`),否则 bind mount 会创建一个空目录导致 404。
### 3.4 Caddyfile 中 kb 的配置
Caddyfile 开头有全局块配置 Let's Encrypt 通知邮箱:
```caddy
{
email kurihada@qq.com
}
```
kb 站点的配置:
```caddy
note.kurihada.com {
@@ -146,10 +172,13 @@ note.kurihada.com {
- `handle { ... }` — 包裹 `file_server`,保证和 `handle_path` 互斥
- Caddy 自动申请和续期 Let's Encrypt TLS 证书,无需额外配置
### 3.3 部署后重载
### 3.5 部署后重载
修改 Caddyfile 后重载(两种方式):
```bash
docker restart caddy
docker restart caddy # 简单粗暴,短暂中断
docker exec caddy caddy reload --config /etc/caddy/Caddyfile # 零停机
```
---