目录

高级日志信息

发布于 2026-06-16 转至英文转至英文转至英文

获取设备上的详细 UniFi 日志非常容易。大多数日志已包含于这里介绍的标准支持文件中。

下面的方法只适用于自行进行高级排错的 高级网络管理员，或在 UI Support 工程师要求时使用。

设备日志

要获取下面提到的日志，你需要首先通过 SSH（安全外壳）连接你感兴趣的设备。详见用 SSH 连接获取更多信息。

通用日志
每台 UniFi 设备会将更多日志存储在如下目录：
```
/var/log/messages
```
要查看所有日志，可使用 cat 命令：
```
cat /var/log/messages
```
若需实时查看日志输出，可使用 tail 命令：
```
tail -f /var/log/messages
```

网关日志
RADIUS 日志

RADIUS 身份验证日志显示在 UniFi Network 的 System Log 选项卡中。如需更高级的日志，可在 UniFi 网关中找到以下目录:
```
/var/log/freeradius/radius.log
```
DNSmasq 日志

自 UniFi Network 版本 7.4 起，可通过 Settings > Networks > IP Leases 查看 DHCP 租约信息。如需更高级的日志，可在 UniFi 网关的以下目录中找到:
```
/var/log/dnsmasq.log
```
威胁管理引擎日志（IPS/IDS）

安全检测日志显示在 UniFi Network 的 System Log 选项卡中。如需更详细的日志，可在 UniFi 网关下列目录中找到:
```
/var/log/suricata/suricata.log
```

交换机日志
UI Support 可能需要你发送附加的交换机日志以供分析。用 SSH 连接至交换机后，可通过以下命令生成所需日志：
```
telnet localhost
enable
show tech-support
```
生成后，将日志内容复制粘贴至 .txt 文件中。

老旧安全网关（USG）
通过 SSH 连接后，可通过如下命令查看通用日志：
```
show log
```
额外的 VPN 日志，可以通过以下命令查看：
```
show vpn log
```
要查看分配给虚拟隧道接口（VTI）的路由，可用如下命令：
```
show ip route | grep vti
```
UI Support 可能会不定期要求你将以下输出复制到 .txt 文件中并共享：
```
show tech-support | no-more
```

其它 UniFi Network 日志

部分日志保存在本地 UniFi Network 应用中，无需 SSH。具体取得方式，取决于 UniFi 的部署环境：

专用 UniFi Cloud 网关（Dream Machines、CloudKeys 等）：日志包含在 *.tgz 文件中。点击此处以了解详细信息。
自托管 UniFi Network 服务器：日志保存在运行 UniFi Network 的 PC/服务器本地。右键 UniFi，选择“Show Package Contents”，或直接进入相关目录。常见目录如下：
- Windows：C:\Users<用户名>\Ubiquiti UniFi\logs\
- macOS：/Users/<用户名>/Library/Application\ Support/UniFi/logs/
- UniFi CloudKey 以及 Debian/Ubuntu Linux*：/usr/lib/unifi/logs/

流量捕获

UI Support 工程师可能会要求你捕获某个设备指定接口上的流量。通常可使用 TCPDUMP 工具完成。用 SSH 连接到设备，根据所用设备输入以下命令：

接入点（Access Points）

tcpdump -i <接口>

网关（Gateways）

tcpdump -npi <接口>

注意：将 <interface> 替换为你关注的具体接口名。

当捕获到足够流量后，复制这些日志至 .txt 文件，即可与支持团队共享。