这篇记录一下 UniFi Cloud Gateway Ultra 在三线 PPPoE 接入环境下的日常运维命令，主要用于查看接口、重拨单条线路、确认路由与 DNS 状态，以及快速排查 PPPoE 相关问题。

设备环境：

  • 设备：UniFi Cloud Gateway Ultra
  • 接入方式：三线 PPPoE
  • 管理方式：UniFi Network Controller + SSH

一、查看 PPPoE 接口

通过 SSH 登录网关后，可以先查看当前 PPPoE 接口：

1
ip addr show | grep ppp

实际环境中，三条线路一般会对应 ppp0、ppp1、ppp2 这类接口。下面是脱敏后的示例关系：

接口 IP 地址 对端网关 说明
ppp0 116.xxx.xxx.xxx 116.xxx.xxx.1 WAN1
ppp1 100.xxx.xxx.xxx 100.xxx.0.1 WAN2
ppp2 116.xxx.xxx.xxx 116.xxx.xxx.1 WAN3

另外可能会看到 ifbppp0、ifbppp1、ifbppp2 这类接口。它们是 IFB（Intermediate Functional Block）虚拟接口，通常用于 QoS 或流量整形，日常排查 PPPoE 拨号时一般不用手动操作。

二、重拨单条 PPPoE 线路

如果只想重拨其中一条 WAN，不需要重启整台网关。先查看 pppd 进程：

1
ps aux | grep pppd

输出会类似这样：

1
2
3
root  2124  ... /usr/sbin/pppd call ppp1 nodetach
root  2125  ... /usr/sbin/pppd call ppp2 nodetach
root  4134  ... /usr/sbin/pppd call ppp0 nodetach

找到目标接口对应的 PID 后，对该进程发送 HUP 信号即可触发断线并自动重新拨号：

1
kill -HUP <PID>

例如要重拨 ppp1，并且它对应的 PID 是 2124：

1
kill -HUP 2124

需要注意的是，直接执行下面这种接口 down/up 操作，对 PPPoE 重拨通常无效：

1
2
ip link set ppp1 down
ip link set ppp1 up

PPPoE 的重拨应通过 pppd 进程处理。

重拨后可以用下面的命令确认 IP 是否变化：

1
ip addr show ppp1

也可以实时查看拨号日志：

1
journalctl -u pppd -f

如果当前系统没有单独的 pppd unit，也可以从系统日志中过滤：

1
tail -f /var/log/syslog | grep ppp

三、查看网络状态

查看所有接口：

1
ip addr show

查看路由表：

1
ip route show

查看默认路由，多 WAN 负载均衡时尤其有用：

1
ip route show table main | grep default

如果要测试某一条线路是否正常，可以指定接口出口进行 ping：

1
2
3
ping -I ppp0 8.8.8.8
ping -I ppp1 8.8.8.8
ping -I ppp2 8.8.8.8

也可以指定接口跑 traceroute：

1
traceroute -i ppp1 8.8.8.8

四、检查 DNS

查看当前 DNS 配置：

1
cat /etc/resolv.conf

测试域名解析：

1
2
nslookup google.com
dig google.com @8.8.8.8

如果 IP 连通但域名打不开，可以优先从 DNS 配置和解析结果入手。

五、查看流量与连接

实时流量监控可以使用 iftop，例如查看 ppp1：

1
iftop -i ppp1

如果只是看接口收发统计，可以用：

1
2
3
ip -s link show ppp0
ip -s link show ppp1
ip -s link show ppp2

查看当前网络连接：

1
ss -tunapl

查看连接数量统计：

1
ss -s

六、进程与服务管理

查看 pppd 服务状态：

1
systemctl status pppd

查看网络相关服务：

1
systemctl list-units --type=service | grep -E "ppp|network|unifi"

如果要重启网络服务，需要谨慎操作，尤其是在远程 SSH 场景下：

1
systemctl restart networking

这类命令可能会导致 SSH 连接中断，建议优先通过 UniFi 控制台或现场环境操作。

七、查看日志

实时查看系统日志：

1
journalctl -f

过滤 PPPoE 相关日志：

1
journalctl | grep -i ppp

查看最近 100 条日志：

1
journalctl -n 100

查看内核网络日志：

1
2
dmesg | grep -i ppp
dmesg | grep -i eth

八、UniFi 控制台操作

除了 SSH，也可以通过 UniFi Network Controller 操作：

  1. 登录 UniFi Network Controller，本地控制器地址或 unifi.ui.com 都可以。
  2. 进入 Settings → Internet。
  3. 查看对应 WAN 接口状态。
  4. 点击对应 WAN 旁边的 Reconnect，可触发重拨。

如果只是偶尔重拨线路，Web 控制台会更直观；如果需要确认接口、路由、日志，则 SSH 更适合。

九、SSH 快速参考

默认 SSH 连接：

1
ssh root@<gateway-ip>

查看设备基本信息：

1
2
uname -a
cat /etc/os-release

查看 CPU、内存和磁盘使用情况：

1
2
3
top
free -h
df -h

十、常见故障排查

问题 排查方式
某条线路断线 ip addr show pppX 确认接口状态
PPPoE 无法拨号 journalctl | grep -i ppp 查看错误日志
路由异常 ip route show 检查默认路由
DNS 解析失败 dig google.com @8.8.8.8 测试解析
带宽跑不满 iftop -i pppX 查看实时流量
单线重拨无效 确认是否对正确的 pppd PID 执行了 kill -HUP

小结

UniFi Cloud Gateway Ultra 的多线 PPPoE 排查思路可以按这个顺序走：

  1. 先确认 ppp0、ppp1、ppp2 是否存在并拿到地址。
  2. 再用 ping -I 或 traceroute -i 单独测试每条线路。
  3. 如果需要重拨，只重启目标线路对应的 pppd 进程。
  4. 最后通过 journalctl、ip route show 和 DNS 测试定位具体问题。

这样可以避免一上来就重启整台网关，也能更清楚地判断是哪一条 WAN 出了问题。