云原生后端运维【免费下载链接】TerminusOpen-Source Personal Cloud OS for Always-On Agents项目地址https://gitcode.com/gh_mirrors/terminus2/Terminus点击查看免费下载Olares One 在初始设置与双启动场景中可能遇到两个典型问题初始激活卡在约 9% 并提示卸载重装以及 Windows 11 设备管理器中 Thunderbolt 5 端口显示为 USB4。本文依据 docs/zh/one/known-issues.md英文原文见 docs/one/known-issues.md结合 Terminus 仓库中 NTP 时间同步、证书签发与卸载流水线的源码实现完整说明问题成因、逐步恢复流程与验证方法。问题一Olares One 初始设置在 9% 处失败故障现象Olares One 在首次初始设置激活过程中失败安装进度停在约 9%界面会提示用户卸载或重新安装。该问题并非硬件故障而是由启动时序与证书签发之间的时间偏差引起属于可自行恢复的软件级问题。根因分析异步 NTP 同步与证书未来时间戳根据官方文档的描述根因链条如下设备启动时系统在签发安全证书之前会执行一次异步 NTP 时间同步NTP 同步通常瞬间完成但在网络抖动或时间源响应较慢时可能发生延迟若 NTP 校准尚未完成证书签发流程就会基于尚未校准的系统时间生成证书导致证书被盖上未来时间戳future timestamp该现象在设备仍使用出厂默认时区UTC8时尤其常见未来时间戳的证书无法通过校验最终导致激活activation失败。仓库源码印证了这一时间敏感链路。在 cli/pkg/bootstrap/os/tasks.go 中UpdateNtpDateTask会优先调用ntpdate -b -u pool.ntp.org强制校时找不到ntpdate时退化为timedatectl set-ntp 1同一文件中的TimeSyncTask还会将校时命令写入cron.ntpdatecli/pkg/bootstrap/os/tasks.go并调用hwclock -w将系统时间写回硬件时钟RTC保证重启后时间依然准确。证书签发侧则位于 cli/pkg/utils/certs/certs.goNewSignedCert直接使用time.Now().Add(CertificateValidity)计算证书的NotAfter并以 CA 证书的NotBefore作为新证书的生效起点。一旦系统时钟被错误地拨到未来例如 NTP 延迟期间时钟仍停留在未来生成的证书时间戳就会超出合理区间进而触发校验失败中断激活流程。变通方法卸载未完成安装并重新激活官方给出的变通方案是卸载未完成的安装然后重新激活设备完整流程包含四个步骤。步骤 1尝试 SSH 连接无显示器/键盘时优先如果你尚未给 Olares 设备连接显示器和键盘优先通过 SSH 远程登录打开 LarePass 应用中的Activate Olares页面获取 Olares One 的本地IP地址在你的电脑上打开终端输入以下命令将local_ip_address替换为上述本地 IP 地址并回车ssh olareslocal_ip_address按提示输入默认 SSH 密码olares并回车如果连接成功直接跳转到步骤 3。步骤 2本地登录SSH 不可用时当 SSH 访问不可用时使用显示器与键盘本地登录将显示器和键盘连接到 Olares One屏幕会自动显示基于文本的登录提示olares login:输入用户名olares按Enter按提示输入默认 SSH 密码olares按Enter。说明默认登录凭据用户olares/ 密码olares是出厂初态凭据仅在设备尚未配置自定义密码时有效若你已修改过密码请使用修改后的凭据。步骤 3运行卸载命令登录成功后执行卸载将设备恢复为未激活状态sudo olares-cli uninstall等待卸载完成即可。从源码看该命令的入口位于 cli/cmd/ctl/os/uninstall.goNewCmdUninstallOs定义了olares-cli uninstall其实际执行体为pipelines.UninstallTerminusPipelinecli/pkg/pipelines/uninstall_terminus.go该流水线会清理已安装组件与数据并在卸载日志uninstall.log中记录全过程。该命令还支持两个可选参数--all彻底卸载包括已准备的依赖prepared dependencies--phase install|prepare|download从指定阶段开始回退卸载例如--phase install会移除 install 阶段执行的任务将系统恢复到 prepare 状态。一般情况下故障恢复直接执行sudo olares-cli uninstall即可。步骤 4使用 LarePass 重新安装并激活:::tip 重新安装前 为确保时间同步准确重新安装前让设备保持通电几分钟使其自动校准内部时间含 RTC 硬件时钟。 :::根据你的网络设置发现并关联 Olares One通过有线 LAN 设置确保 Olares One 通过网线连接到路由器在 LarePass 应用中点击Discover nearby Olares。通过 Wi-Fi蓝牙设置如果没有有线连接可以使用蓝牙配置 Wi-Fi 凭据在 LarePass 应用中点击Discover nearby Olares点击底部的Bluetooth network setup从蓝牙列表中选择你的设备点击Network setup按照提示将 Olares One 连接到手机当前使用的 Wi-Fi 网络连接完成后返回主屏幕再次点击Discover nearby Olares。从可用设备列表中找到你的 Olares One点击Install now。此时设备内部时间已经校准安装应能顺利推进并成功完成。预防要点等待时间校准再重装重启/重装前保持设备通电数分钟让ntpdate -b -u pool.ntp.org或timedatectl set-ntp 1cli/pkg/bootstrap/os/tasks.go完成校时并通过hwclock -w写入 RTC确认时区已从出厂默认 UTC8 更新文档明确指出出厂默认时区为 UTC8未更新的设备更容易命中证书时间戳问题保持网络可达NTP 同步依赖公共时间源pool.ntp.org若网络受限时间偏差会持续存在。问题二Thunderbolt 5 端口在 Windows 设备管理器中显示为 USB4现象描述在双启动方案中安装 Windows 11 后Olares One 的 Thunderbolt 5 端口在设备管理器中显示为USB4(TM) Host Router或USB4 Root Router。这是正常行为不影响功能。原因Windows 11 的内置统一驱动架构该显示行为是 Intel 与 Microsoft 的设计使然从 Windows 11 开始Thunderbolt 驱动已内置到操作系统中不再需要单独安装厂商驱动设备通过Usb4HostRouter.sys驱动统一管理该驱动统一处理 Thunderbolt 3、4 和 5 设备设备管理器中的 USB4 标签反映的是这种统一架构并不表示端口以降速运行。换句话说看到 USB4 只是 Windows 对 Thunderbolt 3/4/5 统一管理后的显示名称Thunderbolt 5 的硬件能力并未被降级。功能验证带宽与扩展坞仍正常连接 Thunderbolt 5 设备时系统仍会协商完整的 80 Gbps 带宽Thunderbolt 5 扩展坞可以正常工作你可以在 USB4 设备属性页面的Current bandwidth (down/up)字段中验证实际协商的连接速度。如果该字段显示接近 80 Gbps双向均协商完整带宽即说明 Thunderbolt 5 链路以全速工作设备管理器中的 USB4 标签只是命名差异。更多官方参考资料文档还给出了两项权威参考可在 Olares One 双启动 Windows 时进一步阅读Intel 关于 Windows 11 下 Intel NUC 产品为何没有 Thunderbolt 驱动 的说明Microsoft 关于 Windows 中 USB4 连接管理器connection manager介绍 的文档。小结初始设置卡在 9%根因是证书签发前异步 NTP 同步偶发延迟导致证书带未来时间戳、激活失败。恢复流程为ssh olaresip或本地登录→sudo olares-cli uninstall→ 等待设备通电校准时间 → 通过 LarePass 重新安装激活Windows 下端口显示为 USB4属正常设计Windows 11 通过Usb4HostRouter.sys统一管理 Thunderbolt 3/4/5不影响 80 Gbps 带宽协商与扩展坞功能。仓库中与之相关的实现参考NTP 校时与 RTC 回写见 cli/pkg/bootstrap/os/tasks.go证书时间戳生成见 cli/pkg/utils/certs/certs.go卸载命令与流水线见 cli/cmd/ctl/os/uninstall.go 与 cli/pkg/pipelines/uninstall_terminus.goolares-cli的完整系统命令组见 cli/cmd/ctl/os/root.go。赞分享云原生后端运维【免费下载链接】TerminusOpen-Source Personal Cloud OS for Always-On Agents项目地址https://gitcode.com/gh_mirrors/terminus2/Terminus点击查看免费下载相关推荐Olares One 已知问题排查指南初始设置 9% 失败与 Thunderbolt 5 端口显示异常Olares One 已知问题排查指南初始设置 9% 失败与 Thunderbolt 5 端口显示异常 本文基于 Olares One 官方已知问题清单 d云原生后端运维Olares One 在 Windows 11 上配置 NVIDIA eGPU首次设置、内置显卡恢复与故障排查实战Olares One 在 Windows 11 上配置 NVIDIA eGPU首次设置、内置显卡恢复与故障排查实战 本指南面向在 Olares One 上运行云原生后端运维Olares One 在 Windows 11 上设置 NVIDIA eGPU 完整指南首次安装、驱动清理与内置显卡恢复Olares One 在 Windows 11 上设置 NVIDIA eGPU 完整指南首次安装、驱动清理与内置显卡恢复 导读 本文讲解如何在运行 Windo云原生后端运维上一篇实战指南如何用CaddyManager构建企业级Caddy服务器集中管理平台下一篇ERPNext开源ERP4条命令一条单子走通创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考