> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cyberun.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# 下载与安装

> 获取适用于你操作系统的独立代理和 Cyberun CLI。

Cyberun 有两个发到你机器上的组件:

* **Cyberun Agent** —— 独立的无界面代理。作为系统服务运行在专用 GPU 主机上(桌面机、工作站或服务器)。
* **Cyberun CLI** —— `cyberun` 命令行工具。在终端里驱动团队的工作流、在 CI 中脚本化运行,或用 `cyberun agent serve` 共享本地 GPU。

运行自有 GPU 服务器的团队在那些服务器上安装代理。常驻终端的开发者安装 CLI。

## Cyberun Agent(无界面代理)

在装有可用 GPU 的 Linux、macOS 或 Windows 主机上安装。代理三个平台都能跑;能运行哪些运行时由各运行时本身决定,而非由代理决定(参见 [Platform → 代理](/zh/platform/agents))。

### Linux 与 macOS 一行命令

```sh theme={null}
curl -sL https://releases.cyberun.cloud/agent/install.sh | bash -s -- \
    --api-key ak-…
```

默认安装是无 root 的 —— 无需 `sudo`,且 comfyui 是默认工具。脚本会下载适用于 `linux-amd64`、`linux-arm64`、`darwin-amd64` 或 `darwin-arm64` 的对应二进制文件,在 `~/.cyberun/agent/<tool>` 下建立运行时,注册一个每用户服务(用户级 systemd,macOS 上为 launchd),然后启动它。

Docker 模式、Nerfstudio,以及完整的参数列表参见[连接代理](/zh/cloud/guides/connect-agent)和 [Platform → 代理](/zh/platform/agents)。

### Windows 一行命令(PowerShell)

```powershell theme={null}
& ([scriptblock]::Create((irm https://releases.cyberun.cloud/agent/install.ps1))) -ApiKey ak-…
```

### 直接下载二进制

推荐路径是安装器。如果你需要原始二进制(离线传输、自定义打包),直接拉取:

| 平台          | 架构            | 二进制                                                                                                |
| ----------- | ------------- | -------------------------------------------------------------------------------------------------- |
| **Linux**   | x86-64        | [`cyberun-agent`](https://releases.cyberun.cloud/agent/linux-amd64/latest/cyberun-agent)           |
| **Linux**   | ARM64         | [`cyberun-agent`](https://releases.cyberun.cloud/agent/linux-arm64/latest/cyberun-agent)           |
| **macOS**   | Apple Silicon | [`cyberun-agent`](https://releases.cyberun.cloud/agent/darwin-arm64/latest/cyberun-agent)          |
| **macOS**   | Intel         | [`cyberun-agent`](https://releases.cyberun.cloud/agent/darwin-amd64/latest/cyberun-agent)          |
| **Windows** | x86-64        | [`cyberun-agent.exe`](https://releases.cyberun.cloud/agent/windows-amd64/latest/cyberun-agent.exe) |
| **Windows** | ARM64         | [`cyberun-agent.exe`](https://releases.cyberun.cloud/agent/windows-arm64/latest/cyberun-agent.exe) |

原始二进制需要一个 `cyberun-agent.yaml` 配置文件(安装器会为你生成)。要自行编写配置,从安装器写出的模板出发 —— 参见 [Platform → 代理](/zh/platform/agents)。

### 代理校验

```sh theme={null}
# Checksums for binaries and install scripts under agent/
curl -sL https://releases.cyberun.cloud/agent/checksums.txt
```

## Cyberun CLI

`cyberun` CLI 走自己独立的发布轨道,与代理分开。可在 Linux、macOS 或 Windows 上安装。

<CodeGroup>
  ```bash Linux / macOS theme={null}
  curl -sL https://releases.cyberun.cloud/cli/install.sh | bash
  ```

  ```powershell Windows theme={null}
  & ([scriptblock]::Create((irm https://releases.cyberun.cloud/cli/install.ps1)))
  ```
</CodeGroup>

先把它指向 Cloud API 一次,然后登录:

```bash theme={null}
export CYBERUN_API_URL=https://core.cyberun.cloud
cyberun auth login
```

想要原始二进制?各平台的构建发布在 `releases.cyberun.cloud/cli/<os>-<arch>/latest/` 下,并有一个共享的 `cli/checksums.txt`,覆盖 Linux、macOS 与 Windows 的 `amd64` 和 `arm64`。把 `latest` 换成版本号即可固定某个构建。

完整命令参考 —— `auth`、`run`、`workflow`、`task` 和 `agent serve` —— 见 [CLI 指南](/zh/cloud/guides/cli)。

## 安装之后

两条路径都把你引向同一处:

<CardGroup cols={2}>
  <Card title="Cloud → 运行你的第一个任务" icon="play" href="/zh/cloud/getting-started/first-task">
    分步操作:创建团队、连接代理、提交任务。
  </Card>

  <Card title="连接 AI 客户端" icon="plug" href="/zh/cloud/guides/connect-mcp">
    从 Claude Code、Cursor 或任意 MCP 客户端驱动 Cyberun。
  </Card>
</CardGroup>

## 更新通道

稳定版发布在 `/latest/` 下。历史版本永久保留在其版本号下,因此旧的安装链接始终可用 —— 没有发布裁剪。预发行流(beta / RC)不通过 `/latest/` 暴露;如需提前访问,请在团队支持渠道咨询。

## 报告问题

* **代理安装脚本失败** —— [连接代理 → 故障排查](/zh/cloud/guides/connect-agent#故障排查)。
* **其他问题** —— `sales@cyberun.cloud`。