Jak skonfigurować własny runner GitHub Actions na VPS

Zarejestruj własny runner GitHub Actions na VPS i zainstaluj go jako usługę: pobierz runner jako użytkownik bez roota, zarejestruj tokenem repozytorium, uruchom svc.sh, aby przetrwał ponowne uruchomienia. Polecenia kopiuj-wklej.

Własny runner daje ci CI o stałym koszcie z ciepłymi cache — bez rozliczania za minutę, twój toolchain, twoja maszyna. Oto minimalny poradnik konfiguracji; dlaczego własny hosting wygrywa z minutami hostowanymi przez GitHub oraz szczegóły zadań Docker znajdziesz w pełnym przewodniku i przypadku użycia VPS dla GitHub Actions.

1. Utwórz użytkownika bez roota (runner odrzuca roota)

adduser --disabled-password --gecos "" runner
su - runner

2. Pobierz runner

W GitHubie: Settings → Actions → Runners → New self-hosted runner → Linux, co daje dokładne pobranie i jednorazowy token. Następnie:

mkdir actions-runner && cd actions-runner
curl -o actions-runner-linux-x64.tar.gz -L \
  https://github.com/actions/runner/releases/latest/download/actions-runner-linux-x64.tar.gz
tar xzf actions-runner-linux-x64.tar.gz

3. Zarejestruj go w repozytorium

./config.sh --url https://github.com/YOUR_ORG/YOUR_REPO --token YOUR_TOKEN

4. Zainstaluj jako usługę (przetrwa ponowne uruchomienia)

Nie uruchamiaj ./run.sh w terminalu — zainstaluj go:

sudo ./svc.sh install runner
sudo ./svc.sh start
sudo ./svc.sh status

Runner pokazuje się teraz jako Idle w interfejsie GitHub i podejmuje zadania, które go celują.

5. Użyj go z workflow

jobs:
  build:
    runs-on: self-hosted
    steps:
      - uses: actions/checkout@v4
      - run: make build && make test

Zadania Docker (opcjonalnie)

Zainstaluj Docker raz, a workflow mogą budować obrazy z cache warstw utrzymywanym między uruchomieniami:

sudo apt install -y docker.io
sudo usermod -aG docker runner

Zobacz instalowanie Dockera na VPS. Rozmiar: Small (8 $/mies.) jest wygodny dla większości CI; podbij dla ciężkiej kompilacji. Root w około minutę, bez KYC, płatność w krypto.

FAQ

Jak zarejestrować własny runner GitHub Actions?

W repozytorium (lub organizacji): Settings → Actions → Runners → New self-hosted runner → Linux. GitHub pokazuje polecenie pobrania i jednorazowy token rejestracji. Pobierz runner jako użytkownik bez roota, uruchom ./config.sh z tym URL i tokenem, następnie zainstaluj go jako usługę przez svc.sh. Kroki poniżej.

Dlaczego runner nie może działać jako root?

Runner z założenia odmawia działania jako root. Utwórz dedykowanego użytkownika bez roota (adduser runner) i skonfiguruj go tam. To także ogranicza, czego złośliwy workflow mógłby dotknąć na twojej maszynie.

Jak utrzymać runner uruchomiony po ponownym uruchomieniu?

Użyj dołączonego pomocnika svc.sh: sudo ./svc.sh install runner && sudo ./svc.sh start. Instaluje jednostkę systemd, aby runner startował przy rozruchu i restartował po awarii, oraz pokazywał się jako Idle w interfejsie GitHub.

Czy potrzebuję dedykowanego IP dla runnera?

Nie. Runner dzwoni na zewnątrz do GitHuba po HTTPS; nic nie musi docierać do niego przychodząco. Plan NAT (od 3 $/mies.) wystarczy. Weź dedykowane IP tylko, jeśli dodatkowo hostujesz coś, co obsługuje ruch.

Czy wymagacie dokumentu lub karty?

Nie. E-mail do rejestracji, płatność w USDC lub USDT — bez dokumentów, bez karty. Root w około minutę.

Komentarze

Brak komentarzy. Bądź pierwszy.