orch
中文
GitHub 安装

下载

下载 orch

团队一台服务器，然后每位成员的机器上一个代理。

  1. 获取服务器文件

    请先将 DNS 记录指向主机：Caddy 会在首次启动时申请证书。

    $ git clone https://github.com/selfhostr/orch.git
$ cd orch/deploy/server
$ cp .env.example .env  # fill it in

  2. 创建 GitHub App

    将其标识填入 .env，私钥放到 secrets/github-app.pem。步骤见文档。

  3. 启动服务器

    这会拉取镜像并执行数据库迁移。

    $ docker compose up -d
$ curl -fsS https://<domain>/healthz

  4. 添加每位成员

    My Server 页面会给每位成员这条带一次性令牌的命令，有效期 15 分钟。

    $ curl -fsSL https://<domain>/install.sh | ORCH_TOKEN=<one-time-token> sh
$ orch login

  5. 如需要，连接 Claude Code

    然后运行 /mcp，选择 orch，再选择 Authenticate。

    $ claude mcp add --transport http --scope user orch https://<domain>/mcp

要求

  • 服务器：装有 Docker Engine 26+ 和 Compose 的 Linux 主机，可访问的 80 和 443 端口，以及一个 DNS 名称
  • 每位成员：Docker Engine 26+、curl、sh 和自己的 Claude 订阅
  • 一个用于登录、Webhook 和拉取请求的 GitHub App

版本和镜像

  • 最新版本v0.9.1
  • 镜像ghcr.io/selfhostr/orch-server, ghcr.io/selfhostr/orch-web, ghcr.io/selfhostr/orch-agent
  • 平台linux/amd64, linux/arm64
  • 固定版本ORCH_VERSION
  • 更新git pull && docker compose pull && docker compose up -d

支持本项目

每个 selfhostr 项目都是免费的，背后没有公司。如果它为你节省了时间，捐助可以支付测试硬件和投入的时间。

在 GitHub 上赞助我们