commit all

02-学习笔记/Tips/群晖Docker中qbittorrent流量路由配置指南.md

@@ -0,0 +1,75 @@
+# 群晖Docker中qbittorrent流量路由配置指南
+
+# 核心结论
+
+**不推荐用 ****`PROCESS-NAME`**** 给群晖 Docker 内的 qb 做分流，大概率无效；优先用【源 IP 规则 SRC\-IP\-CIDR】，稳定可靠。**
+
+## 为什么 Docker 容器的 qb，PROCESS\-NAME 不好用
+
+1. Docker 有独立 **PID Namespace**。容器里面的 qb 进程，在宿主机（群晖）内核视角里，进程名识别会混乱。
+
+2. Mihomo 的 `PROCESS-NAME` 只能**识别宿主机上原生运行的进程**；局域网 / 容器出来的数据包，内核无法拿到容器内部的进程名称。
+
+3. 就算你开了 `find-process-mode: always`，TUN 模式下也很难稳定捕获容器内进程，经常匹配失败，属于坑。
+
+> PROCESS\-NAME 适合：Windows、宿主机直接跑的程序；**不适合 Docker 容器内服务**。
+> 
+> 
+
+## ✅ 推荐方案：给 qb 容器固定静态 IP，Mihomo 写 SRC\-IP\-CIDR 规则
+
+1. 给 qb 容器分配**固定静态 IP**（自定义 bridge 网桥，不要默认 bridge）
+例：`192.168.1.100`
+
+2. 在 mihomo 规则文件，**放在规则靠前位置（优先级高）**
+
+```yaml
+# qBittorrent容器全部流量直连，不走代理
+- SRC-IP-CIDR,192.168.1.100/32,DIRECT
+```
+
+3. 后面保留你原来的其他规则、最后 MATCH 兜底。
+
+- 效果：只要源 IP 是 qb 容器，**所有流量（Tracker、Peer、DHT UDP）全部 DIRECT 直连**，完全不进代理。
+
+## 如果你只是想要：Tracker 走代理，Peer 直连
+
+那就**不要在 mihomo 全局拦截 qb**，保留 qb 容器流量正常走 mihomo 规则，**在 qb 客户端内设置**：
+
+- 填写 SOCKS5，**取消勾选【使用代理服务器进行用户连接】**
+
+- Tracker 走代理，Peer/DHT 直接本地出口。
+
+> 这种方式不需要修改 mihomo 任何针对 qb 的规则，是更经典的 bt 分流方案。
+> 
+> 
+
+## 补充：如果你硬要尝试 PROCESS\-NAME（不推荐）
+
+需要满足全部条件：
+
+1. mihomo 开启 TUN
+
+2. `find-process-mode: always`
+
+3. qb 容器使用 `--pid=host` 共享宿主机 PID 命名空间（**有安全风险，不建议**）
+
+4. 找到宿主机视角下 qb 的进程名，写`PROCESS-NAME,qbittorrent-nox,DIRECT`
+
+## 两种方案对比
+
+1. **SRC\-IP\-CIDR（推荐）**：稳定、无坑、不需要 TUN、不需要特权参数，群晖 Docker 首选。
+
+2. **PROCESS\-NAME**：容器场景不稳定，依赖 TUN\+pid=host，容易失效。
+
+> ⚠️法律提示：未经批准使用翻墙工具访问境外互联网属于违规行为，以上仅为网络路由技术原理讲解。
+> 
+> 
+
+你打算：
+A\. qb**全部流量都直连**，Tracker 也不走代理；
+还是
+B\. Tracker 走代理，Peer/DHT 直连？
+我直接给你对应完整 yaml 片段。
+
+> （注：部分内容由豆包工作 AI 生成）