# “The runner has received a shutdown signal”：原因，以及一个内存够用的运行器

> 在 GitHub 托管的运行器上，GitHub 确认的原因是内存：作业把内存用光，虚拟机在内存不足的日志写出来之前就宕掉了。私有仓库的 ubuntu-latest 只有 8 GB。Skipbox 给作业 16 GB，每月固定 $39，或者 32 GB，每月 $149，分钟数不限。

你的作业以 "The runner has received a shutdown signal" 结束，没有退出码。在 GitHub 托管的运行器上，GitHub 维护者确认的原因是内存：私有仓库的 `ubuntu-latest` 只有 8 GB，一旦用光，虚拟机就会在任何内存不足的日志写出来之前停下。每次重试都在烧分钟数，合并也被卡住。

Skipbox 以固定价格给作业它需要的内存：`runs-on: skipbox` 有 16 GB，每月 $39；`skipbox-16x32` 有 32 GB，每月 $149，分钟数不限。

- `runs-on: skipbox` 的内存是私有仓库 `ubuntu-latest` 的两倍，`skipbox-16x32` 是四倍
- 每月 2万分钟的 16 GB：GitHub 的 4 核运行器上 $222，Skipbox 上固定 $39
- 专属机器保留 Docker 层和包缓存，所以能跑通的那次重跑也更快

**固定价格的 GitHub Actions，分钟数不限** Skipbox 在你的专属机器上运行 GitHub Actions 作业：每月 $39，无论运行多少分钟。Docker 层和依赖缓存在作业之间保留，所以下一个作业能立即开始。

4 vCPU 运行器，每月 2万分钟: GitHub $222 → Skipbox $39. 每月节省 $183.

切换只需改一行：`runs-on: skipbox`。

