kurihada/notebook
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

拆分旁路由使用教程为5个平台独立文档（Linux/Windows/macOS/Android/iPhone）

Browse Source
This commit is contained in:
kurihada
2026-06-04 10:26:18 +08:00
parent 30142a7ba9
commit cdb7bc3508
7 changed files with 399 additions and 23 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/技术/旁路由使用/Android.md
+82
View File
@@ -0,0 +1,82 @@
# Android 旁路由使用指南
---
## 在家（连 WiFi）
### 1. 设置 DNS（去广告）
1. 打开 **设置 → WLAN**
2. 长按当前连接的 WiFi → **修改网络**
3. 勾选 **显示高级选项**
4. **IP 设置** 选择 **静态**
5. 填写 **DNS 1**：`旁路由 IP`（如 `192.168.31.112`）
6. **DNS 2**：`223.5.5.5`（备用）
7. 保存
### 2. 设置代理（翻墙）
1. 同样在 WiFi 高级设置中
2. **代理** 选择 **手动**
3. 填写：
| 字段 | 值 |
|------|-----|
| 代理主机名 | `旁路由 IP`（如 `192.168.31.112`） |
| 代理端口 | `7890` |
4. 保存
?> 不同 Android 厂商设置路径略有差异，核心就是 WiFi → 高级 → 静态 IP + 手动代理。
---
## 出门（4G/5G）
需要使用客户端 App 直连 VPS：
### 推荐 App
| App | 价格 | 说明 |
|-----|:---:|------|
| **Hiddify Next** | 免费 | 开源，支持 VLESS Reality |
| **v2rayNG** | 免费 | 老牌客户端，功能全面 |
| **Clash Meta** | 免费 | 规则灵活 |
### 配置方法
以 Hiddify Next 为例：
1. 从 GitHub Release 或 Google Play 安装
2. 添加配置 → 手动输入
3. 协议选择 **VLESS**，填入与 VPS 一致的信息：
- 地址：`VPS IP`
- 端口：`8443`
- UUID：与 VPS 服务端相同
- Flow：`xtls-rprx-vision`
- TLS：开启
- SNI：`www.microsoft.com`
- Reality：开启
- 公钥/ShortID：与 VPS 配置一致
4. 保存并连接
---
## 验证
- 浏览器打开 `https://www.google.com` → 能访问即代理正常
- 打开任意国内带广告的 app/网页 → 广告减少说明 DNS 过滤生效
---
## 常见问题
### WiFi 下代理不生效？
有些 app（如银行类）不走系统代理。可以在 Hiddify Next 等 App 中使用 **VPN 模式**，接管全部流量。
### 出门时无法连接 VPS？
1. 检查 VPS 是否在线
2. 检查手机网络是否正常
3. 确认配置参数（UUID、公钥、ShortID）与 VPS 一致
docs/技术/旁路由使用/Linux.md
+66
View File
@@ -0,0 +1,66 @@
# Linux 旁路由使用指南
> 适用于 Ubuntu、Debian、Fedora 等桌面发行版。
---
## 接入旁路由
### 系统代理（GNOME）
1. 打开 **设置 → 网络 → 代理**
2. 选择 **手动**
3. 填写：
| 字段 | 值 |
|------|-----|
| SOCKS 代理 | `127.0.0.1` |
| 端口 | `7890` |
?> DNS 会自动使用 AdGuard（因为旁路由本机 DNS 已设为 `127.0.0.1`）。
### 终端代理（可选）
如果需要在终端里走代理，设置环境变量：
```bash
export ALL_PROXY=socks5://127.0.0.1:7890
```
或者写入 `~/.bashrc` 持久化：
```bash
echo 'alias proxy="export ALL_PROXY=socks5://127.0.0.1:7890"' >> ~/.bashrc
echo 'alias unproxy="unset ALL_PROXY"' >> ~/.bashrc
```
用的时候 `proxy` 开启，`unproxy` 关闭。
---
## 验证
```bash
# 测试代理是否通
curl --socks5 127.0.0.1:7890 https://www.google.com -o /dev/null -s -w '%{http_code}'
# 返回 200 → 正常
# 测试 DNS 去广告
nslookup doubleclick.net
# 返回 0.0.0.0 → 广告域名已被拦截
```
---
## 服务管理
旁路由本机就是服务器，所以日常管理命令也在这里执行：
```bash
sudo systemctl restart sing-box # 重启翻墙
sudo systemctl status sing-box # 查看状态
sudo journalctl -u sing-box -f # 实时日志
docker restart adguardhome # 重启去广告
docker logs adguardhome -f # 去广告日志
```
docs/技术/旁路由使用/Windows.md
+69
View File
@@ -0,0 +1,69 @@
# Windows 旁路由使用指南
---
## 接入旁路由
### 1. 设置 DNS（去广告）
1. 打开 **设置 → 网络和 Internet → 以太网/WiFi → 属性**
2. 找到 **DNS 服务器分配** → 点击 **编辑**
3. 选择 **手动**，开启 IPv4
4. 填写：
| 字段 | 值 |
|------|-----|
| 首选 DNS | `旁路由 IP`（如 `192.168.31.112`） |
| 备用 DNS | `223.5.5.5` |
### 2. 关闭浏览器 DNS over HTTPS
这一步很重要，否则浏览器会用自己加密的 DNS，绕过 AdGuard。
- **Chrome**：设置 → 隐私和安全 → 安全 → 高级 → 关闭 **使用安全 DNS**
- **Edge**：设置 → 隐私、搜索和服务 → 安全 → 关闭 **使用安全 DNS 指定如何查找网站的网络地址**
### 3. 设置系统代理（翻墙）
需要翻墙时开启：
1. 打开 **设置 → 网络和 Internet → 代理**
2. 手动设置代理 → 开启 **使用代理服务器**
3. 填写：
| 字段 | 值 |
|------|-----|
| 地址 | `旁路由 IP`（如 `192.168.31.112`） |
| 端口 | `7890` |
4. 点击 **保存**
?> 不需要翻墙时关掉即可，国内网站直连，不受影响。
---
## 验证
```powershell
# 测试 DNS 去广告
nslookup doubleclick.net
# 返回 0.0.0.0 → 广告已被拦截
# 测试代理（开启代理后）
curl https://www.google.com -o nul -s -w "%{http_code}"
# 返回 200 → 正常
```
---
## 常见问题
### DNS 去广告不生效？
1. 检查 DNS 是否真的指向了旁路由：`nslookup google.com`，看返回的服务器地址
2. 确认 Chrome/Edge 的 DNS over HTTPS 已关闭
3. 确认 AdGuard 容器在运行（在旁路由上执行 `docker ps | grep adguardhome`）
### WiFi 切换后 DNS 丢失？
Windows 每个网络配置是独立的。换个 WiFi 需要重新设置 DNS。
docs/技术/旁路由使用/iPhone.md
+100
View File
@@ -0,0 +1,100 @@
# iPhone / iPad 旁路由使用指南
---
## 在家（连 WiFi）
### 1. 设置 DNS（去广告）
1. 打开 **设置 → 无线局域网**
2. 点击当前 WiFi 右边的 **ⓘ**
3. 下滑找到 **配置 DNS** → 改为 **手动**
4. 删除原有 DNS，添加：
```
旁路由 IP（如 192.168.31.112）
223.5.5.5
```
5. 点击 **存储**
### 2. 设置代理（翻墙）
1. 同样在 WiFi 详情页
2. 下滑找到 **HTTP 代理** → **配置代理** → 选择 **手动**
3. 填写：
| 字段 | 值 |
|------|-----|
| 服务器 | `旁路由 IP`（如 `192.168.31.112`） |
| 端口 | `7890` |
4. 点击 **存储**
---
## 出门（4G/5G）
### 推荐 App
| App | 价格 | 说明 |
|-----|:---:|------|
| **Shadowrocket**（小火箭） | 美区 $2.99 | 最流行，稳定好用 |
| **Hiddify Next** | 免费 | 开源替代，功能相近 |
### Shadowrocket 配置
1. 美区 App Store 购买安装（约 $2.99）
2. 打开 → 右上角 **+** → 类型选择 **VLESS**
3. 填入以下参数：
| 设置 | 值 |
|------|-----|
| 地址 | `VPS IP` |
| 端口 | `8443` |
| UUID | 与 VPS 配置相同 |
| Flow | `xtls-rprx-vision` |
| 传输方式 | TCP |
| TLS | 开启 |
| SNI | `www.microsoft.com` |
| Reality | 开启 |
| 公钥 | 与 VPS 配置相同 |
| Short ID | 与 VPS 配置相同 |
| 指纹 | `chrome` |
| 加密 | `none` |
4. 保存 → 开启连接
5. 首次连接会弹出 VPN 授权，点击 **允许**
### Hiddify Next 配置（免费方案）
1. App Store 搜索 Hiddify Next 安装
2. 添加配置 → 手动输入
3. 协议 VLESS，参数同上表
4. 保存连接
---
## 验证
- Safari 打开 `https://www.google.com` → 能访问即代理正常
- 打开广告多的网页或 app → 广告减少说明 DNS 过滤生效
---
## 常见问题
### WiFi 代理不生效？
有些 app 不走 HTTP 代理。可以用 Shadowrocket/Hiddify Next 的 **代理模式** 在 WiFi 下也开启，无需设置系统 HTTP 代理。
### 出门无法连接 VPS？
1. 确认 VPS 在线
2. 检查配置参数（UUID、公钥、ShortID）拼写正确
3. 确认 VPS 防火墙已放行 8443 端口
4. 尝试切换手机网络（WiFi/4G/5G）
### 要改配置怎么办？
Shadowrocket → 长按配置 → 编辑。无需删除重建。
docs/技术/旁路由使用/macOS.md
+68
View File
@@ -0,0 +1,68 @@
# macOS 旁路由使用指南
---
## 接入旁路由
### 1. 设置 DNS（去广告）
1. 打开 **系统设置 → 网络**
2. 选择当前连接的网络（WiFi 或以太网）
3. 点击 **详细信息 → DNS**
4. 点击 **+**，添加：
```
旁路由 IP（如 192.168.31.112）
```
5. 再添加备用 DNS：`223.5.5.5`
6. 点击 **好**
### 2. 关闭浏览器 DNS over HTTPS
- **Chrome**：设置 → 隐私和安全 → 安全 → 高级 → 关闭 **使用安全 DNS**
- **Safari**：Safari 默认使用系统 DNS，无需额外设置
### 3. 设置系统代理（翻墙）
需要翻墙时开启：
1. 打开 **系统设置 → 网络**
2. 选择当前连接 → **详细信息 → 代理**
3. 开启 **SOCKS 代理**，填写：
| 字段 | 值 |
|------|-----|
| SOCKS 代理服务器 | `旁路由 IP`（如 `192.168.31.112`） |
| 端口 | `7890` |
4. 点击 **好**
?> 不需要翻墙时关掉即可。也可以使用 **SwitchyOmega**（Chrome 扩展）按规则自动切换，国内网站不走代理。
---
## 终端代理（可选）
```bash
# 临时开启
export ALL_PROXY=socks5://旁路由IP:7890
# 写入 ~/.zshrc 持久化
echo 'alias proxy="export ALL_PROXY=socks5://旁路由IP:7890"' >> ~/.zshrc
echo 'alias unproxy="unset ALL_PROXY"' >> ~/.zshrc
```
---
## 验证
```bash
# 测试代理是否通
curl --socks5 旁路由IP:7890 https://www.google.com -o /dev/null -s -w '%{http_code}'
# 返回 200 → 正常
# 测试 DNS 去广告
nslookup doubleclick.net
# 返回 0.0.0.0 → 广告域名已被拦截
```
docs/技术/旁路由部署.md
+8 -23
View File
@@ -299,30 +299,15 @@ https://dns.quad9.net/dns-query
### 1.6 步骤五：各设备接入
#### Ubuntu 本机
部署完成后，各终端设备需要配置 DNS 和代理才能使用旁路由。每个平台的设置方式不同，详见各平台使用指南：
系统设置 → 网络代理 → 手动：
- SOCKS5 代理：`127.0.0.1:7890`
- DNS：系统会自动使用 AdGuard（因为旁路由 DNS 设为 `127.0.0.1`）
#### Windows
- **DNS**：网络设置 → IPv4 → DNS 手动设为旁路由 IP（如 `192.168.31.112`），备用 `223.5.5.5`
- **代理**：需要翻墙时开系统代理 SOCKS5 `旁路由IP:7890`
- **重要**：Chrome/Edge 设置 → 关闭「使用安全 DNS」（DNS over HTTPS），否则会绕过 AdGuard
#### 手机（连 WiFi 时）
- **DNS**：WiFi 设置 → IP 设为静态 → DNS 填旁路由 IP
- **代理**：WiFi 设置 → HTTP 代理 → 手动 → 服务器 `旁路由IP`，端口 `7890`
#### 手机（出门 4G/5G）
需要使用客户端 App 直连 VPS：
- **Shadowrocket**（iOS，美区 $2.99）
- **Hiddify Next**（免费，iOS/Android 都支持）
配置：VLESS + Reality，参数与 VPS 服务端一致。
| 平台 | 文档 |
|------|------|
| 🐧 Linux | [Linux 使用指南](旁路由使用/Linux.md) |
| 🪟 Windows | [Windows 使用指南](旁路由使用/Windows.md) |
| 🍎 macOS | [macOS 使用指南](旁路由使用/macOS.md) |
| 🤖 Android | [Android 使用指南](旁路由使用/Android.md) |
| 📱 iPhone / iPad | [iPhone 使用指南](旁路由使用/iPhone.md) |
---