วิธีตั้งค่า runner GitHub Actions แบบ self-hosted บน VPS

runner แบบ self-hosted ให้ CI ต้นทุนคงที่พร้อมแคชอุ่น ๆ — ไม่มีการคิดเงินต่อนาที ทูลเชนของคุณ เครื่องของคุณ นี่คือคู่มือตั้งค่าแบบกระชับที่สุด สำหรับเหตุผลว่าทำไม self-hosting ชนะนาทีที่ GitHub โฮสต์ และรายละเอียด job Docker ดู คู่มือฉบับเต็ม และ กรณีใช้งาน VPS สำหรับ GitHub Actions

1. สร้างผู้ใช้ที่ไม่ใช่ root (runner ปฏิเสธ root)

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

2. ดาวน์โหลด runner

ใน GitHub: Settings → Actions → Runners → New self-hosted runner → Linux ซึ่งให้คำสั่งดาวน์โหลดที่แน่นอนและโทเคนแบบใช้ครั้งเดียว จากนั้น:

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. ลงทะเบียนกับ repo ของคุณ

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

4. ติดตั้งเป็นเซอร์วิส (รอดจากการรีบูต)

อย่ารัน ./run.sh ในเทอร์มินัล — ติดตั้งมัน:

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

ตอนนี้ runner แสดงเป็น Idle ในอินเทอร์เฟซ GitHub และรับ job ที่พุ่งเป้ามาที่มัน

5. ใช้มันจาก workflow

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

Job Docker (ไม่บังคับ)

ติดตั้ง Docker ครั้งเดียว แล้ว workflow จะสร้างอิมเมจได้โดยแคชเลเยอร์คงอยู่ระหว่างการรัน:

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

ดู ติดตั้ง Docker บน VPS การกำหนดขนาด: Small ($8/เดือน) สบายสำหรับ CI ส่วนใหญ่; ขยับขึ้นสำหรับการคอมไพล์หนัก root ในราวหนึ่งนาที ไม่ต้อง KYC จ่ายด้วยคริปโต