Desarrollo

Script de instalación de un runner autoalojado de GitHub Actions

Indica tu repositorio y tus etiquetas y obtén un script que instala el runner con su propio usuario y lo inicia como servicio. El token lo introduces en tu servidor, no aquí.

Funciona por completo en tu navegador: nada de lo que escribes se envía a nuestros servidores.

URL del repositorio o de la organizaciónSustituye el ejemplo por tu dirección. Para un runner de toda la organización, deja solo la organización.

Nombre del runnerEtiquetas, separadas por comasUsuario de Linux

Instalar Docker para los trabajos que lo necesiten

Solo para repositorios privados. En uno público, una pull request desde un fork puede ejecutar código en tu servidor.

Script de instalación

#!/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

Línea para tu workflow

runs-on: [self-hosted, vps]

Cómo ejecutarlo

En GitHub abre Settings → Actions → Runners → New self-hosted runner y copia el token.
Copia el script a tu servidor Debian o Ubuntu y ejecútalo como root: bash install-runner.sh.
Pega el token cuando el script lo pida. Se queda en tu servidor y nunca pasa por esta página.
Añade la línea runs-on a tu workflow.

Guía paso a paso: runner autoalojado en un VPS

¿Necesitas un servidor para el runner? Plan Small: 4 vCPU, 4 GB de RAM, acceso root, 8 $/mes.

Plan Small

Cómo funciona

Un runner autoalojado funciona en tu propia máquina: se conecta a GitHub, recoge los trabajos y los ejecuta allí. El script instala los paquetes necesarios, crea un usuario de Linux aparte, descarga la última versión del runner, lo registra y configura un servicio systemd que sobrevive a los reinicios. El script se genera en tu navegador, así que lee cada línea antes de ejecutarlo. El servidor solo necesita acceso de salida a GitHub, no hace falta una IP dedicada.

Preguntas frecuentes

¿Dónde consigo el token de registro?

En tu repositorio abre Settings → Actions → Runners → New self-hosted runner. El token es válido durante una hora. Para un runner de toda la organización, sigue la misma ruta en los ajustes de la organización.

¿Puedo usar un runner autoalojado con un repositorio público?

GitHub lo desaconseja: una pull request desde un fork puede ejecutar código en tu servidor. Usa runners autoalojados con repositorios privados.

¿El servidor necesita una IP dedicada?

No. El runner solo abre conexiones de salida hacia GitHub, así que sirve un plan sin IP dedicada. En cuanto a potencia, 4 vCPU y 4 GB de RAM bastan para la mayoría de los proyectos.

Herramientas relacionadas

b64

Codificador/decodificador Base64

Texto y archivos a Base64 y al revés, opción URL-safe.

Generador de UUID

UUID v4 y v7 ordenados por tiempo, en lote.

*/5

Asistente de cron

Explica una línea de crontab y muestra las próximas ejecuciones.

Аa

Transliteración

Cirílico a latino: normas de pasaporte y slugs de URL.

Todas las herramientas →