Olares 安装、激活与登录常见问题

本文汇总了关于在硬件上安装、配置、激活、登录 Olares 的常见问题。

安装

Olares 支持哪些平台？

建议在 Linux (Ubuntu 或 Debian) 上安装 Olares，以获得最佳性能。

你也可以在以下平台安装 Olares，但仅建议用于测试，因为这些平台不支持全部功能：

• Proxmox VE
• Raspberry Pi
• macOS
• Windows

安装 Olares 的最低硬件要求是什么？

具体要求因平台而异。通常建议配置如下：

• CPU：至少 4 核，x86-64 架构 (Intel 或 AMD)。
• 内存：至少 8 GB 可用内存。
• 存储：至少 150 GB SSD。

详细要求参见安装文档。

可以使用机械硬盘安装 Olares 吗？

不可以。必须使用 SSD。由于机械硬盘读写速度较慢，极易导致系统初始化超时，从而造成安装失败。

系统支持 NVIDIA 显卡吗？

支持，但仅限 NVIDIA Turing 架构及更新版本，例如 GTX 16xx、RTX 20xx、30xx、40xx、50xx 系列及更高版本。架构更旧的显卡在 Olares 中不会被识别，依赖 GPU 的 AI 应用也无法运行。该限制源于两方面：NVIDIA 开源驱动需要 Turing 及更新架构的 GSP 模块，且 CUDA 13.x 不再支持旧架构显卡。

对于受支持的显卡，Olares 会自动完成驱动安装。Olares 也支持在单块主板上安装多块 GPU，让你能够充分利用所有显卡的算力来处理 AI 任务。

如果自动安装失败，如何手动安装 NVIDIA 驱动？

Olares 安装程序会自动检测并安装驱动。但如果系统此前已安装过 NVIDIA 驱动，可能会因冲突导致安装过程跳过或失败。

解决方法：

1. 完成 Olares 安装后重启机器，清除旧驱动残留。
2. 使用命令 olares-cli gpu install 手动触发驱动安装。
3. 安装完成后，运行 nvidia-smi 确认系统识别到了 GPU。

为什么安装失败并提示 failed to build Kubernetes objects 或 Ensure CRDs are installed first？

虽然这些错误信息指向自定义资源定义（CRD）的问题，但通常真正的原因是磁盘性能不足。

Olares 依赖 etcd 作为 Kubernetes 的后端数据库，而 etcd 对存储速度非常敏感。如果在速度较慢的磁盘（如传统机械硬盘）上安装，etcd 无法及时响应，就会导致 API 服务器在应用 CRD 时超时。

使用 SSD 安装 Olares 通常可以解决此问题。

如果 Olares 安装超时且未显示密码，如何找到密码？

这种情况通常发生在虚拟机（VM）中，由于系统资源不足导致安装超时。可以从安装日志文件中通过以下命令获取密码：

# 将 v1.12.2 替换为你的具体 Olares 版本号
grep password $HOME/.olares/versions/v1.12.2/logs/install.log

安装超时通常意味着某些服务未能正确启动。找到密码后，运行 kubectl get pod -A 检查所有服务的状态。

激活

能否在非本地网络下激活 Olares？

标准激活要求 Olares 设备与客户端设备（如手机）连接到同一个本地网络。无论你是通过浏览器访问本地 IP 地址来进入激活向导，还是在 ISO 安装后使用 LarePass 应用中的“发现附近的 Olares”功能，都适用这个要求。

但如果 Olares 使用的是公网 IP 地址（例如在公有云上），则不再受这个本地网络限制。

激活之后，无论初始设置方式如何，都可以通过域名在内网和外网访问设备。

Olares 已开机并连接到局域网，但在 LarePass 中找不到设备。怎么办？

确保手机和 Olares 设备处于同一网络。如果不在同一网络，LarePass 无法自动发现 Olares。

如果无法通过 Wi-Fi 连接，可使用 LarePass 应用中的蓝牙配网功能，将 Olares 连接到与手机相同的网络中。

详细步骤参见通过蓝牙激活 Olares。

创建账户时，收到错误提示 MFA 绑定失败，怎么解决？

这表示，因网络超时，绑定多因素认证 (MFA) 的请求失败（MFA binding error）。检查网络连接并重试设置流程。

激活账户时，收到错误提示 DID 绑定失败，怎么解决？

账户激活期间，遇到请求 binding-zone 接口失败（DID binding error），通常是由于网络超时。请确保网络稳定，点击重试。

认证令牌无效，时间戳超出范围，怎么办？

当运行 LarePass 的设备与 Olares 服务器之间存在较大时间差（超过 20 分钟）时会出现此报错（Invalid jws, timestamp is out of range）。检查电脑或手机的系统时间，确保其已正确同步网络时间。

设置过程中出现域名解析错误，怎么处理？

该报错（Resolve name error）表明 Olares 设备无法连接到 Olares 身份服务，通常由网络问题引起。请检查网络连接，并确保 Olares 设备具备正常的网络访问权限。

登录与认证

提示“登录失败，密码错误”怎么办？

这表示输入的密码不正确。请仔细检查密码，如拼写错误或大小写问题，然后重试。

“登录失败，用户未找到”是什么原因？

这表示系统未找到与用户名关联的账户。请核实该用户名是否正确，并确认该用户名已在 Olares 上注册。

收到“登录失败，lldap未查询到该用户”的报错，该怎么处理？

这表示系统无法从内部目录检索用户详情。原因可能是用户数据损坏或服务暂时繁忙。请重试或联系管理员。

提示“登录尝试次数过多，请5分钟后重试”，无法登录怎么办？

出于安全考虑，多次尝试登录失败后，系统会暂时锁定。请等待五分钟后再次尝试登录。

提示“登录失败，磁盘空间已满”，怎么解决？

这表示你的 Olares 设备存储已满，导致认证服务无法正常运行。请清理设备磁盘空间以解决这个问题。

“登录失败，lldap服务异常”，如何解决？

这表示 Olares 设备上的内部身份服务 (LLDAP) 未运行或出现异常。重启 Olares 设备并重试，或联系管理员。

“登录失败，citus服务异常”，什么意思？

这表示内部数据库服务 (Citus) 当前不可用。这通常是临时性的系统问题。请重启 Olares 设备。