diff --git a/docs/技术/旁路由使用/Android.md b/docs/技术/旁路由使用/Android.md new file mode 100644 index 0000000..393e661 --- /dev/null +++ b/docs/技术/旁路由使用/Android.md @@ -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 一致 diff --git a/docs/技术/旁路由使用/Linux.md b/docs/技术/旁路由使用/Linux.md new file mode 100644 index 0000000..3bbbba4 --- /dev/null +++ b/docs/技术/旁路由使用/Linux.md @@ -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 # 去广告日志 +``` diff --git a/docs/技术/旁路由使用/Windows.md b/docs/技术/旁路由使用/Windows.md new file mode 100644 index 0000000..d1bb779 --- /dev/null +++ b/docs/技术/旁路由使用/Windows.md @@ -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。 diff --git a/docs/技术/旁路由使用/iPhone.md b/docs/技术/旁路由使用/iPhone.md new file mode 100644 index 0000000..db9d1c6 --- /dev/null +++ b/docs/技术/旁路由使用/iPhone.md @@ -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 → 长按配置 → 编辑。无需删除重建。 diff --git a/docs/技术/旁路由使用/macOS.md b/docs/技术/旁路由使用/macOS.md new file mode 100644 index 0000000..a09f3b3 --- /dev/null +++ b/docs/技术/旁路由使用/macOS.md @@ -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 → 广告域名已被拦截 +``` diff --git a/docs/技术/旁路由部署.md b/docs/技术/旁路由部署.md index e4b4446..35075ce 100644 --- a/docs/技术/旁路由部署.md +++ b/docs/技术/旁路由部署.md @@ -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) | --- diff --git a/mkdocs.yml b/mkdocs.yml index 5b80398..3c5b0ef 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -67,6 +67,12 @@ nav: - 技术: - 技术/index.md - 旁路由部署: 技术/旁路由部署.md + - 旁路由使用: + - Linux: 技术/旁路由使用/Linux.md + - Windows: 技术/旁路由使用/Windows.md + - macOS: 技术/旁路由使用/macOS.md + - Android: 技术/旁路由使用/Android.md + - iPhone: 技术/旁路由使用/iPhone.md - 3D打印: - 3D打印/index.md - 日记: