概述


本文将介绍如何从 UniFi Dream Machine(UDM 或 UDM-Pro)获取支持文件和其他日志消息。

注意事项和要求:
  • 适用于 UniFi Dream Machine 机型(UDM / UDM-Pro)。
  • 仅在必要时按照本文中的步骤操作,并且 Ubiquiti 技术支持团队的成员已指示您下载支持文件或其他日志。
  • 支持文件包含敏感数据,不应与 Ubiquiti 技术支持人员以外的任何人共享。

目录



介绍


下图展示了示例设置,其中有线和无线客户端直接连接到 UDM/UDM-Pro 并使用 192.168.1.0/24 范围内的 IP 地址。

1.png

工作站直接连接到 UDM / UDM-Pro 上的 LAN 端口之一的示例设置。

UDM / UDM-Pro 支持文件和日志包含重要的设备信息,在调试或故障排除问题时非常有用。 可以通过使用 Web UI 访问设备来下载支持文件,并且可以 使用 SSH 协议 获取日志。

注意: 支持文件包含敏感数据,不应与 Ubiquiti 技术支持人员以外的任何人共享。

使用 Web UI 获取支持文件


在 UniFiOS 固件(UDM-Pro 为 v1.6.4+,UDM 为 v1.7.0+)上,可以从 设置(Settings) > 高级(Advanced) 下载支持文件。 请按照以下步骤连接到 UDM / UDM-Pro 以获取支持文件和日志:

访问 UDM/UDM-Pro 上的管理 Web UI
  1. 将您的工作站直接连接到 UDM / UDM-Pro 上的 LAN 端口之一或连接到 UDM 上的 Wi-Fi 网络。
  2. 如果 UDM / UDM-Pro 使用默认 LAN 网络设置,您的工作站将收到 192.168.1.0/24 范围内的 IP 地址。
  3. 打开兼容的 Web 浏览器(例如 Google Chrome)并导航到 https://unifihttps://192.168.1.1 的管理 Web UI。
  4. 使用您的 UI.com 证书登录。

1.png

  1. 导航到 设置(Settings)菜单。
  2. 选择 高级(Advanced)选项卡并下载支持文件。

1.png

  1. 选择 确认(Confirm)下载文件并将其存储在您的计算机上。

使用 SSH 获取设备日志


UDM / UDM-Pro 上的日志存储在 /var/log/ 目录中,可以使用安全复制协议 (SCP) 和安全外壳 (SSH) 协议获取。 有关如何使用 SSH 登录 UDM / UDM-Pro 的更多信息,请参阅 UniFi - UDM:如何使用 SSH 登录 Dream Machine 一文。

使用上面链接的文章启用服务后,您可以从工作站连接到 SSH 服务器 (UDM / UDM-Pro)。

CLI: 使用 SSH 访问 UDM / UDM-Pro 上的命令行界面
  1. 使用您喜欢的 SSH/Telnet 客户端程序(例如 PuTTY 或 macOS/Linux 终端)打开 SSH 会话。

Windows 客户端


1. 下载 PuTTY,双击 putty.exe 执行文件。

2. 填写以下设置并选择 打开


    Host Name (or IP address): 192.168.1.1
    Port: 22
    Connection type: SSH
    
注意: 你也可以通过 unifi 主机名连接而不是 IP 地址。

3. 如果有提示,接受 SSH 安全警告。

4. 使用 root 用户账户和你之前配置的 SSH 密码登录。


    Username: root
    Password: <password>
    

macOS 客户端


1. 通过在启动器中搜索终端或导航到 搜索器(Finder)>应用程序(Applications)>实用工具(Utilities) 部分来打开 macOS 终端。

2. 使用 ssh 命令,并指定 UDM / UDM-Pro 的用户名,后面是 @ 符号和 IP 地址。


    ssh <username>@<ip-address>
    

3. 要连接到使用默认 192.168.1.1 IP 地址和 root 用户名的 UDM / UDM-Pro,请运行。


    ssh root@192.168.1.1
    
注意: 你也可以通过 unifi 主机名连接而不是 IP 地址。

4. 如果有提示,接受 SSH 安全警告。

5. 使用之前配置的 SSH 密码登录。


    Username: root
    Password: <password>
    
  1. 登录后,您可以使用以下命令显示 /var/log/ 目录的内容:
ls -l /var/log/ | grep messages
  1. 日志包含在以数字结尾的单个或多个 消息文件 中。 例如:
# ls -l /var/log/ | grep messages
lrwxrwxrwx    1 root     root            22 Jun 18 05:49 messages -> /mnt/data/log/messages
lrwxrwxrwx    1 root     root            24 Jun 18 05:49 messages.0 -> /mnt/data/log/messages.0
lrwxrwxrwx    1 root     root            24 Jun 18 05:49 messages.1 -> /mnt/data/log/messages.1
lrwxrwxrwx    1 root     root            24 Jun 18 05:49 messages.2 -> /mnt/data/log/messages.2
  1. 以下命令可用于显示单个 消息日志 文件的内容:
cat /var/log/messages
cat /var/log/messages.0
cat /var/log/messages.1
cat /var/log/messages.2
  1. 或显示最近的 60 条日志消息:
tail -n 60 /var/log/messages
  1. 使用您喜欢的 SCP 客户端程序(例如 WinSCP 或 macOS / Linux 终端)连接到 UDM / UDM-Pro。
  2. 使用 macOS / Linux 终端 scp 命令从 /var/log/ 目录下载所有日志文件:
scp root@unifi:/var/log/messages* ./
scp root@192.168.1.1:/var/log/messages* ./

相关文章