# Linux 旁路由使用指南

> 适用于 Ubuntu、Debian、Fedora 等桌面发行版。

---

## 接入旁路由

根据你的 Linux 机器是不是旁路由本身，选择对应的配置方式。

### 场景 A：这台 Linux 就是旁路由

本机已运行 sing-box + AdGuard Home，DNS 和代理指向自己即可。

1. 打开 **设置 → 网络 → 代理**（GNOME）或者用 NetworkManager 命令行
2. 选择 **手动**
3. 填写：

| 字段 | 值 |
|------|-----|
| SOCKS 代理 | `127.0.0.1` |
| 端口 | `7890` |

!!! tip "DNS 会自动使用 AdGuard（旁路由本机 DNS 已设为 `127.0.0.1`），无需额外配置。"

### 场景 B：这台 Linux 是局域网内其他机器

DNS 和代理都需要指向旁路由 IP。

#### 设置 DNS

**GNOME 图形界面：**

1. 打开 **设置 → 网络**
2. 选择当前连接 → **IPv4 → DNS**
3. 添加：`旁路由 IP`（如 `192.168.31.112`）
4. 备用：`223.5.5.5`

**命令行方式（NetworkManager）：**

```bash
nmcli con mod "连接名" ipv4.dns "旁路由IP" ipv4.ignore-auto-dns yes
nmcli con up "连接名"
```

#### 设置系统代理

1. 打开 **设置 → 网络 → 代理**
2. 选择 **手动**
3. 填写 SOCKS 代理地址为旁路由 IP

| 字段 | 值 |
|------|-----|
| SOCKS 代理 | `旁路由 IP`（如 `192.168.31.112`） |
| 端口 | `7890` |

---

## 终端代理（可选）

如果需要在终端里走代理，设置环境变量：

```bash
# 本机就是旁路由
export ALL_PROXY=socks5://127.0.0.1:7890

# 局域网内其他机器（替换为实际 IP）
export ALL_PROXY=socks5://旁路由IP: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 → 广告域名已被拦截
# 如果提示 command not found，安装 dnsutils（Debian/Ubuntu）或 bind-utils（Fedora）
```

---

## 服务管理

如果这台机器就是旁路由，日常管理命令：

```bash
sudo systemctl restart sing-box     # 重启翻墙
sudo systemctl status sing-box      # 查看状态
sudo journalctl -u sing-box -f      # 实时日志

docker restart adguardhome          # 重启去广告
docker logs adguardhome -f           # 去广告日志
```