概述

本文将介绍如何从 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://unifi 或 https://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* ./

相关文章