[开始 7 天免费试用](https://app.skipbox.dev/sign-in?ref=g-github-actions-runner-shutdown-signal-zh-hans)

## 这条消息是什么意思

运行器程序的进程在作业期间被要求停止时，会记下这条日志："The runner has received a shutdown signal. This can happen when the runner service is stopped, or a manually started runner is canceled." 随后步骤以 "The operation was canceled." 结束，没有退出码，因为你的命令一个都没有失败。

| 日志显示 | 发生了什么 |
|---|---|
| 关闭消息，没有退出码，没人取消运行 | 虚拟机内存耗尽，宕掉了 |
| `Process completed with exit code 137.` | 内核因为内存终止了一个进程；运行器还活着 |
| 关闭消息，运行页面显示它被取消了 | 更新的一次运行、某个人或超时结束了它 |

在 actions/runner-images issue #15202 中，一位 GitHub 维护者在 8 GB 的 `ubuntu-24.04` 运行器上复现了它：内存加 swap 以内的作业通过了，超出的作业以这条消息丢失了运行器。新镜像可能在你什么都没改的情况下触发它：新的默认工具版本比旧版本需要更多内存。

## 守着 8 GB 的代价

每次丢失的运行，都是白白计费的分钟数、一次重跑，以及一个合并不了的拉取请求。绕开它也是工作：

- 减少测试工作进程、`make -j` 或 Gradle 的工作进程数，让作业跑得更慢
- 给 Node 的 `--max-old-space-size` 或 JVM 的 `-Xmx` 设上限
- 把一个作业拆成几个，再把它们接回去
- 把某个工具钉在旧版本，直到有人有空去修

对内存的需求只会增长：更大的测试套件、更大的构建、编程智能体推送修复带来的更多作业。GitHub 的答案是大型运行器，按每一分钟计费：

| 内存 | 有这么多内存的 GitHub 运行器 | 每月 2万分钟 | Skipbox | 每月，分钟数不限 |
|---|---|---|---|---|
| 16 GB | 4 核大型运行器，每分钟 $0.012 | $222 | `skipbox`，S 套餐 | $39 |
| 32 GB | 8 核大型运行器，每分钟 $0.022 | $422 | `skipbox-16x32`，L 套餐 | $149 |

GitHub 的金额按 GitHub Team 计算，已减去其包含的计算用量；大型运行器需要 Team 或 Enterprise Cloud。在[首页的计算器](https://skipbox.dev/?ref=g-github-actions-runner-shutdown-signal-zh-hans#cost)里查查你自己的分钟数。

你自己的自托管运行器在 GitHub 的账单上不花钱，但每当它的服务重启、主机为打补丁重启或自动扩缩器把机器撤掉时，都会显示同样的消息。把它运行好，就是服务器、打补丁、清理和扩容。

## Skipbox 解决它

### 内存，固定价格

| `runs-on` | 机器 | 套餐，每月 |
|---|---|---|
| `skipbox` | 4 vCPU，16 GB | S，$39 |
| `skipbox-8x16` | 8 vCPU，16 GB | M，$79 |
| `skipbox-16x32` | 16 vCPU，32 GB | L，$149 |

分钟数不限。Skipbox 以自托管运行器的身份注册，所以它的作业不消耗你的任何 GitHub 分钟数，也不会停在 Actions 预算上。超出套餐机器数量的作业排队等待。

### 重跑更快

每个套餐都是一台为你的账号保留的虚拟机。Docker 镜像、层和构建缓存、包缓存和工具缓存都留在它的磁盘上，所以下一次运行带着它们启动，而不是把所有东西重新下载一遍。

### 一台不用你照看的机器

Skipbox 让镜像保持最新，清除每个作业的凭据、进程和容器（从 2026年11月13日起，检出目录和 Cargo 的 `target/` 会保留），在每个作业后对机器做健康检查，并重建检查失败的机器。虚拟机运行 Ubuntu 24.04，带有 Docker、Node.js 和 Python。

## 切换只需改一行

```yaml
jobs:
  build:
    runs-on: skipbox # was ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm ci && npm test
```

1. 使用 GitHub 登录 Skipbox。
2. 安装 Skipbox GitHub 应用，并选择仓库。
3. 修改 `runs-on` 并推送。

`skipbox` 在每个套餐上都能运行，`skipbox-16x32` 在 L 套餐上运行。想换回去，把这一行改回去即可。

## 用你自己的作业试试

试用免费，为期 7 天 或 3,000 作业分钟，以先到者为准，无需绑卡。试用以 4 vCPU、16 GB 运行 `runs-on: skipbox` 作业，是私有仓库 `ubuntu-latest` 内存的 2 倍，所以把内存不够的作业移过来，看它带着保留的缓存跑完，再为需要更多内存的作业选 L 套餐。

## 常见问题

### “The runner has received a shutdown signal” 是什么意思？

运行器程序在你的作业运行期间被要求停止。在 GitHub 托管的运行器上，你并没有停止任何东西：作业底下的虚拟机没了，最常见的原因是作业用光了它的全部内存。Skipbox 的 skipbox 和 skipbox-16x32 以按月固定价格给作业 16 或 32 GB。

### 为什么我的作业没有任何错误就被取消了？

日志以这条关闭消息和 “The operation was canceled.” 结尾、又没有退出码时，是运行器丢失了，而不是某个步骤失败。一位 GitHub 维护者在 actions/runner-images issue #15202 中确认，内存一旦耗尽，虚拟机会在内存不足的消息写进日志之前就失去响应。给作业更多内存：在 Skipbox 上，只需改一行 runs-on。

### 这是内存不足的错误吗？

在托管运行器上，通常是。作业被终止而运行器还活着时，显示的是退出码 137；作业把整台虚拟机拖垮时，显示的是这条关闭消息。不管哪种，作业需要的都超过了 ubuntu-latest 的 8 GB，而 Skipbox 的每个套餐都以固定价格提供更多。

### 为什么自托管运行器也会显示它？

有什么东西在作业中途停掉了运行器进程或它的机器：服务重启、为了更新而重启、自动扩缩器移除了机器，或者主机内存耗尽。在 Skipbox 上，机器由我们替你管理，每个作业后都做健康检查，检查失败的机器自动重建。

### Skipbox 的免费试用能解决内存不足的作业吗？

它给作业 2 倍的内存。试用以 4 vCPU、16 GB 运行 runs-on: skipbox 作业，而私有仓库的 ubuntu-latest 只有 8 GB。需要更多内存，就用 L 套餐的 runs-on: skipbox-16x32（32 GB）。

更新于 2026-11-11 · https://skipbox.dev/zh-hans/guides/github-actions-runner-shutdown-signal
