Olares

简体中文

English

简体中文

English

Appearance

LarePass 显示“系统错误” ​

当 LarePass 移动端的系统部分显示“系统错误”时，参考本指南进行排查。出现此提示可能由多种底层原因导致，先按照以下步骤收集诊断信息，然后将结果提供给 Olares 团队。

INFO

本文以 Olares One 为例。如果你在自己的设备上安装 Olares，排查步骤基本相同，只是访问终端的方式可能存在差异。

系统错误

适用情况 ​

  • LarePass 移动端的系统部分显示“系统错误”。
  • Olares 桌面可能无法访问。

原因 ​

该提示表示 LarePass 未能获取到健康的系统状态。一个或多个系统 Pod 可能处于异常状态，但仅凭这条提示无法确定故障组件或根本原因。

解决方案 ​

按照以下步骤访问 Olares 设备终端，定位未正常运行的 Pod，并只查看定位原因所需的事件信息。

步骤 1：尝试访问 Olares 桌面 ​

如果你仍然可以访问 Olares 桌面，打开控制面板并使用 Olares 内置终端。

  1. 打开浏览器，登录你的 Olares 桌面：

    text
    https://desktop.<username>.olares.cn

  2. 打开控制面板。

  3. 在左侧边栏的终端部分，点击 Olares。 打开终端

如果你可以成功访问终端，跳转至步骤 4。

步骤 2: 尝试 SSH 连接 ​

如果你无法访问 Olares 桌面，可以尝试 SSH 连接。

需处于同一网络

你的电脑和 Olares One 必须连接到同一个本地网络。

  1. 获取 Olares One 的本地 IP 地址。

    a. 打开 LarePass 移动端，进入设置 > 系统，打开 Olares 管理页面。

    b. 点击 Olares One 设备卡片。

    c. 向下滚动至网络部分，记录内网 IP。

  2. 在 Vault 中查看 SSH 密码。

    a. 在 LarePass 移动端点击 Vault。根据提示输入本地密码解锁。

    b. 点击左上角的 Vault 打开侧边导航，然后点击所有 Vault 显示所有已保存条目。

    c. 找到带有 terminal 图标的条目，点击查看密码。

    在 Vault 中查看保存的 SSH 密码

  3. 在你的电脑上打开终端，通过 SSH 连接设备。

    a. 输入以下命令，将 <local_ip_address> 替换为此前获取的内网 IP：

    bash
    ssh olares@<local_ip_address>

    b. 根据提示输入 SSH 密码。

如果连接成功，跳转至步骤 4。

步骤 3: 本地登录设备 ​

如果无法通过 SSH 访问，使用显示器和键盘在本地登录设备。

  1. 将显示器和键盘连接至 Olares One。屏幕上会有一行文字提示登录。

    text
    olares login:

  2. 输入用户名 olares 并按回车键。

  3. 输入步骤 2 中获取的设备登录密码并按回车键。

步骤 4: 检查系统 Pod 状态 ​

  1. 运行以下命令，查看所有命名空间下的 Pod 状态：
    bash
    kubectl get pods -A
  2. 查看 STATUS 和 RESTARTS。重点检查 CrashLoopBackOff、Error、ImagePullBackOff 等错误状态，或长时间处于 Pending 的 Pod。任务 Pod 显示 Completed 本身不代表异常。
  3. 记录显示错误或重启次数持续增加的 Pod 对应的 NAMESPACE 和 NAME。如果没有，直接跳到步骤 6。 定位异常 Pod

步骤 5：查看 Pod 错误信息 ​

分享前检查输出

kubectl describe 的输出可能包含 IP 地址、节点名称、Olares ID、域名和配置值。请勿将完整输出粘贴到公开 Issue 中。

  1. 运行以下命令，并将 <namespace> 和 <pod-name> 替换为上一步记录的值：

    bash
    kubectl describe pod <pod-name> -n <namespace>

    本例中，完整命令如下：

    bash
    kubectl describe pod backup-66f8c76996-d7vnq -n os-framework

  2. 在输出结果中向下滚动到 Events 部分，查看失败相关的错误信息。 Pod 错误详情

步骤 6：记录结果并收集日志 ​

只记录以下必要信息：

  • 异常 Pod 的 NAMESPACE、NAME、STATUS 和 RESTARTS
  • Events 部分中的错误行
  • 报错时间和时区
  • 当前 Olares 版本，以及错误是否出现在更新或重启之后

如果没有 Pod 显示错误，且重启次数没有持续增加，也请记录这一结果。这表示仅凭 Pod 状态无法解释该提示，需要转到其他诊断方向。

如确认是可复现的软件缺陷，可以提交 GitHub Issue。公开内容只包含上述有限信息，并移除 ID、主机名、IP 地址和域名。完整日志压缩包请按照收集诊断信息生成，并仅通过该页面说明的非公开渠道发送。