Files
Olares/docs/zh/developer/install/cli/download.md
2025-07-17 11:58:59 +08:00

46 lines
2.8 KiB
Markdown

# `download`
## 命令说明
`download` 命令用于下载在本地机器上安装 Olares 所需的软件包和组件。它支持下载组件、检查安装包状态以及获取配置清单文件。
```bash
olares-cli download <子命令> [选项]
```
## 子命令
| 名称 | 简写 | 用途 | 示例 |
|-------------|-----|------------------|----------------------------------------|
| `check` | | 检查 Olares 安装包的状态 | `olares-cli download check` |
| `component` | `c` | 下载 Olares 组件 | `olares-cli download component` |
| `wizard` | `w` | 下载配置清单文件 | `olares-cli download wizard` |
## 选项
| 选项 | 简写 | 用途 | 是否必需 | 默认值 |
|----------------------|------|------------------------------------------------------------------------------------------------------------------------------------------------------|----------|--------------|
| `--base-dir` | `-b` | 设置 Olares 的基础目录。 | 否 | `$HOME/.olares`|
| `--download-cdn-url` | | 设置 CDN 加速下载地址,格式为 `https://example.cdn.com`。 | 否 | 默认地址 |
| `--help` | `-h` | 显示帮助信息。 | 否 | 无 |
| `--kube` | | 指定 Kubernetes 类型。<br>支持 `k3s``k8s`。 | 否 | `k3s` |
| `--version` | `-v` | 指定 Olares 版本。<br>版本号格式为 `x.y.z`(如 `1.10.0`)或包含构建日期(如 `1.10.0-20241109`)。<br> 可用版本请参考 [GitHub Releases](https://github.com/beclab/Olares/releases)。 | 否 | 当前安装版本 |
## 使用示例
```bash
# 指定存储所有下载组件的基础目录
olares-cli download component -b /custom/path
# 指定用于下载 Olares 组件的 CDN 加速地址
olares-cli download component --download-cdn-url https://my.cdn.com
# 指定安装的 Kubernetes 类型
olares-cli download component --kube k8s
# 设置配置清单文件的路径
olares-cli download component --manifest /custom/path/manifest.json
# 指定要下载的 Olares 软件包和组件版本
olares-cli download component -v 1.11.0
```