跳转到内容
Rayrun
登录注册

安装与配置

安装

Section titled “安装”

下载页有四个平台的发布包（Linux / macOS / Windows，含 sha256 校验文件）。 Linux x86_64：

终端窗口
curl -O https://rayrunos.com/dl/rayrun-linux-amd64.tar.gz
sudo tar -xzf rayrun-linux-amd64.tar.gz -C /usr/local/bin rayrun

macOS 的包未签名、未公证，首次运行会被 Gatekeeper 拦下；Windows 包未实测 —— 下载页上有同样的标注。

登录

Section titled “登录”

推荐用账号密码登录。CLI 会自动创建一枚命令行专用 Token 并保存到系统用户配置目录 （Linux 即 ~/.config/rayrun/config.json，权限 0600），之后所有命令直接可用：

终端窗口
rayrun login you@example.com
# 密码在终端提示输入（不回显）
rayrun sandbox list
  • 从下载页拿到的 CLI 默认连接托管环境 https://api.rayrunos.com/v1； 自托管用 --api-url 或 RAYRUN_API_URL 指向自己的实例。
  • 如果提示连不上 127.0.0.1:8080，说明这是旧版 CLI：重新下载本页安装包， 或临时在 login 前加 --api-url https://api.rayrunos.com/v1。
  • 密码登录只允许 https（本机 loopback 例外）；密码不会保存在本地。
  • Token 备注为 rayrun-cli@<主机名>，在控制台「设置 → 我的 API Token」里 可见但只读 —— 要删除请在对应机器执行 rayrun logout。
  • 再次 login 会先吊销本机旧 Token 再创建新的，不会留下两个有效凭据。

退出登录（吊销 Token + 清除本地凭据）：

终端窗口
rayrun logout

环境变量（CI / 脚本）

Section titled “环境变量（CI / 脚本）”

也可以不走登录，显式提供地址与 Token：

终端窗口
export RAYRUN_API_URL=https://api.rayrunos.com/v1
export RAYRUN_TOKEN=rayrun_<token_id>_<secret>        # 控制台「设置 → 我的 API Token」
全局 作用
RAYRUN_API_URL / --api-url 服务地址（发布包已默认托管地址；自托管用环境变量或每次显式传）
RAYRUN_TOKEN / --token API Token；设置后优先于 rayrun login 保存的凭据
--json 任何命令加它就输出原始 JSON（脚本里用）

使用 rayrun login 保存的凭据时，服务地址取登录时保存的地址；显式/环境的 RAYRUN_API_URL 与它不一致会直接报错（避免把 Token 发到另一台主机）。

自检：rayrun version

Section titled “自检：rayrun version”
终端窗口
rayrun version          # 如 rayrun cli-v0.1.0 (build 137, go1.27.0 linux/amd64)
rayrun version --json   # {version, build, commit, go, os, arch, api_url}

打印的是 CLI 自身的版本与构建目标，不是服务端版本。build 是提交计数，升级时用于比较新旧；api_url 是这份构建默认连接的 API 地址（发布包为托管地址，源码/宿主构建为本机）。装完先跑一遍确认。

升级

Section titled “升级”

检查更新与安装升级都是显式命令，不会在后台自动联网：

终端窗口
rayrun upgrade --check    # 是否有新版本
rayrun upgrade            # 下载、验签、试运行、原子替换（交互确认）
  • 清单和归档使用 Ed25519 签名，公钥编译进 CLI；更新请求不携带 Token / Cookie。
  • 失败时当前文件不变；成功后保留一份 rayrun.bak。
  • CI / 脚本安装时加 --yes；非交互环境不加会拒绝执行。
  • Windows 与 linux/arm64 不支持在线替换：upgrade --check 可用，安装请回到下载页手动下载。
  • 首次安装不被升级签名保护：2026-10-29 之前安装的旧 CLI 没有内置公钥，必须手动安装一次带 upgrade 的版本，之后才能在线升级。现在首次下载走 HTTPS，但 HTTPS 只保护传输，不等于签名。

升级后正在运行的进程仍使用旧版；重新启动后生效。无写权限时不会自动提权，请用 sudo rayrun upgrade 或手动下载。