Gitea act_runner Docker 部署文档
Gitea 直接部署在服务器上，仅使用 Docker 部署 act_runner。
docker-compose.yml
version: "3"
services:
runner:
image: gitea/act_runner:latest
container_name: gitea-runner
restart: always
volumes:
- ./config.yaml:/config.yaml
- ./data:/data
- /var/run/docker.sock:/var/run/docker.sock
environment:
CONFIG_FILE: /config.yaml
GITEA_INSTANCE_URL: "http://39.106.37.60:23000/"
GITEA_RUNNER_REGISTRATION_TOKEN: "pIkNKhcxl2rnvbDmBe3XB8RoibwCspYdWgaJBNyp"
GITEA_RUNNER_NAME: "hhj-ubuntu-latest"
GITEA_RUNNER_LABELS: "ubuntu-latest:docker"
部署步骤
1. 获取注册令牌
登录 Gitea：http://39.106.37.60:23000/
- 进入 设置 → Actions → Runners
- 点击 创建 Runner
- 复制注册令牌
2. 创建目录和配置文件
mkdir -p /root/gitea-runner && cd /root/gitea-runner
将 docker-compose.yml 内容保存到当前目录。
3. 替换注册令牌
vi docker-compose.yml
将 your-token-here 替换为步骤 1 获取的实际令牌。
4. 启动 Runner
docker compose up -d
5. 查看运行状态
# 查看日志
docker compose logs -f runner
# 查看容器状态
docker compose ps
6. 验证
回到 Gitea：http://39.106.37.60:23000/
在 设置 → Actions → Runners 中查看 Runner 状态是否为 活跃。
常用命令
# 停止 Runner
docker compose down
# 重启 Runner
docker compose restart
# 查看日志
docker compose logs -f runner
# 进入容器
docker exec -it gitea-runner bash
参数说明
| 参数 | 值 | 说明 |
|---|---|---|
GITEA_INSTANCE_URL |
http://39.106.37.60:23000/ |
Gitea 服务地址 |
GITEA_RUNNER_REGISTRATION_TOKEN |
your-token-here |
注册令牌（需替换） |
GITEA_RUNNER_LABELS |
ubuntu-latest:docker |
Runner 标签 |
/var/run/docker.sock |
- | 挂载 Docker socket 支持容器化任务 |
示例 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!"