Gitea 使用 Docker 一次性安装 gitea和act_runner

安装步骤

1. 首先确保你有运行中的 Gitea 实例

docker run -d \
  --name gitea \
  -p 3000:3000 \
  -p 222:22 \
  -v /var/lib/gitea:/data \
  gitea/gitea:latest

2. 在 Gitea 中创建 Runner

登录 Gitea： - 进入 设置 → Actions → Runners - 点击 创建 Runner，复制注册令牌

3. 运行 act_runner 容器

docker run -d \
  --name gitea-runner \
  -v /var/lib/gitea-runner:/data \
  -e GITEA_INSTANCE_URL=http://your-gitea-url:3000 \
  -e GITEA_RUNNER_REGISTRATION_TOKEN=your-registration-token \
  gitea/act_runner:latest

4. 使用 Docker Compose（推荐）

创建 docker-compose.yml:

version: "3"

services:
  gitea:
    image: gitea/gitea:latest
    container_name: gitea
    restart: always
    ports:
      - "3000:3000"
      - "222:22"
    volumes:
      - ./gitea:/data
    environment:
      - GITEA__server__DOMAIN=localhost
      - GITEA__actions__ENABLED=true

  runner:
    image: gitea/act_runner:latest
    container_name: gitea-runner
    restart: always
    volumes:
      - ./runner:/data
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - GITEA_INSTANCE_URL=http://gitea:3000
      - GITEA_RUNNER_REGISTRATION_TOKEN=your-token-here
      - GITEA_RUNNER_LABELS=linux:host
    depends_on:
      - gitea

启动：

docker compose up -d

参数说明

参数	说明
GITEA_INSTANCE_URL	Gitea 服务地址
GITEA_RUNNER_REGISTRATION_TOKEN	注册令牌
GITEA_RUNNER_NAME	Runner 名称（可选）
GITEA_RUNNER_LABELS	Runner 标签（如 docker:linux）
/var/run/docker.sock	挂载 Docker socket 以支持容器化任务

验证安装

在 Gitea 的 设置 → Actions → Runners 中查看 Runner 状态是否为 活跃。

示例 Workflow

创建 .gitea/workflows/test.yml:

name: Test
on: [push]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - run: echo "Hello from Gitea Actions!"