डेवलपर

सेल्फ-होस्टेड GitHub Actions रनर की इंस्टॉल स्क्रिप्ट

अपनी रिपॉज़िटरी और लेबल भरें और ऐसी स्क्रिप्ट पाएँ जो रनर को अलग यूज़र के तहत इंस्टॉल करके सर्विस के रूप में चालू करे। टोकन आप अपने सर्वर पर डालते हैं, यहाँ नहीं।

पूरी तरह आपके ब्राउज़र में चलता है — आप जो भी डालते हैं, वह हमारे सर्वर पर नहीं भेजा जाता।

रिपॉज़िटरी या संगठन का URLउदाहरण की जगह अपना पता डालें। पूरे संगठन के रनर के लिए सिर्फ़ संगठन रखें।

रनर का नामलेबल, कॉमा से अलगLinux यूज़र

जिन जॉब को ज़रूरत हो, उनके लिए Docker इंस्टॉल करें

सिर्फ़ प्राइवेट रिपॉज़िटरी के लिए। पब्लिक में फ़ोर्क से आया pull request आपके सर्वर पर कोड चला सकता है।

इंस्टॉल स्क्रिप्ट

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

आपके workflow के लिए लाइन

runs-on: [self-hosted, vps]

कैसे चलाएँ

GitHub पर Settings → Actions → Runners → New self-hosted runner खोलें और टोकन कॉपी करें।
स्क्रिप्ट को अपने Debian या Ubuntu सर्वर पर कॉपी करें और root के रूप में चलाएँ: bash install-runner.sh।
स्क्रिप्ट के पूछने पर टोकन पेस्ट करें। वह आपके सर्वर पर रहता है और इस पेज से कभी नहीं गुज़रता।
runs-on लाइन अपने workflow में डालें।

चरण-दर-चरण गाइड: VPS पर सेल्फ-होस्टेड रनर

रनर के लिए सर्वर चाहिए? Small प्लान: 4 vCPU, 4 GB RAM, root एक्सेस, $8/महीना।

Small प्लान

यह कैसे काम करता है

सेल्फ-होस्टेड रनर आपकी अपनी मशीन पर काम करता है: वह खुद GitHub से जुड़ता है, जॉब लेता है और वहीं चलाता है। स्क्रिप्ट ज़रूरी पैकेज इंस्टॉल करती है, अलग Linux यूज़र बनाती है, रनर का नया रिलीज़ डाउनलोड करती है, उसे रजिस्टर करती है और systemd सर्विस सेट करती है जो रीबूट के बाद भी चलती रहती है। स्क्रिप्ट आपके ब्राउज़र में बनती है, इसलिए चलाने से पहले हर लाइन पढ़ लें। सर्वर को सिर्फ़ GitHub तक आउटगोइंग एक्सेस चाहिए, डेडिकेटेड IP ज़रूरी नहीं।

अक्सर पूछे जाने वाले सवाल

रजिस्ट्रेशन टोकन कहाँ मिलेगा?

अपनी रिपॉज़िटरी में Settings → Actions → Runners → New self-hosted runner खोलें। टोकन एक घंटे तक मान्य रहता है। पूरे संगठन के रनर के लिए संगठन की सेटिंग्स में यही रास्ता अपनाएँ।

क्या सेल्फ-होस्टेड रनर को पब्लिक रिपॉज़िटरी के साथ इस्तेमाल कर सकते हैं?

GitHub इसकी सलाह नहीं देता: फ़ोर्क से आया pull request आपके सर्वर पर कोड चला सकता है। सेल्फ-होस्टेड रनर प्राइवेट रिपॉज़िटरी के साथ इस्तेमाल करें।

क्या सर्वर को डेडिकेटेड IP चाहिए?

नहीं। रनर सिर्फ़ GitHub की ओर आउटगोइंग कनेक्शन खोलता है, इसलिए बिना डेडिकेटेड IP वाला प्लान काफ़ी है। क्षमता की बात करें तो ज़्यादातर प्रोजेक्ट के लिए 4 vCPU और 4 GB RAM काफ़ी हैं।

मिलते-जुलते टूल

b64

Base64 एन्कोडर/डिकोडर

टेक्स्ट और फ़ाइलें Base64 में और वापस, URL-safe विकल्प।

UUID जनरेटर

UUID v4 और समय के क्रम वाले v7, एक साथ कई।

*/5

Cron सहायक

crontab लाइन समझाता है और अगले रन दिखाता है।

Аa

लिप्यंतरण

सिरिलिक से लैटिन: पासपोर्ट मानक और URL slug।

सभी टूल →