Olares/docs/zh/developer/install/cli/gpu.md

54 lines
2.6 KiB
Markdown
Raw Normal View History

2025-07-17 03:58:59 +00:00
# `gpu`
## 命令说明
`gpu` 命令用于管理 GPU 功能,包括安装、启用、禁用和卸载 GPU 驱动及相关组件,以及查看 GPU 安装状态。
```bash
olares-cli gpu <子命令> [选项]
```
:::info
- 通常情况下Olares 安装脚本会自动检测显卡硬件和 CUDA 驱动,并根据检测结果自动安装、启用显卡相关组件和服务。
- 当前仅支持 NVIDIA 显卡。
:::
## 子命令
| 子命令 | 描述 |
|-------------|------------------------------------------------------------------|
| `install` | 安装 GPU 驱动和相关依赖。|
| `enable` | 启用 GPU 功能,支持 GPU 应用运行。 |
| `disable` | 禁用 GPU 功能,停止支持 GPU 应用运行。 |
| `uninstall` | 卸载 GPU 驱动和相关程序。 |
| `status` | 查看 GPU 驱动和 CUDA 版本信息,以及 GPU 相关服务的运行状态。 |
## 选项
| 选项 | 简写 | 用途 | 是否必需 | 默认值 |
|--------------|------|--------------------------------------------------------------------------------------------------------------------------------------------------------------|----------|----------------|
| `--base-dir` | `-b` | 指定安装的基础目录。 | 否 | `$HOME/.olares` |
| `--version` | `-v` | 安装指定 Olares 版本的 GPU 驱动及组件。版本号格式为 `x.y.z`(如 `1.10.0`)或包含构建日期(如 `1.10.0-20241109`)。<br>可用版本请参考 [GitHub Releases](https://github.com/beclab/Olares/releases)。 | 否 | 当前已安装版本 |
| `--help` | `-h` | 显示命令帮助信息。 | 否 | 无 |
## 使用示例
```bash
# 安装指定 Olares 版本的 GPU 驱动及依赖至指定目录
olares-cli gpu install --base-dir /home/olares/.olares --version 1.11.1-rc.4
# 启用 GPU 功能
olares-cli gpu enable
# 查看 GPU 驱动和服务状态
olares-cli gpu status
# 禁用 GPU 功能
olares-cli gpu disable
# 卸载 GPU 驱动及组件
olares-cli gpu uninstall
```