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

> 如何安装运行 Orbi?

# Installation

# 运行 Orbi 的方式

自托管 runner 是开源核心，运行在你自己的机器上、面向你自己的 GitHub 仓库。Orbi Managed Cloud 是运行在同一 GitHub 账本上的商业托管控制平面。

| 方式               | 适用场景                                           | 操作                                                                                     | 详情                          |
| ---------------- | ---------------------------------------------- | -------------------------------------------------------------------------------------- | --------------------------- |
| Managed Cloud    | 不想自己维护一台 runner 机器                             | 在 [orbi.build/cloud](https://orbi.build/cloud/?ref=docs-installation) 登录使用             | 与同一 GitHub 账本连接的托管控制平面；无需安装 |
| 安装脚本（推荐的自托管路径）   | Linux 使用 systemd user session，macOS 使用 launchd | `curl -LsSf https://raw.githubusercontent.com/orbi-build/orbi/main/install.sh \| bash` | [上手指南](/zh/getting-started) |
| PyPI（`orbi-cli`） | 只想要 `orbi` 命令，Python ≥ 3.14                    | `uv tool install orbi-cli`                                                             | [上手指南](/zh/getting-started) |
| Docker（社区维护）     | 宿主机没有 systemd user session                     | `docker pull ghcr.io/orbi-build/orbi:latest`                                           | [Docker](/zh/docker)        |

三条注意事项让这个选择保持诚实：

* Managed Cloud 与自托管 runner 不得服务同一个任务池——二选一，绝不两者都用。
* PyPI 只提供 `orbi` 命令本身；运行 Orbi 要用安装脚本或 editable checkout 安装。
* Docker 是社区维护、非官方支持的封装；宿主机有 systemd user session 时优先走官方安装脚本——两条路径二选一，同一个任务池绝不两者都用。