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
+13 -6
View File
@@ -27,7 +27,7 @@
4. 保存
?> 不同 Android 厂商设置路径略有差异,核心就是 WiFi → 高级 → 静态 IP + 手动代理。
!!! tip "不同 Android 厂商设置路径略有差异,核心就是 WiFi → 高级 → 静态 IP + 手动代理。切换静态 IP 时,**IP 地址/网关/子网掩码保持 DHCP 分配的值不变**,只修改 DNS 字段。"
---
@@ -37,11 +37,12 @@
### 推荐 App
| App | 价格 | 说明 |
|-----|:---:|------|
| **Hiddify Next** | 免费 | 开源,支持 VLESS Reality |
| **v2rayNG** | 免费 | 老牌客户端,功能全面 |
| **Clash Meta** | 免费 | 规则灵活 |
| App | 价格 | VLESS Reality |
|-----|:---:|:---:|
| **Hiddify Next** | 免费 | 支持 |
| **v2rayNG** | 免费 | 支持 |
> Clash Meta 虽然规则灵活,但**不支持 VLESS Reality**,不适合此旁路由架构。
### 配置方法
@@ -75,6 +76,12 @@
有些 app(如银行类)不走系统代理。可以在 Hiddify Next 等 App 中使用 **VPN 模式**,接管全部流量。
### DNS 去广告不生效?
Android 9+ 有「私人 DNS」(DNS-over-TLS)功能,开启后会**覆盖 WiFi 的 DNS 设置**,导致 AdGuard Home 被绕过。
检查路径:**设置 → 连接 → 更多连接设置 → 私人 DNS → 设为关闭**
### 出门时无法连接 VPS
1. 检查 VPS 是否在线
+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 # 重启翻墙
+1 -1
View File
@@ -38,7 +38,7 @@
4. 点击 **保存**
?> 不需要翻墙时关掉即可,国内网站直连,不受影响。
!!! tip "不需要翻墙时关掉即可,国内网站直连,不受影响。"
---
+3 -3
View File
@@ -38,14 +38,14 @@
4. 点击 **好**
?> 不需要翻墙时关掉即可。也可以使用 **SwitchyOmega**(Chrome 扩展)按规则自动切换,国内网站不走代理。
!!! tip "不需要翻墙时关掉即可。也可以使用 **SwitchyOmega**(Chrome 扩展)按规则自动切换,国内网站不走代理。"
---
## 终端代理(可选)
```bash
# 临时开启
# 临时开启(替换为实际旁路由 IP,如 192.168.31.112
export ALL_PROXY=socks5://旁路由IP:7890
# 写入 ~/.zshrc 持久化
@@ -59,7 +59,7 @@ echo 'alias unproxy="unset ALL_PROXY"' >> ~/.zshrc
```bash
# 测试代理是否通
curl --socks5 旁路由IP:7890 https://www.google.com -o /dev/null -s -w '%{http_code}'
curl --socks5 旁路由IP:7890 https://www.google.com -o /dev/null -s -w '%{http_code}' # 替换为实际 IP
# 返回 200 → 正常
# 测试 DNS 去广告