Как да пусна self-hosted GitHub Actions runner на VPS?

Провижни Linux VPS (Small — 4 vCPU / 4 GB — е разумният по подразбиране), инсталирай runner пакета от Settings → Actions → Runners на repo-то си, регистрирай го с token-а, който GitHub ти дава, и го стартирай като услуга. Пълни copy-paste стъпки са по-долу; получаваш root за около минута.

Мога ли да пусна runner-а в Docker?

Да. Пусни официалния runner образ (или собствен) в контейнер, или го използвай, за да дадеш на всяка задача изолирана, еднократна среда. План с dedicated IP не се изисква — runner-ът прави само изходящи връзки към GitHub, така че NAT план също работи.

Как да държа runner-а работещ като услуга?

Runner-ът идва със svc.sh helper, който инсталира systemd unit: ./svc.sh install && ./svc.sh start. После той преживява рестарти и се рестартира при провал. Ръководството по-долу показва точните команди.

Self-hosted runner по-евтин ли е от GitHub-хостнати минути?

За тежко или често CI, да. GitHub-хостнатите runners фактурират на минута отвъд безплатното ниво; VPS за $8/месец пуска неограничени минути за плоска такса, и стои топъл (без cold-start, кеширани зависимости). Едно натоварено repo обикновено плаща за машината.

Искате ли документ или кредитна карта?

Не. Регистрирай се с имейл, плати с USDC или USDT. Без документи, без карта, без KYC — никога.

VPS за self-hosted GitHub Actions runners

Пусни собствен self-hosted GitHub Actions runner на VPS — по-бърз CI, без per-minute фактуриране, пълен контрол над build средата. Плащане в crypto, без KYC. От $8/месец.

GitHub-хостнатите runners са удобни, докато сметката или времето за чакане не започнат да болят. Отвъд безплатното ниво плащаш на минута, cold-start-ваш всяка задача, и предварително сваляш зависимости всяко пускане. Self-hosted runner на собствен VPS обръща и трите: плоска месечна цена, топла машина с кешовете ти вече на диск, и build среда, която напълно контролираш — конкретни версии на инструменти, повече RAM, Docker layer cache, който реално persist-ва.

Runner се нуждае само да достигне GitHub изходящо, така че работи на най-евтините ни планове, плаща в crypto, и не се нуждае от KYC.

Какво се нуждае runner

CPU и RAM за build-овете ти. Small ($8/месец — 4 vCPU, 4 GB RAM, 35 GB NVMe) е комфортният по подразбиране за повечето CI: Node/Go/Rust build-ове, тестови пакети, Docker image build-ове. Тежка компилация или паралелни задачи? Качи до Medium или Pro план.
NVMe диск за кешове. Целият смисъл на хостването е persistence — кешове на зависимости, Docker layers, build артефакти остават на диск между пускания. NVMe държи restore-овете бързи.
Не се изисква dedicated IP. Runner-ът се набира навън към GitHub през HTTPS; нищо не трябва да го достига входящо. NAT план (от $3/месец) е достатъчен. Вземи dedicated IP само ако хостваш и нещо, което обслужва трафик.

Настрой runner (Ubuntu 24.04)

Създай runner-а в repo-то си (или org): Settings → Actions → Runners → New self-hosted runner → Linux. GitHub показва команда за сваляне и еднократен регистрационен token. На VPS-а:

# as a non-root user (the runner refuses to run as root)
adduser --disabled-password --gecos "" runner
su - runner

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

# register with the URL + token from the GitHub UI
./config.sh --url https://github.com/YOUR_ORG/YOUR_REPO --token YOUR_TOKEN

Дръж го работещ като услуга

Не пускай ./run.sh в терминал — инсталирай го като systemd услуга, за да преживее рестарти:

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

Runner-ът вече се появява като Idle в GitHub UI и поема всяка задача, която го таргетира.

Използвай го от workflow

Насочи задача към runner-а си с runs-on:

jobs:
  build:
    runs-on: self-hosted        # or a custom label you set at registration
    steps:
      - uses: actions/checkout@v4
      - run: make build && make test

Docker-базирани задачи

Инсталирай Docker веднъж и workflow-ите ти могат да build-ват образи или да пускат service контейнери, с layer cache, persist-ващ между пускания:

sudo apt update && sudo apt install -y docker.io
sudo usermod -aG docker runner   # let the runner use Docker without sudo

За еднократна изолация на задача, пусни самия runner в контейнер и го пресъздавай всяко пускане — чест модел за недоверени или matrix build-ове.

Защо EQVPS за CI

Плоска цена, неограничени минути. Без per-minute измерване — натоварен pipeline струва същото като idle.
Топли кешове. Зависимости и Docker layers остават на NVMe между пускания; build-овете стават по-бързи, не по-бавни.
Root за ~60 секунди, чисти образи. Ubuntu, Debian и още през cloud-init; инсталирай точно toolchain-а, от който се нуждаеш.
Без KYC, плащане в crypto. Имейл за регистрация, USDC/USDT за плащане. Вдигни допълнителни runners за release crunch-ове и ги откажи после — неизползваното платено време се възстановява на баланса ти.

Пълно стъпка-по-стъпка ръководство за настройка →