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
+47 -5
View File
@@ -6,9 +6,13 @@
## 接入旁路由
### 系统代理(GNOME
根据你的 Linux 机器是不是旁路由本身,选择对应的配置方式。
1. 打开 **设置 → 网络 → 代理**
### 场景 A:这台 Linux 就是旁路由
本机已运行 sing-box + AdGuard HomeDNS 和代理指向自己即可。
1. 打开 **设置 → 网络 → 代理**GNOME)或者用 NetworkManager 命令行
2. 选择 **手动**
3. 填写:
@@ -17,14 +21,51 @@
| SOCKS 代理 | `127.0.0.1` |
| 端口 | `7890` |
?> DNS 会自动使用 AdGuard因为旁路由本机 DNS 已设为 `127.0.0.1`
!!! tip "DNS 会自动使用 AdGuard(旁路由本机 DNS 已设为 `127.0.0.1`,无需额外配置。"
### 终端代理(可选)
### 场景 B:这台 Linux 是局域网内其他机器
DNS 和代理都需要指向旁路由 IP。
#### 设置 DNS
**GNOME 图形界面:**
1. 打开 **设置 → 网络**
2. 选择当前连接 → **IPv4 → DNS**
3. 添加:`旁路由 IP`(如 `192.168.31.112`
4. 备用:`223.5.5.5`
**命令行方式(NetworkManager):**
```bash
nmcli con mod "连接名" ipv4.dns "旁路由IP" ipv4.ignore-auto-dns yes
nmcli con up "连接名"
```
#### 设置系统代理
1. 打开 **设置 → 网络 → 代理**
2. 选择 **手动**
3. 填写 SOCKS 代理地址为旁路由 IP
| 字段 | 值 |
|------|-----|
| SOCKS 代理 | `旁路由 IP`(如 `192.168.31.112` |
| 端口 | `7890` |
---
## 终端代理(可选)
如果需要在终端里走代理,设置环境变量:
```bash
# 本机就是旁路由
export ALL_PROXY=socks5://127.0.0.1:7890
# 局域网内其他机器(替换为实际 IP)
export ALL_PROXY=socks5://旁路由IP:7890
```
或者写入 `~/.bashrc` 持久化:
@@ -48,13 +89,14 @@ curl --socks5 127.0.0.1:7890 https://www.google.com -o /dev/null -s -w '%{http_c
# 测试 DNS 去广告
nslookup doubleclick.net
# 返回 0.0.0.0 → 广告域名已被拦截
# 如果提示 command not found,安装 dnsutilsDebian/Ubuntu)或 bind-utilsFedora
```
---
## 服务管理
旁路由本机就是服务器,所以日常管理命令也在这里执行
如果这台机器就是旁路由,日常管理命令
```bash
sudo systemctl restart sing-box # 重启翻墙