# 快速开始

> 在 Skipbox 上运行你的第一个 GitHub Actions 作业：登录、安装应用、改一行 runs-on，然后推送。

你需要一个在 GitHub 组织或个人账号上的仓库，公开或私有都可以，并且 `.github/workflows` 中至少有一个工作流。这些步骤只需几分钟，免费试用无需绑卡。

## 1. 使用 GitHub 登录

打开 [skipbox.dev](https://skipbox.dev/?lang=zh-Hans)，使用 GitHub 登录。登录不收取任何费用。

## 2. 安装 Skipbox 应用

Skipbox 会显示两个安装按钮。选择你要运行其作业的那个账号对应的按钮：

- **组织**：安装 **Skipbox CI** 应用。由组织的所有者安装。如果你不是所有者，GitHub 会把你的请求发给他们，安装应用的所有者需要登录 Skipbox 一次。
- **你的个人账号**：安装 **Skipbox (personal)** 应用。

然后 GitHub 会询问应用可以使用所有仓库，还是只用其中一部分。Skipbox 运行公开仓库和私有仓库的作业；在有公开仓库的组织上，要允许 Skipbox 用于公开仓库一次（在你的仓库页面上的按钮），因为在所有者这样做之前，GitHub 不让自托管运行器用于公开仓库。见[组织和个人账号](https://docs.skipbox.dev/zh-hans/accounts)以及 [GitHub 应用权限](https://docs.skipbox.dev/zh-hans/permissions)。

## 3. 修改一个作业的 runs-on

打开一个工作流文件，把一个作业的 `runs-on` 设为 `skipbox`：

```yaml
jobs:
  test:
    runs-on: skipbox
    steps:
      - uses: actions/checkout@v4
      - run: make test
```

你的控制台会列出你的仓库，每个工作流旁边都有一个 **“在 GitHub 上编辑”** 链接，你可以在 GitHub 的编辑器中完成修改。或者按下仓库旁边的 **“创建拉取请求”**：在 GitHub 请你在那个仓库上安装 Skipbox Migrate 应用之后（[GitHub 应用权限](https://docs.skipbox.dev/zh-hans/permissions)），Skipbox 会创建一个拉取请求，替你修改 `runs-on` 行。合并它，然后跳过第 4 步。

## 4. 提交并推送

提交修改。那个作业的下一次运行就在 Skipbox 上运行，并显示在你的控制台上。你的免费试用从这第一个作业开始：7 天 或 3,000 作业分钟，以先到者为准。见[免费试用](https://docs.skipbox.dev/zh-hans/trial)。

## 换回 GitHub 的运行器

把 `runs-on` 改回原来的值，比如 `ubuntu-latest`，然后提交。Skipbox 没有改动你仓库中的任何其他东西。

## 接下来读什么

- 让你的 AI 编程智能体迁移其余的作业：[用 AI 编程智能体设置](https://docs.skipbox.dev/zh-hans/ai-agents)。
- 更大的虚拟机：[标签和规格](https://docs.skipbox.dev/zh-hans/labels)。
- 虚拟机装了什么：[运行器镜像](https://docs.skipbox.dev/zh-hans/runner-image)。
- 作业没有启动：[作业一直排队](https://docs.skipbox.dev/zh-hans/job-queued)。

更新于 2026-11-12 · https://docs.skipbox.dev/zh-hans/quickstart
