# 使用 Homebrew, apk, chocolatey, MacPorts, Nix, pacman, scoop, winget 安装 gitlab-runner

查看 gitlab-runner 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:gitlab-runner
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install gitlab-runner
```

  证据: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install gitlab-runner
```

  证据: MacPorts ports tree: devel/gitlab-runner/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- apk (92%):

```sh
sudo apk add gitlab-runner
```

  证据: Alpine Linux edge package indexes: gitlab-runner from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

- Nix (92%):

```sh
nix profile install nixpkgs#gitlab-runner
```

  证据: nixpkgs package indexes: pkgs/by-name/gi/gitlab-runner/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- pacman (92%):

```sh
sudo pacman -S gitlab-runner
```

  证据: Arch Linux sync databases: gitlab-runner from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

### Windows

- Chocolatey (92%):

```sh
choco install gitlab-runner
```

  证据: Chocolatey community package catalog: gitlab-runner from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='11','gitextensions'

- Scoop (92%):

```sh
scoop install main/gitlab-runner
```

  证据: Scoop official bucket manifest trees: bucket/gitlab-runner.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1

- winget (92%):

```sh
winget install --id Gitlab.Runner -e
```

  证据: Windows Package Manager source index: Gitlab.Runner from https://cdn.winget.microsoft.com/cache/source.msix

## 软件包事实

- **软件包键:** brew:gitlab-runner
- **软件包管理器:** Homebrew
- **版本:** 19.2.1
- **来源摘要:** Official GitLab CI runner
- **主页:** <https://gitlab.com/gitlab-org/gitlab-runner>
- **最后更新:** 2026-07-29T16:05:02+02:00
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- gitlab-runner (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

- 页面生成时间: 2026-08-03
- 管理器版本: 19.2.1
## 项目历史与用法

GitLab Runner is the open-source agent that executes GitLab CI/CD jobs and reports their results back to GitLab. It is a core piece of GitLab's automation model because pipelines defined in .gitlab-ci.yml need one or more runners to perform the actual work.

### 项目历史

The runner project began in the GitLab CI era under the name GitLab CI Multi Runner. The repository README records the older name and credits Kamil Trzcinski for the 2014-2015 authorship period before GitLab Inc. and contributors took over maintenance.

Early public tags in the GitLab Runner repository date to January 2015. The project evolved from a CI worker into a cross-platform runner manager written in Go, distributed as a single binary, and paired with GitLab's major/minor release rhythm for compatibility.

### 采用历史

GitLab Runner became significant because GitLab supports both hosted and self-managed runner models. Organizations can use GitLab-hosted runners for managed capacity or install self-managed runners on their own machines, containers, virtual machines, or Kubernetes clusters.

Its ecosystem reach is visible in packaging and deployment channels: GitLab documents installation across operating systems, the project publishes helper images, and package managers such as Homebrew distribute the runner for local and service-based setups.

### 使用方式

Practitioners register runner instances with a GitLab project, group, or instance, choose an executor such as shell, Docker, SSH, Kubernetes, or autoscaling modes, and tune config.toml for job limits, caching, network settings, and executor-specific behavior.

Administrators treat the runner as infrastructure: they size worker capacity, isolate sensitive workloads, attach tags to route jobs, monitor logs and metrics, and keep runner versions aligned with GitLab releases so pipeline features behave as expected.

### 为什么软件包爱好者会关心

For package-minded users, GitLab Runner is a rare CI component that is both a service daemon and a developer workstation tool. The Homebrew formula and other package-manager entries matter because local runners are useful for testing CI behavior, while production installations often run as long-lived services.

### 时间线

- 2014-2015: Kamil Trzcinski authored the runner project during its GitLab CI Multi Runner period.
- 2015: Early v0.1.x tags appeared in the repository.
- 2015 onward: GitLab Inc. and contributors maintained the project as GitLab Runner.
- 2026: The v19 release line reflected GitLab Runner's continued alignment with GitLab release numbering.

### Related projects

- GitLab CI/CD provides the pipeline coordinator and .gitlab-ci.yml configuration consumed by runners.
- GitLab Release CLI and other CI helper tools rely on runner-provided job context when used inside pipelines.

### 来源

- <https://docs.gitlab.com/runner/>
- <https://docs.gitlab.com/runner/configuration/advanced-configuration/>
- <https://formulae.brew.sh/formula/gitlab-runner>
- <https://gitlab.com/api/v4/projects/gitlab-org%2Fgitlab-runner>
- <https://gitlab.com/gitlab-org/gitlab-runner>
- <https://gitlab.com/gitlab-org/gitlab-runner/-/raw/main/README.md>
- <https://gitlab.com/gitlab-org/gitlab-runner/-/raw/main/docs/_index.md>


## 安全说明

formula declares a Homebrew service.

- **Geiger 风险:** orange / 中
- formula declares a Homebrew service


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: /etc/gitlab-runner/config.toml, ~/.gitlab-runner/config.toml, ./config.toml
## 其他软件包管理器记录

- Nix - gitlab-runner: normalized package name match | nixpkgs package indexes: pkgs/by-name/gi/gitlab-runner/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- apk - gitlab-runner - 19.1.1-r0: normalized package name match | Alpine Linux edge package indexes: gitlab-runner from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | GitLab runner for CI/CD jobs | https://docs.gitlab.com/runner/
- apk - gitlab-runner-helper - 19.1.1-r0: normalized package name match | Alpine Linux edge package indexes: gitlab-runner-helper from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | GitLab runner for CI/CD jobs (helper) | https://docs.gitlab.com/runner/
- apk - gitlab-runner-openrc - 19.1.1-r0: normalized package name match | Alpine Linux edge package indexes: gitlab-runner-openrc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | GitLab runner for CI/CD jobs (OpenRC init scripts) | https://docs.gitlab.com/runner/
- pacman - gitlab-runner - 19.2.1-1: normalized package name match | Arch Linux sync databases: gitlab-runner from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | The official GitLab CI runner written in Go | https://gitlab.com/gitlab-org/gitlab-runner
- MacPorts - gitlab-runner: normalized package name match | MacPorts ports tree: devel/gitlab-runner/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1
- Chocolatey - gitlab-runner: normalized package name match | Chocolatey community package catalog: gitlab-runner from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='11','gitextensions'
- Scoop - main/gitlab-runner: normalized package name match | Scoop official bucket manifest trees: bucket/gitlab-runner.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1
- winget - Gitlab.Runner: normalized package name match | Windows Package Manager source index: Gitlab.Runner from https://cdn.winget.microsoft.com/cache/source.msix


## Combined YAML source

View the package source record on GitHub. [combined/gitlab-runner.yml](https://github.com/mxcl/pkgdb/blob/main/combined/gitlab-runner.yml)


## 来源

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph
