云原生后端运维【免费下载链接】TerminusOpen-Source Personal Cloud OS for Always-On Agents项目地址https://gitcode.com/gh_mirrors/terminus2/Terminus点击查看免费下载Olares One 可以通过雷电 5Thunderbolt 5 / USB-C接口连接 NVIDIA 外置显卡eGPU为本地 Agent、AI 推理与渲染任务补充 GPU 算力。本文以 Olares OSOlares One 预装系统为操作环境完整讲解 eGPU 的冷启动连接、连接状态核验以及在开机卡住或显卡无法识别时安装 Gen1 PCIe 临时方案的原理与步骤读完即可独立完成 eGPU 的接入、验证、排障与卸载。适用前提与安全须知在开始操作前需要理解 Olares OS 对外置显卡的两个关键约束不支持热插拔。Olares OS 运行期间连接或断开 eGPU 可能导致系统不稳定或驱动异常。连接、断开、重连 eGPU 前必须先完全关闭 Olares One。兼容性因硬件而异。实际能否正常工作取决于 eGPU 设备dock / enclosure、桌面版显卡型号、供电、线材、操作系统与 NVIDIA 驱动等多重因素。Olares 官方在 将 eGPU 连接到 Olares One 中维护了已知硬件组合的兼容状态表可作参考但该表不代表产品推荐也不涵盖所有组合。注意本文针对Olares OSOlares One 的预装 Linux 系统。若你使用的是 Windows 11 双系统请参阅 在 Windows 11 上设置 eGPU。连接 eGPU按以下顺序执行任何变更连接的操作都必须先关机打开SettingsMy hardwareShutdown。使用 LarePass 扫描屏幕上显示的二维码再点击Confirm批准关机。等待 Olares One 完全关机电源指示灯熄灭。准备 eGPU如果设备已经安装 GPU例如自带显卡的雷电外置显卡坞请连接它的电源适配器。如果使用 eGPU dock 或 eGPU enclosure请装入桌面版 NVIDIA 显卡并接好显卡所需的全部供电线供电不足是后续识别不到和运行掉卡的最常见原因。给 eGPU 通电先于连接线材。断开其他高带宽雷电设备如雷电 SSD、雷电扩展坞使用认证的雷电 5 线材优先使用外置显卡设备附带的线材将 eGPU 直接连接到 Olares One 的雷电 5USB-C接口。按下 Olares One 的电源键启动。检查连接状态通过 Dashboard 检查登录 Olares打开Dashboard。选择GPU卡片。检查内置显卡和eGPU是否都已显示。通过终端检查也可以在 Olares 终端中直接查看 NVIDIA 驱动视角下的显卡列表nvidia-smi判断结果Dashboard 和nvidia-smi中都能看到 eGPU连接成功无需安装临时方案可直接开始使用。开机卡住或 Dashboard 与nvidia-smi中都看不到 eGPU先关闭 Olares One断开 eGPU再重新开机。重新连接 eGPU 前先安装下一节的 Gen1 临时方案。Gen1 临时方案原理与适用场景为什么需要 Gen1 临时方案部分雷电外设尤其是某些 dock / enclosure 组合在 NVIDIA 驱动初始化GSP 初始化阶段时雷电隧道Thunderbolt tunnel上的 Gen4 PCIe 链路质量不足以支撑稳定的高速传输导致系统开机卡在 logo或eGPU 无法被驱动枚举。这是 Olares 官方提供的临时解决方案并非 NVIDIA 官方修复其作用对象仅限于通过雷电连接的外置 NVIDIA 显卡不会修改内置显卡。后续 Olares 版本会在系统中内置该方案届时无需手动配置。当前阶段请只安装本页提供的文件不要混用来源不明的脚本。临时方案的运行机制源码视角仓库中随文档一起分发的三个文件构成完整的识别 → 降速 → 重新枚举链路位于 docs/public/downloads/one/egpu/99-egpu-gen1-fix.rulesudev 规则。当系统出现 NVIDIA 显示控制器VGA 类0x030000或 3D 类0x030200的add事件时通过ENV{SYSTEMD_WANTS}egpu-gen1-fix.service异步拉起 systemd 服务。冷启动的 coldplug 与热插拔都会产生add事件因此两种场景均被覆盖而服务脚本内部还会按removableremovable过滤确保只处理雷电外置 GPU、跳过内置显卡。egpu-gen1-fix.serviceoneshot 系统服务Afterbolt.service、Beforenvidia-persistenced.service nvidia-powerd.service在 NVIDIA 持久化守护进程接管前执行降速脚本WantedBymulti-user.target保证开机阶段运行。fix-egpu-link.sh核心脚本。从源码看它的工作分为四步判定目标遍历/sys/bus/pci/devices/*/仅匹配 vendor 为0x10deNVIDIA、PCI class 为显示类0x0300*/0x0302*且removable属性为removable雷电可移除外设的设备天然排除内置显卡。强制 Gen1用setpci以读-改-写方式把桥upstream bridge与 GPU 的 PCIe 能力寄存器CAP_EXP0x30LnkCtl2目标链路速度字段改写为 Gen12.5 GT/s再置位CAP_EXP0x10LnkCtl的 bit5 触发链路重训练Link Retrain。等待并校验重训练后读取current_link_speed确认已降到2.5 GT/s PCIe否则放弃重枚举。重新枚举对目标设备的所有 function 执行 driver unbind、/sys/bus/pci/devices/.../remove再向/sys/bus/pci/rescan写 1 触发重扫使 NVIDIA 驱动在 Gen1 链路上干净地重新初始化显卡。脚本通过/run/egpu-gen1-fix.lock上的flock串行化避免 udev 多次触发与冷启动/热插拔重叠导致的竞争执行日志写入/var/log/egpu-gen1-fix.log。性能影响提示强制 Gen1 会降低系统内存与显存之间的传输带宽因此模型加载、CPU offload、游戏和实时渲染可能变慢但显卡的计算资源本身不会改变。安装步骤在不连接 eGPU的情况下启动 Olares One然后将以下三个文件下载到同一目录fix-egpu-link.shegpu-gen1-fix.service99-egpu-gen1-fix.rules在下载目录中打开终端确认系统可以使用setpci临时方案依赖该工具读写 PCI 配置空间command -v setpci命令应返回/usr/sbin/setpci等路径。如果没有任何输出请停止操作并联系 Olares 技术支持。安装三个文件并启用服务sudo install -m 0755 fix-egpu-link.sh /usr/local/sbin/fix-egpu-link.sh sudo install -m 0644 egpu-gen1-fix.service /etc/systemd/system/egpu-gen1-fix.service sudo install -m 0644 99-egpu-gen1-fix.rules /etc/udev/rules.d/99-egpu-gen1-fix.rules sudo systemctl daemon-reload sudo udevadm control --reload-rules sudo systemctl enable egpu-gen1-fix.service各命令的作用install分别按脚本可执行与配置只读权限落盘daemon-reload让 systemd 识别新服务单元udevadm control --reload-rules让 udev 立即加载新规则systemctl enable使服务在下次启动时自启这也是冷启动路径生效的关键。检查安装结果sudo systemctl is-enabled egpu-gen1-fix.service命令应返回enabled。安装完成后再次按照上文连接 eGPU的步骤操作先关机 → 给 eGPU 通电 → 连接线材 → 开机。检查临时方案是否生效Olares One 启动后先在 Dashboard 或nvidia-smi中确认 eGPU 是否显示再查看临时方案的运行日志sudo tail -n 20 /var/log/egpu-gen1-fix.log在日志中查找类似内容after rescan: 0000:0a:00.0 speed2.5 GT/s PCIe drivernvidia2.5 GT/s PCIe表示外置显卡链路正在以Gen1运行说明降速与重新枚举成功、驱动已接管。不同系统显示的 PCI 地址如0000:0a:00.0可能不同只需关注2.5 GT/s PCIe与drivernvidia部分即可。如果仍然看不到 eGPU或运行不稳定请参考排查 eGPU 问题按章节定位问题。断开 eGPU与连接对称断开也必须全程断电打开SettingsMy hardwareShutdown。在 LarePass 中批准关机并等待 Olares One 完全关闭。关闭 eGPU 电源。从 Olares One 断开雷电线。重新启动 Olares One。卸载临时方案卸载临时方案前先关闭 Olares One 并断开 eGPU。在不连接 eGPU 的情况下启动 Olares One。卸载临时方案与服务安装一一对应的逆操作sudo systemctl disable egpu-gen1-fix.service sudo rm /usr/local/sbin/fix-egpu-link.sh sudo rm /etc/systemd/system/egpu-gen1-fix.service sudo rm /etc/udev/rules.d/99-egpu-gen1-fix.rules sudo systemctl daemon-reload sudo udevadm control --reload-rules重启 Olares One 使改动完全生效sudo reboot硬件兼容参考与排障思路已知硬件组合兼容状态在连接硬件之前建议先对照 将 eGPU 连接到 Olares One 中的兼容表。截至该文档维护时的已知状态外置显卡硬件Olares OSWindows 11AOOSTAR EG02 eGPU dock RTX 4060 Ti设置后可用需安装 Gen1 临时方案设置后可用连接 eGPU 后重装 NVIDIA 驱动Razer Core X V2 eGPU enclosure RTX 4090验证中未装临时方案时开机不稳定仅在多 eGPU 实测配置中验证Razer Core X eGPU enclosure RTX 4060尚未验证仅在多 eGPU 实测配置中验证eGPU dock / enclosure 桌面版 RTX 5090暂不支持NVIDIA 驱动无法初始化暂无方案尚未验证其中可用和已验证表示显卡完成过实际负载测试仅在 Dashboard、设备管理器或nvidia-smi中识别到显卡不视为兼容性验证通过。另外Olares OS 目前每次只支持连接一台eGPU如需多 eGPU建议使用 Windows 11官方已实测一种通过 Razer Thunderbolt 5 Dock 连接三台 eGPU 的配置且该配置中内置 RTX 5090M 功耗约为 95 W 而非 175 W。常见问题快速定位如果 Olares OS 出现以下现象可参照 排查 eGPU 问题 处理开机卡在 logo关机、断开 eGPU 后重启确认sudo systemctl is-enabled egpu-gen1-fix.service返回enabled否则重装临时方案。可以启动但看不到 eGPU按顺序检查供电、线材、直连接口、冷启动顺序然后用lspci -nn | grep -i nvidia和nvidia-smi双命令确认若lspci能看到而nvidia-smi看不到先收集诊断信息再寻求帮助。运行任务时掉卡检查外置设备与显卡的供电功率和供电线断开其他高带宽雷电设备后重试掉卡后立即收集诊断信息。向 Olares 论坛求助时可下载并运行 collect-egpu-info.sh 生成诊断报告该脚本只读取系统状态并在当前目录写入egpu-report-hostname-timestamp.txt不会修改设置、联网或上传数据报告包含External GPU detected摘要、PCIe 链路速度链、雷电拓扑、NVIDIA 驱动信息、当前与上一次启动的内核错误日志等章节能显著加速问题定位。分享前请检查并删除报告中的主机名、内核命令行等个人敏感信息。相关资源将 eGPU 连接到 Olares One排查 eGPU 问题在 Windows 11 上设置 eGPU临时方案配套文件fix-egpu-link.sh、egpu-gen1-fix.service、99-egpu-gen1-fix.rules、collect-egpu-info.sh赞分享云原生后端运维【免费下载链接】TerminusOpen-Source Personal Cloud OS for Always-On Agents项目地址https://gitcode.com/gh_mirrors/terminus2/Terminus点击查看免费下载相关推荐为 Olares One 扩展 GPU 算力eGPU 雷电连接、兼容性与 Gen1 临时方案实战指南为 Olares One 扩展 GPU 算力eGPU 雷电连接、兼容性与 Gen1 临时方案实战指南 本文基于 Olares One 官方文档体系完整讲解如云原生后端运维Rig 官方示例集实战指南从 cargo run 到 Agent 循环、HITL 与 RAG 的全景拆解Rig 官方示例集实战指南从 cargo run 到 Agent 循环、HITL 与 RAG 的全景拆解 Rig 是一个用于在 Rust 中构建模块化、可扩展云原生后端运维Olares One 在 Windows 11 上配置 NVIDIA eGPU首次设置、内置显卡恢复与故障排查实战Olares One 在 Windows 11 上配置 NVIDIA eGPU首次设置、内置显卡恢复与故障排查实战 本指南面向在 Olares One 上运行云原生后端运维上一篇终极性能优化指南Knuff高效处理大量APNS推送请求的10个最佳实践下一篇REFramework游戏修改框架新手入门与常见问题解决指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考