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:
+33
-4
@@ -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 # 零停机
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
Reference in New Issue
Block a user