Desenvolvimento

Script de instalação de runner auto-hospedado do GitHub Actions

Informe seu repositório e as etiquetas para obter um script que instala o runner com um usuário próprio e o inicia como serviço. Você digita o token no seu servidor, não aqui.

Funciona inteiramente no seu navegador — nada do que você digita é enviado aos nossos servidores.

URL do repositório ou da organizaçãoTroque o exemplo pelo seu endereço. Para um runner de toda a organização, deixe só a organização.

Nome do runnerEtiquetas, separadas por vírgulaUsuário Linux

Instalar o Docker para os jobs que precisam dele

Só para repositórios privados. Em um público, um pull request de um fork pode executar código no seu servidor.

Script de instalação

#!/usr/bin/env bash
# Installs a self-hosted GitHub Actions runner as a systemd service (Debian, Ubuntu).
# Run as root: bash install-runner.sh
set -euo pipefail

REPO_URL="https://github.com/your-org/your-repo"
RUNNER_NAME="vps-runner-1"
RUNNER_LABELS="vps"
RUNNER_USER="runner"
RUNNER_DIR="/home/$RUNNER_USER/actions-runner"

[ "$(id -u)" -eq 0 ] || { echo "Run this script as root." >&2; exit 1; }
command -v apt-get >/dev/null || { echo "This script supports Debian and Ubuntu only." >&2; exit 1; }
case "$(uname -m)" in
  x86_64) ARCH=x64 ;;
  aarch64) ARCH=arm64 ;;
  *) echo "Unsupported CPU: $(uname -m)" >&2; exit 1 ;;
esac
[ ! -f "$RUNNER_DIR/.runner" ] || { echo "A runner is already configured in $RUNNER_DIR." >&2; exit 1; }

read -rsp "Registration token from GitHub: " RUNNER_TOKEN; echo
[ -n "$RUNNER_TOKEN" ] || { echo "The token is empty." >&2; exit 1; }

apt-get update -y
apt-get install -y curl tar ca-certificates
id "$RUNNER_USER" >/dev/null 2>&1 || useradd -m -s /bin/bash "$RUNNER_USER"

# Latest runner release
VERSION="$(curl -fsSLI -o /dev/null -w '%{url_effective}' https://github.com/actions/runner/releases/latest | sed 's|.*/tag/v||')"
FILE="actions-runner-linux-$ARCH-$VERSION.tar.gz"
as_runner() { runuser -u "$RUNNER_USER" -- env HOME="/home/$RUNNER_USER" "$@"; }
as_runner mkdir -p "$RUNNER_DIR"
cd "$RUNNER_DIR"
as_runner curl -fsSL -o "$FILE" "https://github.com/actions/runner/releases/download/v$VERSION/$FILE"
as_runner tar xzf "$FILE"
rm -f "$FILE"
./bin/installdependencies.sh

# Register with GitHub and start as a service
as_runner ./config.sh --unattended --url "$REPO_URL" --token "$RUNNER_TOKEN" --name "$RUNNER_NAME" --labels "$RUNNER_LABELS" --replace
./svc.sh install "$RUNNER_USER"
./svc.sh start
./svc.sh status --no-pager

Linha para o seu workflow

runs-on: [self-hosted, vps]

Como executar

No GitHub abra Settings → Actions → Runners → New self-hosted runner e copie o token.
Copie o script para o seu servidor Debian ou Ubuntu e execute como root: bash install-runner.sh.
Cole o token quando o script pedir. Ele fica no seu servidor e nunca passa por esta página.
Coloque a linha runs-on no seu workflow.

Guia passo a passo: runner auto-hospedado em um VPS

Precisa de um servidor para o runner? Plano Small: 4 vCPU, 4 GB de RAM, acesso root, US$ 8/mês.

Plano Small

Como funciona

Um runner auto-hospedado funciona na sua própria máquina: ele se conecta ao GitHub, pega os jobs e os executa ali. O script instala os pacotes necessários, cria um usuário Linux separado, baixa a versão mais recente do runner, faz o registro e configura um serviço systemd que sobrevive a reinicializações. O script é montado no seu navegador, então leia cada linha antes de executá-lo. O servidor só precisa de acesso de saída ao GitHub, sem necessidade de IP dedicado.

Perguntas frequentes

Onde consigo o token de registro?

No seu repositório abra Settings → Actions → Runners → New self-hosted runner. O token vale por uma hora. Para um runner de toda a organização, siga o mesmo caminho nas configurações da organização.

Posso usar um runner auto-hospedado com um repositório público?

O GitHub não recomenda: um pull request de um fork pode executar código no seu servidor. Use runners auto-hospedados com repositórios privados.

O servidor precisa de IP dedicado?

Não. O runner só abre conexões de saída para o GitHub, então um plano sem IP dedicado serve. Quanto à potência, 4 vCPU e 4 GB de RAM bastam para a maioria dos projetos.

Ferramentas relacionadas

b64

Codificador/decodificador Base64

Texto e arquivos para Base64 e de volta, opção URL-safe.

Gerador de UUID

UUID v4 e v7 ordenados por tempo, em lote.

*/5

Assistente de cron

Explica uma linha do crontab e mostra as próximas execuções.

Аa

Transliteração

Cirílico para latino: padrões de passaporte e slugs de URL.

Todas as ferramentas →