427 lines
12 KiB
Markdown
427 lines
12 KiB
Markdown
# qBittorrent 透明代理 + BT 入站转发配置文档
|
||
|
||
## 架构总览
|
||
|
||
```
|
||
出站（透明代理）
|
||
qBittorrent(192.168.1.200) 互联网
|
||
↓ nftables TPROXY 劫持 ↑
|
||
↓ mihomo:7893 │
|
||
↓ SRC-IP-CIDR → PT-BT → Beijing-Direct │
|
||
↓ Reality(VLESS, SNI=news.apple.com) │
|
||
↓ 北京VPS:443 → Nginx分流 │
|
||
↓ proxy_from_lan:9445 → direct(freedom) ─────────────────┘
|
||
|
||
入站（端口转发）
|
||
Peer → 北京VPS:51413 → external_qbit → portal
|
||
→ bridge隧道 → 旁路由 → to_qbit → 192.168.1.200:51413
|
||
```
|
||
|
||
---
|
||
|
||
## 设备清单
|
||
|
||
| 设备 | IP | 角色 |
|
||
|---|---|---|
|
||
| 北京VPS | `salmonstill.cn` / `49.232.242.90` | 公网出口 + 入站入口 |
|
||
| 旁路由 | `192.168.1.199` | TPROXY 透明代理 + Xray 桥接 |
|
||
| NAS | `192.168.1.188` | Docker 宿主机 |
|
||
| qBittorrent 容器 | `192.168.1.200` | macvlan 独立 IP，PT 专用 |
|
||
|
||
---
|
||
|
||
## 第一部分：北京 VPS 配置
|
||
|
||
### 1.1 Nginx Stream SNI 分流 `beijing-vps-stream.conf`
|
||
|
||
新增 `news.apple.com` SNI 映射（用于旁路由 Mihomo 直连代理）：
|
||
|
||
```nginx
|
||
stream {
|
||
map $ssl_preread_server_name $backend {
|
||
www.apple.com xray; # 旁路由反向代理隧道
|
||
www.microsoft.com mihomo; # 外部客户端代理 → 东京出口
|
||
news.apple.com xray_lan; # 旁路由 Mihomo 北京直连代理
|
||
drive.salmonstill.cn nas; # 绿联云服务
|
||
default npm; # Nginx Proxy Manager
|
||
}
|
||
upstream xray { server 127.0.0.1:9443; }
|
||
upstream mihomo { server 127.0.0.1:9444; }
|
||
upstream xray_lan { server 127.0.0.1:9445; } # 新增
|
||
upstream nas { server 127.0.0.1:38653; }
|
||
upstream npm { server 127.0.0.1:8443; }
|
||
|
||
server {
|
||
listen 443 reuseport;
|
||
listen [::]:443 reuseport;
|
||
ssl_preread on;
|
||
proxy_pass $backend;
|
||
}
|
||
}
|
||
```
|
||
|
||
### 1.2 Xray 配置 `xray-北京vps-config.json`
|
||
|
||
#### 新增入站 `proxy_from_lan`（北京直连出口）
|
||
|
||
```json
|
||
{
|
||
"tag": "proxy_from_lan",
|
||
"listen": "127.0.0.1",
|
||
"port": 9445,
|
||
"protocol": "vless",
|
||
"settings": {
|
||
"clients": [
|
||
{
|
||
"id": "113e167a-a2be-4b46-9010-60020108626c",
|
||
"flow": "xtls-rprx-vision"
|
||
}
|
||
],
|
||
"decryption": "none"
|
||
},
|
||
"streamSettings": {
|
||
"network": "raw",
|
||
"security": "reality",
|
||
"realitySettings": {
|
||
"show": false,
|
||
"target": "www.apple.com:443",
|
||
"serverNames": ["news.apple.com"],
|
||
"privateKey": "GGT9LfN_2JdQG68cwrULgUK-adfT6wIokLzWjaB0fXs",
|
||
"shortIds": ["7c947a71b94f369e"]
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
> Reality 公私钥复用已有的 `interconn` 入站 keypair，`serverNames` 用新的 `news.apple.com` 与 Nginx 对应。
|
||
> `target` 设为 `www.apple.com:443`，Reality 从此地址偷取真实 TLS 证书用于伪装。
|
||
|
||
#### 新增入站 `external_qbit`（BT 入站端口）
|
||
|
||
```json
|
||
{
|
||
"tag": "external_qbit",
|
||
"listen": "0.0.0.0",
|
||
"port": 51413,
|
||
"protocol": "dokodemo-door",
|
||
"settings": {
|
||
"address": "127.0.0.1",
|
||
"port": 51413,
|
||
"network": "tcp"
|
||
}
|
||
}
|
||
```
|
||
|
||
> 仅 TCP——Xray portal 反向代理对 UDP 支持不完善，BT 的 μTP(UDP) 走不了，需要在 qBittorrent 里关闭。
|
||
|
||
#### 新增路由规则
|
||
|
||
```json
|
||
{ "type": "field", "inboundTag": ["proxy_from_lan"], "outboundTag": "direct" },
|
||
{ "type": "field", "inboundTag": ["external_qbit"], "outboundTag": "portal" }
|
||
```
|
||
|
||
### 1.3 腾讯云防火墙
|
||
|
||
新开端口：
|
||
|
||
| 端口 | 协议 | 用途 |
|
||
|---|---|---|
|
||
| 51413 | TCP | BT 入站 |
|
||
|
||
---
|
||
|
||
## 第二部分：旁路由 Mihomo 透明代理
|
||
|
||
### 2.1 配置 `旁路由的mihomo config.yaml`
|
||
|
||
#### 关键设置
|
||
|
||
```yaml
|
||
# TPROXY 透明代理入口（替代 TUN 模式）
|
||
tproxy-port: 7893
|
||
```
|
||
|
||
#### 北京直连代理节点
|
||
|
||
```yaml
|
||
proxies:
|
||
- name: Beijing-Direct
|
||
type: vless
|
||
server: salmonstill.cn
|
||
port: 443
|
||
uuid: "113e167a-a2be-4b46-9010-60020108626c"
|
||
udp: true
|
||
flow: xtls-rprx-vision
|
||
packet-encoding: xudp
|
||
tls: true
|
||
servername: news.apple.com
|
||
skip-cert-verify: true # Reality 下必须跳过证书 SAN 校验
|
||
client-fingerprint: chrome
|
||
reality-opts:
|
||
public-key: "62y5gDjPrdeuePGl-D2IW4C9wKb8_bSBBTmArvL7Nhs"
|
||
short-id: "7c947a71b94f369e"
|
||
network: tcp
|
||
```
|
||
|
||
> `skip-cert-verify: true` 必须加——Reality 返回的是 `www.apple.com` 的证书（来自 target），但 SNI 是 `news.apple.com`，Mihomo 的 TLS 验证会因为 SAN 不匹配而拒绝。
|
||
|
||
#### PT-BT 策略组
|
||
|
||
```yaml
|
||
proxy-groups:
|
||
- name: PT-BT
|
||
type: select
|
||
proxies: [Beijing-Direct, 直连]
|
||
```
|
||
|
||
#### qBittorrent 透明代理规则
|
||
|
||
```yaml
|
||
rules:
|
||
# 防死循环：北京 VPS 和东京 VPS 的 IP 必须直连
|
||
- IP-CIDR,49.232.242.90/32,直连
|
||
- IP-CIDR,43.165.178.10/32,直连
|
||
# ... 其他防死循环规则 ...
|
||
- SRC-IP-CIDR,192.168.1.200/32,PT-BT,no-resolve # qBittorrent 全部流量走代理
|
||
```
|
||
|
||
> `SRC-IP-CIDR` 匹配**来源 IP**，不是目的 IP。所有从 192.168.1.200 发出的流量都会被 PT-BT 策略组接管。
|
||
> `no-resolve` 防止 DNS 解析阶段误触发。
|
||
|
||
---
|
||
|
||
## 第三部分：旁路由 nftables TPROXY 规则
|
||
|
||
### 3.1 规则文件 `/etc/nftables.d/50-mihomo-tproxy.nft`
|
||
|
||
```nft
|
||
#!/usr/sbin/nft -f
|
||
|
||
table inet mihomo_tproxy {
|
||
chain prerouting {
|
||
type filter hook prerouting priority mangle; policy accept;
|
||
|
||
# 不劫持本地/私有地址
|
||
ip daddr 127.0.0.0/8 return
|
||
ip daddr 10.0.0.0/8 return
|
||
ip daddr 172.16.0.0/12 return
|
||
ip daddr 192.168.0.0/16 return
|
||
ip daddr 224.0.0.0/4 return
|
||
|
||
# 不劫持到北京/东京 VPS 的流量（防死循环）
|
||
ip daddr 49.232.242.90 return
|
||
ip daddr 43.165.178.10 return
|
||
|
||
# 劫持 192.168.1.200 的全部流量到 TPROXY
|
||
ip saddr 192.168.1.200 meta mark set 1 tproxy to :7893 accept
|
||
}
|
||
}
|
||
```
|
||
|
||
> ImmortalWrt 使用 fw4（nftables），放在 `/etc/nftables.d/` 下会被自动加载。
|
||
|
||
### 3.2 策略路由 `/etc/rc.local`
|
||
|
||
```bash
|
||
# 让被 fwmark=1 标记的包走本地回环（TPROXY 要求）
|
||
ip rule add fwmark 1 table 100 2>/dev/null
|
||
ip route add local 0.0.0.0/0 dev lo table 100 2>/dev/null
|
||
|
||
# 加载 nftables 规则（如果 fw4 reload 没自动加载）
|
||
sleep 5
|
||
nft add table inet mihomo_tproxy 2>/dev/null
|
||
nft -f /etc/nftables.d/50-mihomo-tproxy.nft
|
||
|
||
exit 0
|
||
```
|
||
|
||
### 3.3 验证 TPROXY
|
||
|
||
```bash
|
||
# 确认 nftables 规则
|
||
nft list chain inet mihomo_tproxy prerouting | grep 192.168
|
||
|
||
# 确认策略路由
|
||
ip rule show | grep "fwmark 1"
|
||
|
||
# 确认端口监听
|
||
ss -tlnp | grep 7893
|
||
```
|
||
|
||
---
|
||
|
||
## 第四部分：旁路由 Xray 51413 转发
|
||
|
||
### 4.1 配置 `xray-旁路由-config.json`
|
||
|
||
#### 新增加出站 `to_qbit`
|
||
|
||
```json
|
||
{
|
||
"tag": "to_qbit",
|
||
"protocol": "freedom",
|
||
"settings": {
|
||
"redirect": "192.168.1.200:51413"
|
||
}
|
||
}
|
||
```
|
||
|
||
#### 新增路由规则
|
||
|
||
```json
|
||
{
|
||
"type": "field",
|
||
"inboundTag": ["bridge"],
|
||
"port": "51413",
|
||
"outboundTag": "to_qbit"
|
||
}
|
||
```
|
||
|
||
> 放在 bridge 下——从北京 VPS 的 portal 通过反向隧道过来的 BT 入站流量，由 bridge 接收后按端口 51413 匹配到此规则，转发到 qBittorrent 容器。
|
||
|
||
---
|
||
|
||
## 第五部分：NAS qBittorrent Docker
|
||
|
||
### 5.1 创建 macvlan 网络
|
||
|
||
```bash
|
||
docker network create -d macvlan \
|
||
--subnet=192.168.1.0/24 \
|
||
--gateway=192.168.1.199 \
|
||
--ip-range=192.168.1.200/32 \
|
||
-o parent=eth0 \
|
||
qbit_macvlan
|
||
```
|
||
|
||
> `--gateway=192.168.1.199`：qBittorrent 的默认网关设为旁路由，确保流量经过 TPROXY。
|
||
> `--ip-range=192.168.1.200/32`：固定 IP，对应 nftables 劫持规则。
|
||
|
||
### 5.2 启动容器
|
||
|
||
```bash
|
||
docker run -d \
|
||
--name qbittorrent \
|
||
--network qbit_macvlan \
|
||
--ip 192.168.1.200 \
|
||
-e WEBUI_PORT=8090 \
|
||
-p 8090:8090 \
|
||
-v /path/to/downloads:/downloads \
|
||
lscr.io/linuxserver/qbittorrent:latest
|
||
```
|
||
|
||
### 5.3 qBittorrent 设置
|
||
|
||
| 设置项 | 值 |
|
||
|---|---|
|
||
| 监听端口 | `51413` |
|
||
| UPnP/NAT-PMP | **禁用** |
|
||
| SOCKS5 代理 | **清空（不使用）** |
|
||
| 连接协议 | **仅 TCP**（关闭 μTP） |
|
||
| DHT | 可选（建议开） |
|
||
| PEX | 可选（建议开） |
|
||
|
||
> 关闭 μTP(UDP)：Xray portal 反向代理不支持 UDP，BT 的 μTP 走 UDP 会导致入站失败。
|
||
|
||
### 5.4 定时做种调度（crontab）
|
||
|
||
让 qBittorrent 只在夜间（01:00-07:00）做种，白天暂停以节省带宽：
|
||
|
||
```bash
|
||
crontab -e
|
||
```
|
||
|
||
添加以下两行（在 NAS 或任意可访问 192.168.1.200 的设备上）：
|
||
|
||
```
|
||
0 1 * * * curl -s -X POST "http://192.168.1.200:8888/api/v2/torrents/start" --data "hashes=all"
|
||
0 7 * * * curl -s -X POST "http://192.168.1.200:8888/api/v2/torrents/stop" --data "hashes=all"
|
||
```
|
||
|
||
| 时间 | 操作 | 含义 |
|
||
|---|---|---|
|
||
| 凌晨 01:00 | `/torrents/start` `hashes=all` | 启动全部种子开始做种 |
|
||
| 早上 07:00 | `/torrents/stop` `hashes=all` | 停止全部种子 |
|
||
|
||
---
|
||
|
||
## 第六部分：部署顺序
|
||
|
||
```
|
||
1. 腾讯云防火墙 → 开放 51413/tcp
|
||
2. scp beijing-vps-stream.conf → 北京VPS /etc/nginx/stream.conf.d/
|
||
3. scp xray-北京vps-config.json → 北京VPS /usr/local/etc/xray/config.json
|
||
4. 北京VPS: nginx -t && systemctl reload nginx
|
||
5. 北京VPS: systemctl restart xray
|
||
6. scp 旁路由的mihomo config.yaml → 旁路由 /opt/mihomo/config.yaml
|
||
7. scp xray-旁路由-config.json → 旁路由 /etc/xray/config.json
|
||
8. 旁路由: 创建 nftables 规则文件 + rc.local 策略路由
|
||
9. 旁路由: /etc/init.d/mihomo restart
|
||
10. 旁路由: /etc/init.d/xray restart
|
||
11. 旁路由: fw4 reload 或 nft -f /etc/nftables.d/50-mihomo-tproxy.nft
|
||
12. NAS: 创建 macvlan 网络 + 启动 qBittorrent 容器
|
||
13. NAS: 配置 qBittorrent 监听端口 51413，关闭 μTP
|
||
```
|
||
|
||
---
|
||
|
||
## 第七部分：验证
|
||
|
||
### 7.1 TPROXY 透明代理出站
|
||
|
||
```bash
|
||
# 在 NAS 上执行，应返回北京 VPS 的公网 IP
|
||
docker exec qbittorrent curl https://ip.sb
|
||
|
||
# 确认不是东京 VPS 的 IP
|
||
docker exec qbittorrent curl https://ifconfig.io
|
||
```
|
||
|
||
### 7.2 Mihomo 面板查看
|
||
|
||
浏览器打开 `http://192.168.1.199:9090` → 连接 → 应能看到大量通过 `Beijing-Direct` 的连接。
|
||
|
||
### 7.3 BT 入站验证
|
||
|
||
```bash
|
||
# 北京 VPS 上确认端口监听
|
||
ss -tlnp | grep 51413
|
||
|
||
# 从外部测试端口可达
|
||
nc -zv salmonstill.cn 51413
|
||
```
|
||
|
||
### 7.4 端到端 BT 测试
|
||
|
||
下载一个热门 Ubuntu torrent 种子，观察：
|
||
- qBittorrent WebUI → 连接 → 应显示 DHT 节点数增长
|
||
- 跟踪器页面 → 应显示 "Working"
|
||
- 下载速度应有上传来确认入站工作
|
||
|
||
---
|
||
|
||
## 第八部分：故障排查
|
||
|
||
| 现象 | 排查 |
|
||
|---|---|
|
||
| qBittorrent curl ip.sb 返回真实 IP | nftables 规则未生效，检查 `nft list chain inet mihomo_tproxy prerouting` |
|
||
| Beijing-Direct 连不上 | 确认 `servername: news.apple.com` + `skip-cert-verify: true` |
|
||
| 入站无上传 | 检查北京 VPS ufw/腾讯云安全组已放行 51413/tcp |
|
||
| xray 报错 `reverse-proxy.xray.internal` | portal/bridge 域名不匹配，两边必须一致 |
|
||
| 旁路由自身网络异常 | nftables 规则漏了 `ip daddr 192.168.0.0/16 return`，检查私有地址排除 |
|
||
| 下载有速度、无上传 | μTP 没关或 portal UDP 不支持，qBittorrent 设置仅 TCP |
|
||
|
||
---
|
||
|
||
## 第九部分：文件清单
|
||
|
||
| 文件 | 位置 | 作用 |
|
||
|---|---|---|
|
||
| `beijing-vps-stream.conf` | 北京VPS `/etc/nginx/stream.conf.d/` | Nginx SNI分流（含 news.apple.com → 9445） |
|
||
| `xray-北京vps-config.json` | 北京VPS `/usr/local/etc/xray/config.json` | Xray 入站+路由（含 proxy_from_lan + external_qbit） |
|
||
| `旁路由的mihomo config.yaml` | 旁路由 `/opt/mihomo/config.yaml` | Mihomo TPROXY + Beijing-Direct + PT-BT 规则 |
|
||
| `xray-旁路由-config.json` | 旁路由 `/etc/xray/config.json` | Xray bridge + to_qbit(51413) + socks-lan(1080) |
|
||
| `/etc/nftables.d/50-mihomo-tproxy.nft` | 旁路由 | nftables TPROXY 劫持规则 |
|
||
| `/etc/rc.local` | 旁路由 | 策略路由 + nft 加载（持久化） |
|