添加旁路由部署文档、赛里木湖旅行计划、CLAUDE.md 维护说明
This commit is contained in:
@@ -0,0 +1,41 @@
|
|||||||
|
# CLAUDE.md — kb 维护说明
|
||||||
|
|
||||||
|
## ⚠️ 最重要：敏感信息
|
||||||
|
|
||||||
|
kb 内容会被部署到公网，**禁止包含任何敏感信息**，包括但不限于：
|
||||||
|
- 公网 IP 地址
|
||||||
|
- 密码、API Key、Token
|
||||||
|
- 加密密钥（私钥、公钥、UUID、ShortID 等）
|
||||||
|
- SSH 密钥路径或内容
|
||||||
|
- VPN/代理服务的连接凭据（如 Shadowrocket 配置）
|
||||||
|
- 路由器/设备管理密码
|
||||||
|
- 任何可用于攻击服务器或网络的信息
|
||||||
|
|
||||||
|
技术文档只保留：**架构、方法、命令模板、已知问题、解决思路**。具体 IP/密钥/密码用占位符（如 `<VPS IP>`）代替或直接删除。
|
||||||
|
|
||||||
|
## 维护方式
|
||||||
|
|
||||||
|
- **用户**：kurihada，主要口述内容，由 Claude 完成写作
|
||||||
|
- **Claude**：负责写作、排版、组织文件结构、更新导航
|
||||||
|
- **语言**：简体中文
|
||||||
|
|
||||||
|
## 技术栈
|
||||||
|
|
||||||
|
- MkDocs Material 构建
|
||||||
|
- 源文件：`docs/` 下的 Markdown
|
||||||
|
- 构建输出：`site/`（已在 .gitignore 中忽略）
|
||||||
|
- 配置：`mkdocs.yml`
|
||||||
|
|
||||||
|
## 文件组织
|
||||||
|
|
||||||
|
- 每个分类一个目录，index.md 作为分类概览
|
||||||
|
- 具体主题拆成独立 `.md` 文件，放在对应分类目录下
|
||||||
|
- `assets/` 放图片等附件
|
||||||
|
- 新增文件后需同步更新 `mkdocs.yml` 的 `nav:` 部分
|
||||||
|
|
||||||
|
## 每次编辑后
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd ~/kb && mkdocs build # 重新构建 site/
|
||||||
|
git add -A && git commit -m "描述改动"
|
||||||
|
```
|
||||||
+1
-1
@@ -31,4 +31,4 @@
|
|||||||
|
|
||||||
## 📝 技术笔记
|
## 📝 技术笔记
|
||||||
|
|
||||||
> 还没有内容，待 Claude 帮你整理。
|
- [旁路由 + 去广告 部署](旁路由部署.md) — sing-box + AdGuard Home 旁路由架构、配置路径、已知问题
|
||||||
|
|||||||
@@ -0,0 +1,142 @@
|
|||||||
|
# 旁路由 + 去广告 部署文档
|
||||||
|
|
||||||
|
> 部署日期：2026-06-02 | 服务器：香港 VPS | 旁路由：Ubuntu 24.04
|
||||||
|
|
||||||
|
## 架构总览
|
||||||
|
|
||||||
|
```
|
||||||
|
香港 VPS 本机 - 旁路由
|
||||||
|
┌──────────────────────┐ ┌──────────────────────────────┐
|
||||||
|
│ sing-box 服务端 │ VLESS │ sing-box 客户端 │
|
||||||
|
│ VLESS + Reality │←────────│ ├─ SOCKS5 :7890 → 本机+LAN翻墙│
|
||||||
|
│ 伪装 microsoft.com │ Reality │ ├─ TProxy :7895 → 透明代理 │
|
||||||
|
│ 端口: 8443 │ │ └─ 规则: 内网直连/其余走代理 │
|
||||||
|
└──────────────────────┘ │ │
|
||||||
|
│ AdGuard Home (Docker) │
|
||||||
|
│ ├─ DNS :53 → 全屋去广告 │
|
||||||
|
│ ├─ Web :8080 → 管理面板 │
|
||||||
|
│ └─ 45万条过滤规则 │
|
||||||
|
└──────────────────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
## 关键配置
|
||||||
|
|
||||||
|
### 1. 本机网络
|
||||||
|
|
||||||
|
- **IP**: 静态 IP（通过 NetworkManager 设置）
|
||||||
|
- **连接名**: `有线连接 1`
|
||||||
|
- **网关**: `192.168.31.1`（小米路由器 Redmi RM2100）
|
||||||
|
- **IP 转发**: 已开启 (`net.ipv4.ip_forward=1`)
|
||||||
|
|
||||||
|
### 2. 端口清单
|
||||||
|
|
||||||
|
| 端口 | 服务 | 用途 |
|
||||||
|
|------|------|------|
|
||||||
|
| 7890 | sing-box mixed | SOCKS5/HTTP 代理（翻墙） |
|
||||||
|
| 7895 | sing-box tproxy | 透明代理（TProxy，回包有问题暂未用）|
|
||||||
|
| 53 | AdGuard Home | DNS（去广告） |
|
||||||
|
| 8080 | AdGuard Home | Web 管理面板 |
|
||||||
|
| 8443 | HK VPS | VLESS+Reality 服务端 |
|
||||||
|
|
||||||
|
### 3. 服务管理
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 本机
|
||||||
|
sudo systemctl restart sing-box # 重启翻墙客户端
|
||||||
|
docker restart adguardhome # 重启去广告
|
||||||
|
sudo journalctl -u sing-box -f # 查看翻墙日志
|
||||||
|
docker logs adguardhome -f # 查看去广告日志
|
||||||
|
|
||||||
|
# 香港 VPS
|
||||||
|
ssh -i ~/.ssh/hk_vps -p <SSH端口> root@<VPS IP>
|
||||||
|
systemctl restart sing-box
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4. 配置文件路径
|
||||||
|
|
||||||
|
| 文件 | 说明 |
|
||||||
|
|------|------|
|
||||||
|
| `/etc/sing-box/config.json` | sing-box 客户端配置 |
|
||||||
|
| `/opt/adguard/conf/AdGuardHome.yaml` | AdGuard Home 配置 |
|
||||||
|
| `/opt/adguard/work/data/filters/` | 过滤规则文件 |
|
||||||
|
| `/etc/iptables/rules.v4` | iptables 持久化规则 |
|
||||||
|
| `/etc/systemd/system/sing-box.service` | sing-box systemd 服务 |
|
||||||
|
| `/etc/systemd/system/tproxy-route.service` | TProxy 路由（fwmark）|
|
||||||
|
|
||||||
|
### 5. 广告过滤规则
|
||||||
|
|
||||||
|
当前 45 万条规则，来源：
|
||||||
|
|
||||||
|
1. AdGuard DNS filter (16万)
|
||||||
|
2. AdAway Default Blocklist (6500)
|
||||||
|
3. Malicious URL Blocklist (1.7万)
|
||||||
|
4. Peter Lowe's Blocklist (8.1万)
|
||||||
|
5. AdRules DNS Filter 中国广告 (18.5万)
|
||||||
|
|
||||||
|
自定义拦截：`wwads.cn`, `tanx.com`, `sdkclick.qq.com`, `byteimg.com`, `bytecdn.com`, `snssdk.com`, `toutiao.com`
|
||||||
|
|
||||||
|
## 各设备配置
|
||||||
|
|
||||||
|
### 本机 (Ubuntu)
|
||||||
|
|
||||||
|
- 系统代理: SOCKS5 `127.0.0.1:7890`（GNOME 已配）
|
||||||
|
- DNS: 自动（走 AdGuard `127.0.0.1:53`）
|
||||||
|
|
||||||
|
### Windows
|
||||||
|
|
||||||
|
- DNS: 手动设为旁路由 IP（去广告）
|
||||||
|
- 备用 DNS: `223.5.5.5`
|
||||||
|
- 翻墙: 系统代理 SOCKS5 `旁路由IP:7890`（需要时开）
|
||||||
|
- 关掉浏览器 DNS over HTTPS（Chrome/Edge 设置）
|
||||||
|
|
||||||
|
### 手机 - 在家（连 WiFi）
|
||||||
|
|
||||||
|
- DNS: 设为旁路由 IP（去广告）
|
||||||
|
- 翻墙: WiFi 设置 → 代理 → 手动 → `旁路由IP:7890`
|
||||||
|
|
||||||
|
### 手机 - 出门（4G/5G）
|
||||||
|
|
||||||
|
- App: Shadowrocket / Hiddify Next
|
||||||
|
- 协议: VLESS Reality，直连 HK VPS
|
||||||
|
- 配置参数与 VPS 一致
|
||||||
|
|
||||||
|
## 网络背景
|
||||||
|
|
||||||
|
- **路由器**: 小米 Redmi RM2100，固件 2.0.23
|
||||||
|
- **上游**: 电信大内网，光猫 `192.168.1.1` 由运营商管控
|
||||||
|
- **DNS 劫持**: 运营商强制接管 53 端口，所以路由器改 WAN DNS 无效
|
||||||
|
- **解决**: 各设备 DNS 手动设为旁路由 IP，绕过运营商劫持
|
||||||
|
- **AP 隔离**: 路由器重启后消失，设备互访正常
|
||||||
|
|
||||||
|
## 已知问题
|
||||||
|
|
||||||
|
1. **TProxy 透明代理不通**: 回包路径有问题，和 Docker 网络冲突。目前用 SOCKS5 代理替代，效果一样。
|
||||||
|
|
||||||
|
2. **路由器 DNS 劫持**: 小米路由器 + 电信大内网劫持所有 53 端口。Windows DNS 设成旁路由 IP 可以绕过。
|
||||||
|
|
||||||
|
3. **sing-box 配置用了废弃字段**: DNS 和 inbound 格式使用了 legacy 格式，需要环境变量 `ENABLE_DEPRECATED_LEGACY_DNS_SERVERS=true` 兼容，sing-box 1.14 之前需要迁移到新格式。
|
||||||
|
|
||||||
|
4. **AdGuard UDP 在 Docker bridge 模式下有问题**: 容器内 UDP 监听 `[::]:53`（IPv6 dual-stack）导致本地回环 UDP DNS 偶尔超时。解决方法是 `--net host` 模式。
|
||||||
|
|
||||||
|
## 重启后恢复
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 大部分自动恢复。如果翻墙或去广告挂了，依次检查：
|
||||||
|
sudo systemctl status sing-box # 翻墙
|
||||||
|
docker ps | grep adguardhome # 去广告
|
||||||
|
ssh -i ~/.ssh/hk_vps -p <SSH端口> root@<VPS IP> 'systemctl status sing-box' # HK VPS
|
||||||
|
```
|
||||||
|
|
||||||
|
## 添加新的广告域名到拦截列表
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo python3 << 'PYEOF'
|
||||||
|
import yaml
|
||||||
|
with open('/opt/adguard/conf/AdGuardHome.yaml') as f:
|
||||||
|
cfg = yaml.safe_load(f)
|
||||||
|
cfg['user_rules'].append('||新域名.com^')
|
||||||
|
with open('/opt/adguard/conf/AdGuardHome.yaml', 'w') as f:
|
||||||
|
yaml.dump(cfg, f, default_flow_style=False)
|
||||||
|
PYEOF
|
||||||
|
docker restart adguardhome
|
||||||
|
```
|
||||||
@@ -0,0 +1,26 @@
|
|||||||
|
# 🏔️ 赛里木湖 — 2026 年 8 月
|
||||||
|
|
||||||
|
> 公司组织的团建/旅行，具体日期待定。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📋 行前准备
|
||||||
|
|
||||||
|
> 待补充：出发日期、交通方式、住宿、行程安排。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📸 拍摄计划
|
||||||
|
|
||||||
|
- 器材：Sony 相机 + DJI Action 5 Pro
|
||||||
|
- 拍摄重点：
|
||||||
|
- [ ] 湖面全景
|
||||||
|
- [ ] 沿途风光
|
||||||
|
- [ ] 团队合影
|
||||||
|
- 参数备忘：待补充
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📝 游记
|
||||||
|
|
||||||
|
> 旅行结束后记录。
|
||||||
@@ -57,10 +57,12 @@ nav:
|
|||||||
- 首页: index.md
|
- 首页: index.md
|
||||||
- 旅行:
|
- 旅行:
|
||||||
- 旅行/index.md
|
- 旅行/index.md
|
||||||
|
- 赛里木湖 2026: 旅行/赛里木湖2026.md
|
||||||
- 摄影:
|
- 摄影:
|
||||||
- 摄影/index.md
|
- 摄影/index.md
|
||||||
- 技术:
|
- 技术:
|
||||||
- 技术/index.md
|
- 技术/index.md
|
||||||
|
- 旁路由部署: 技术/旁路由部署.md
|
||||||
- 3D打印:
|
- 3D打印:
|
||||||
- 3D打印/index.md
|
- 3D打印/index.md
|
||||||
- 日记:
|
- 日记:
|
||||||
|
|||||||
Reference in New Issue
Block a user