# 使用 Homebrew, apk, pacman, winget 安装 gitea-runner

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

## 安装

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

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install gitea-runner
```

  证据: local Homebrew formula metadata

### Linux

- apk (92%):

```sh
sudo apk add gitea-runner
```

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

- pacman (92%):

```sh
sudo pacman -S gitea-runner
```

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

### Windows

- winget (92%):

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

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

## 软件包事实

- **软件包键:** brew:gitea-runner
- **软件包管理器:** Homebrew
- **版本:** 3.0.1
- **来源摘要:** Official Actions runner for Gitea
- **主页:** <https://gitea.com/gitea/runner>
- **最后更新:** 2026-08-03T00:17:51Z
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- gitea-runner (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

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

Gitea Runner is the official runner for Gitea Actions, the workflow automation system used by Gitea installations. It gives self-hosted Gitea sites a worker process that can register with an instance, accept jobs, and execute GitHub Actions-style workflows through Docker or host execution labels.

### 项目历史

The runner codebase descends from the act-runner effort around Gitea Actions. The official repository's Git history begins in 2019 with support for GitHub Actions-style execution, while the Gitea-runner release stream begins with v0.0.1 in 2023 and reaches the renamed Gitea Runner 1.x and 2.x series in 2026.

The project evolved from a companion binary for early Actions support into a documented part of the Gitea platform. Its README and Gitea documentation describe binary, container, Docker-in-Docker, rootless Docker-in-Docker, cache server, label, and post-task-script modes, reflecting the operational concerns of running CI workers for many repositories.

### 采用历史

Adoption follows Gitea Actions itself: administrators enable Actions on a Gitea instance, create or obtain runner registration tokens, and attach one or more runner processes to supply build capacity. Packaging in Homebrew, Alpine, Arch, and WinGet makes the runner fit the same self-hosted deployment culture as Gitea.

### 使用方式

Practitioners use Gitea Runner by generating or supplying a YAML config, registering the runner with a Gitea instance URL and token, then running the daemon. Container deployments often mount the Docker socket or run Docker-in-Docker images so workflow jobs can execute inside job containers.

Labels are central to day-to-day use: a label such as an Ubuntu image or a host execution label controls which workflows can target the runner and how jobs are launched. Operators also configure cache behavior, ephemeral runners, registration state, and cleanup scripts when they need repeatable CI nodes.

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

For package-manager users, Gitea Runner is the small binary that turns a packaged Gitea server from code hosting into a self-contained CI system. It matters because it avoids a separate hosted CI dependency while keeping the workflow syntax close to GitHub Actions.

### 时间线

- 2019: Runner repository history begins with GitHub Actions-style execution work.
- 2023: v0.0.1 appears in the runner release stream.
- 2026: v1.0.0 and v2.0.0 mark the renamed Gitea Runner series.

### Related projects

- Gitea Runner is closely tied to Gitea, Gitea Actions, workflow files in repositories, and the nektos/act ecosystem that influenced local execution of GitHub Actions workflows.

### 来源

- <https://blog.gitea.com/release-of-runner-2.0.0>
- <https://docs.gitea.com/usage/actions/act-runner>
- <https://gitea.com/gitea/runner>


## 安全说明

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: ./config.yaml

## Credential files

- Unix: ./.runner
## 其他软件包管理器记录

- apk - gitea-runner - 3.0.0-r0: normalized package name match | Alpine Linux edge package indexes: gitea-runner from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Official runner for Gitea | https://gitea.com/gitea/runner
- apk - gitea-runner-openrc - 3.0.0-r0: normalized package name match | Alpine Linux edge package indexes: gitea-runner-openrc from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Official runner for Gitea (OpenRC init scripts) | https://gitea.com/gitea/runner
- pacman - gitea-runner - 3.0.0-1: normalized package name match | Arch Linux sync databases: gitea-runner from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | Official runner for Gitea | https://gitea.com/gitea/runner
- winget - Gitea.Runner: normalized package name match | Windows Package Manager source index: Gitea.Runner from https://cdn.winget.microsoft.com/cache/source.msix


## Combined YAML source

View the package source record on GitHub. [combined/gitea-runner.yml](https://github.com/mxcl/pkgdb/blob/main/combined/gitea-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