【功能说明】玲珑容器已支持 NVIDIA 显卡（N 卡）透传（非官方改动）

本帖仅说明 玲珑容器（Linglong / Linyaps）中已实现的 NVIDIA 显卡透传相关功能。
该功能为非官方实现，不代表 deepin / 玲珑项目官方支持或承诺。

项目源码地址：
https://github.com/guanzi008/linyaps/tree/rework/mainline

一、已支持的 NVIDIA 显卡能力

当前在 玲珑容器运行环境中，已实现对 宿主机 NVIDIA 显卡的用户态驱动透传支持，主要包括：

1. 宿主机 NVIDIA 闭源驱动直通
玲珑容器运行时会自动从宿主机系统中收集 NVIDIA 相关用户态驱动库，并以只读方式挂载到容器中，使容器内应用可以直接使用宿主机已安装的 NVIDIA 闭源驱动。

2. 正确的 OpenGL / GLX Vendor 选择
同步注入 NVIDIA 的 GLVND vendor 组件，避免容器环境下 OpenGL / GLX 走 Mesa 或其它错误实现，保证显卡能够正常工作。

3. 同时支持 64 位与 32 位 NVIDIA 库
自动处理 32 位 NVIDIA OpenGL / GLX 相关库路径，保障部分 32 位应用或兼容运行环境在容器内也可以正常使用显卡。

4. NVIDIA 相关环境变量自动处理
运行时会合并宿主机 NVIDIA 所需的环境变量，减少手动配置依赖，提高启动成功率。

5. 启动与挂载稳定性优化
对运行时挂载及 socket 初始化流程进行了优化，减少无关告警输出，提升整体稳定性。

---

二、宿主机驱动要求（重要）

该功能 依赖宿主机已正确安装 NVIDIA 闭源驱动。

宿主机驱动安装方法可参考 deepin 论坛帖子：
https://bbs.deepin.org/post/294981

请确认：

• 宿主机 NVIDIA 驱动可正常使用
• nvidia-smi 在宿主机可正常运行
• OpenGL / GLX 已由 NVIDIA 驱动接管

---

三、重要提示（非官方支持）

⚠️ 该 NVIDIA 显卡透传功能为非官方改动：

• 不属于 deepin 或玲珑项目官方发布或支持的功能
• 不保证在所有系统版本、驱动版本下稳定可用
• 后续系统或驱动升级可能导致功能失效
• 官方问题反馈渠道可能不会受理相关问题

请在测试环境或自行可控的使用场景中使用。

---

四、注意事项与风险提示

• 玲珑容器内使用的是宿主机 NVIDIA 用户态驱动，宿主机驱动变动会直接影响容器内应用。
• 属于运行时级别的驱动透传与库注入实现，并非 NVIDIA 官方容器方案。
• 通过只读方式挂载宿主机驱动库，请勿随意修改运行时配置或挂载规则。
• 遇到问题需同时排查宿主机驱动状态与玲珑容器运行环境。

---

五、其它说明

本文仅介绍玲珑容器中的 NVIDIA 显卡透传功能，其它运行时、构建及配置相关改动不在本帖讨论范围内。

---

欢迎有条件的用户测试验证，如反馈问题请附带 显卡型号、NVIDIA 驱动版本、系统版本及应用日志，以便定位问题。

📥 下载地址

下面是针对不同 Deepin 系统版本的 ​玲珑容器 NVIDIA 透传增强包​：

🔹 Deepin 23 (amd64)

👉 https://obsci.odata.cc/home:/Admin:/linglong-host-nvidia-fallback/Deepin_23/amd64/linglong-bin_1.11.0-1_amd64.deb

---

🔹 Deepin 25 (amd64)

👉 https://obsci.odata.cc/home:/Admin:/linglong-host-nvidia-fallback/Deepin_25/amd64/linglong-bin_1.11.0-1_amd64.deb

---

📌 提示

✅ 两个 .deb 包都包含 ​基于非官方分支的玲珑增强组件​，用于支持 NVIDIA 显卡用户态驱动在容器内的透传功能。
✅ 请根据你当前使用的 Deepin 发行版版本 选择对应的包。

---

⚠️ 风险与注意事项（必须提示）

⚠️ ​该增强包属于非官方实现​：

• 不代表 deepin 官方发布或支持
• 更新可能不保证兼容未来 deepin / 驱动版本
• 安装前请做好系统备份