企业官网建设流程全解析

• 云原生
• 后端
• 运维

本篇指南讲解如何在 Olares One 上通过Control Hub内置的 Olares CLI 快速进入宿主机终端。它是一套基于浏览器的 Web 终端，默认以root身份运行，无需配置 SSH 客户端、无需记忆 IP 地址，适合执行偶发的、快速的管理命令。读完本文，你将掌握从 Olares 桌面进入宿主机终端的完整流程，理解其运行身份与权限边界，并获得一批可直接复用的olares-cli排查命令。

适用场景与前置条件

Olares One 是运行 Olares OS 的个人云主机，通常无显示器与键盘，日常命令行操作需通过远程方式完成。在 访问 Olares 终端 的说明中，远程接入共有两条路径：Control Hub 终端（Web 界面、直接root访问，适合快速或偶发任务）与SSH（标准远程管理协议，适合高级或自动化操作）。本文聚焦第一条路径。

开始之前，请确认以下两项前提：

• Olares One 已设置完成并处于运行状态；
• 能在浏览器中正常打开 Olares 桌面（Desktop）。

通过 Olares CLI 进入宿主机终端

第 1 步：在浏览器中打开 Olares 桌面

Olares 桌面的访问地址遵循如下格式，其中<username>替换为你的 Olares 用户名：

https://desktop.<username>.olares.com

第 2 步：从 Launchpad 打开 Control Hub

登录桌面后，在启动台（Launchpad）中找到Control Hub并打开。Control Hub 是 Olares 的可视化管理控制台，提供应用工作负载、命名空间、存储、网络、中间件与终端等多个模块入口，其整体功能可参考 使用 Control Hub 管理 Olares。

第 3 步：在 Terminal 区域点击 Olares

在 Control Hub 左侧边栏的Terminal分区下，点击Olares即进入宿主机终端会话。整个过程的零配置特性正体现在此处：无需任何 SSH 客户端，也无需填写主机 IP 或账号密码。

运行身份与安全边界：为何无需 sudo

Control Hub 终端模块提供的是“一键登入 Olares 宿主机（Linux）终端”的能力，等价于以 root 身份通过 SSH 连接系统，但省去了手动输入账号和密码的步骤（参见 Control Hub 终端模块）。

这意味着：

• 终端中默认身份为root，执行命令时不需要为每条命令加sudo前缀；
• 会话直连宿主机底层 Linux 系统，所有操作都会直接影响宿主机环境，例如修改系统级配置、重启服务等，请谨慎执行；
• 该入口适合快速调试与排查，若需要可审计、可脚本化的长期管理通道，建议改用 通过 SSH 访问 Olares One 终端（局域网直连，或通过 LarePass VPN 建立 Tailscale 隧道远程连接）。

在终端中可执行的典型任务

进入终端后，你可以直接在宿主机上进行调试与故障排查、实时查看或回溯系统日志、在操作系统层面修改配置。以下命令来自 Control Hub 终端模块 的官方示例，可直接复制使用：

# 查看 GPU 驱动与服务状态 olares-cli gpu status # 以默认设置收集全部日志 olares-cli logs # 仅收集指定组件的日志（组件名以英文逗号分隔） olares-cli logs --components k3s,redis,minio # 检查 NVIDIA GPU 是否工作正常 nvidia-smi # 检查系统是否识别到 NVIDIA GPU 硬件 lspci | grep -i vga | grep -i nvidia

关于日志收集的更多用法，可进一步阅读 Olares CLI 概览 及其集群管理章节。

理解背后的 olares-cli

Control Hub 终端中直接可用的olares-cli是 Olares 自带的命令行工具。在 Olares OS 宿主机上，它位于/usr/local/bin/olares-cli（参见 安装 olares-cli）。它覆盖三类核心任务：

• 管理集群：在新机器上安装 Olares、跨版本升级、增删节点、彻底卸载；
• 诊断与修复系统：执行安装前检查、收集日志、查询节点状态、排查问题；
• 驱动 AI Agent 操作 Olares：让个人 Agent 通过自然语言代为管理文件、应用与设置。

需要注意的是，olares-cli存在三种运行模式，权限与认证方式各不相同（详见 Olares CLI 概览）：

Control Hub 终端走的是Host 模式：它直接落在宿主机上，以 root 与 kubeconfig 认证，因此无需olares-cli profile login（用户模式登录参见 登录 Olares）。若需要在其他机器上以普通用户身份远程操作 Olares，则需另行安装 npm 版 CLI 并完成登录。

故障排查场景下的同款入口

当 Olares 出现异常（例如 LarePass 中显示 "System error"、桌面可能无法访问）时，这套终端入口也是官方推荐的诊断通道。在 LarePass 中的 "System error" 排查指南 中，若桌面仍可访问，建议依次执行：打开桌面 → 打开 Control Hub → 在左侧 Terminal 分区点击Olares进入终端，然后运行：

# 查看所有命名空间下的 Pod 状态 kubectl get pods -A # 查看异常 Pod 的详细事件（替换为实际名称与命名空间） kubectl describe pod <pod-name> -n <namespace>

这一流程与本文第 3 步的入口完全一致——桌面可访问时，Control Hub 终端是比 SSH 更快的第一诊断入口；仅在桌面不可访问时才降级到 SSH 或本机物理登录。

小结

• Control Hub 内置的 Olares CLI 终端是 Olares One 上“零配置”进入宿主机的方式：浏览器访问桌面 → 打开 Control Hub → Terminal 区域点击Olares；
• 会话默认以root运行，无需sudo，但操作直接影响宿主机环境，需谨慎；
• 推荐用于快速、偶发的调试与日志查看；长期、自动化或需要审计的运维请使用 SSH 通道；
• 入口的更多管理能力可参考 Control Hub 终端模块 与 Olares CLI 概览。

• 云原生
• 后端
• 运维