เลือกใช้ Git server ตัวไหนดี: Forgejo, Gitea หรือ cgit
เปรียบเทียบ 4 วิธีติดตั้ง Git server บน VPS ตั้งแต่ bare repo ผ่าน SSH, cgit, Forgejo ไปจนถึง GitLab พร้อมวิเคราะห์การใช้ RAM เพื่อให้คุณเลือกใช้ได้เหมาะสมกับ VPS ขนาด 1 GB
คุณควรเลือกใช้ Git server แบบ self-hosted ตัวใด
Git server แบบ self-hosted ไม่ได้มีเพียงผลิตภัณฑ์เดียว และปริมาณ RAM (random access memory) บน VPS ของคุณจะเป็นตัวตัดสินว่าคุณสามารถใช้งานเวอร์ชันใดได้บ้าง Git ไม่จำเป็นต้องมี daemon ของตัวเอง: เพียงแค่ bare repository ร่วมกับบัญชี SSH (secure shell) ก็ถือเป็นเซิร์ฟเวอร์ที่ใช้งานได้แล้วบนเครื่องขนาดเล็กที่สุดที่คุณสามารถเช่าได้ ทุกสิ่งที่เหนือไปจากระดับนี้คือเว็บแอปพลิเคชันที่คุณเลือกจะรันควบคู่ไปกับมัน และการขยับขึ้นแต่ละระดับต้องใช้หน่วยความจำที่ VPS ขนาดเล็กอาจไม่มี หากคุณยังไม่แน่ใจว่า Git สิ้นสุดที่ตรงไหนและ GitHub เริ่มต้นที่ตรงไหน ความแตกต่างระหว่าง Git, GitHub และ Git server ของคุณเอง ได้อธิบายการแบ่งส่วนนี้ไว้ก่อนที่คุณจะเลือกใช้บริการในระดับต่างๆ
มีขั้นตอนอยู่ 4 ระดับ เริ่มจาก bare repository ผ่าน SSH โดยไม่มีบริการใดๆ ที่ไม่ได้ใช้งานอยู่แล้วมาคอยรับคำขอ ต่อมาคือ cgit ซึ่งเป็นเว็บสำหรับอ่านข้อมูลอย่างรวดเร็วโดยไม่มีฐานข้อมูล ตามด้วย Forgejo หรือ Gitea ซึ่งเป็นระบบ forge เต็มรูปแบบที่มีทั้งระบบบัญชีผู้ใช้, การจัดการ issue และ pull request โดยใช้หน่วยความจำเพียงไม่กี่ร้อยเมกะไบต์ และสุดท้ายคือ GitLab ซึ่งต้องการเซิร์ฟเวอร์ที่มีขนาดใหญ่กว่าตัวเลือกอื่นหลายเท่า
ให้ตัดสินใจจากงานที่คุณต้องทำ จากนั้นตรวจสอบตัวเลขหน่วยความจำเทียบกับแผนบริการที่คุณกำลังใช้งานอยู่
ปริมาณ RAM ที่แต่ละตัวเลือกต้องการจริง
มีเพียงสองโครงการเท่านั้นที่ระบุตัวเลขฮาร์ดแวร์ไว้ ให้ถือว่าตัวเลขที่ประกาศเป็นค่าขั้นต่ำไม่ใช่การรับประกัน และควรวัดค่าจากอินสแตนซ์ของคุณเองเมื่อรันงานแล้ว โดยใช้ systemd-cgtop หรือ ps -o rss= -C forgejo
ข้อมูลเบื้องหลังแผนภูมินี้
[
{
"label": "Gitea, small team",
"ram_gb": 1
},
{
"label": "GitLab, memory constrained",
"ram_gb": 8
},
{
"label": "GitLab, single node baseline",
"ram_gb": 16
}
]Gitea ระบุว่า RAM ขนาด 1 GB พร้อม CPU 2 คอร์ เพียงพอสำหรับการใช้งานทั่วไปในทีมขนาดเล็กและโปรเจกต์ต่างๆ และระบุว่า Raspberry Pi 3 ก็เพียงพอสำหรับภาระงานขนาดเล็ก GitLab ระบุว่า RAM ขนาด 16 GB เป็นค่าพื้นฐานสำหรับการติดตั้งแบบโหนดเดียว และ 8 GB เป็นค่าต่ำสุดสำหรับสิ่งที่หน้าเอกสารของ GitLab เรียกว่าสภาพแวดล้อมที่จำกัดหน่วยความจำ เอกสารการติดตั้งของ Forgejo ไม่ได้ระบุตัวเลข RAM ไว้ เนื่องจากเป็น fork ของ Gitea และมีพฤติกรรมการทำงานที่คล้ายกัน ตัวเลขของ Gitea จึงเป็นแนวทางที่ใกล้เคียงที่สุดที่คุณมี
นั่นหมายความว่าบน VPS ขนาด 1 GB: repository เปล่าและ cgit สามารถทำงานได้โดยเหลือพื้นที่ว่าง เพราะทั้งสองอย่างไม่ได้รันเป็น resident service ส่วน Forgejo หรือ Gitea จะสามารถเริ่มทำงานและให้บริการทีมขนาดเล็กบน SQLite ได้ แต่คุณกำลังใช้งานอยู่ที่ระดับขั้นต่ำสุดตามเอกสาร ดังนั้นควรปิด PostgreSQL และ CI (continuous integration) runner บนเครื่องนั้น หากหน้าเว็บหายไปโดยไม่มีข้อความแจ้งเตือน ให้รัน sudo dmesg -T | grep -Ei 'oom|out of memory|killed process' แล้วมองหาบรรทัดที่คล้ายกับ Out of memory: Killed process 1181 (forgejo) ซึ่งหมายความว่า kernel out of memory killer ได้สั่งยุติการทำงานของโปรเซสไปแล้ว สำหรับ GitLab บนเครื่องขนาด 1 GB นั้นไม่ใช่ปัญหาเรื่องการปรับแต่ง แต่มันไม่สามารถรันได้จริง
ระดับ 0: Bare repository ผ่าน SSH
Git ไม่มี network daemon ที่คุณต้องเริ่มทำงาน การใช้งาน git push ผ่าน SSH จะรัน git-receive-pack ที่ฝั่งปลายทางในฐานะกระบวนการ Unix ปกติ ดังนั้นบัญชีใดก็ตามที่คุณสามารถเข้าถึงได้ด้วย key จะกลายเป็น Git remote ทันที ให้สร้างบัญชีหนึ่งบัญชีสำหรับเก็บ repository และเก็บ repository เหล่านั้นไว้นอก home directory ของบัญชีดังกล่าว เพื่อให้ web view ที่อาจเพิ่มเข้ามาในภายหลังไม่จำเป็นต้องเข้าถึง home directory นั้น
sudo adduser --system --shell /bin/bash --gecos 'Git Version Control' \
--group --disabled-password --home /home/git git
sudo install -d -m 0755 -o git -g git /srv/git
sudo -u git git init --bare /srv/git/project.git--bare จะสร้าง repository ที่ไม่มี working copy ซึ่งเป็นสิ่งที่เซิร์ฟเวอร์ควรเก็บไว้ การ push ไปยัง branch ที่กำลังถูก checkout อยู่ใน repository ที่มี working copy จะถูกปฏิเสธโดยค่าเริ่มต้นด้วย refusing to update checked out branch: refs/heads/main และนั่นคือข้อผิดพลาดที่พบบ่อยที่สุดในระดับนี้
ตอนนี้ให้เพิ่ม key เข้าไปในบัญชีและทำการ clone
sudo -u git install -d -m 700 /home/git/.ssh
sudo -u git tee -a /home/git/.ssh/authorized_keys <<'EOF'
ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIexamplekeyhere alice@laptop
EOF
sudo -u git chmod 600 /home/git/.ssh/authorized_keysgit remote add origin git@vps.example.com:/srv/git/project.git
git push -u origin mainการ push ครั้งแรกที่สำเร็จจะจบลงด้วย * [new branch] main -> main หากจบลงด้วย git@vps.example.com: Permission denied (publickey) แสดงว่าไม่ผ่านการยืนยันตัวตน ให้ตรวจสอบ log ของเซิร์ฟเวอร์ด้วย sudo journalctl -u ssh -n 20 บรรทัดที่ระบุว่า Authentication refused: bad ownership or modes for file /home/git/.ssh/authorized_keys หมายความว่าความเป็นเจ้าของหรือโหมดของไฟล์ไม่ถูกต้อง เนื่องจาก sshd จะปฏิเสธไฟล์ key ที่มีเจ้าของไม่น่าเชื่อถือหรือมีการตั้งค่า permission ที่อนุญาตให้ผู้ใช้อื่นเขียนไฟล์ได้
หาก origin ของโปรเจกต์ชี้ไปที่ GitHub อยู่แล้ว git remote add origin จะหยุดทำงานพร้อมกับ error: remote origin already exists. และการ เพิ่มเซิร์ฟเวอร์นี้เป็น push URL ที่สองใน remote นั้น จะช่วยให้คุณสามารถ git push เพื่ออัปเดตทั้งสองที่ได้พร้อมกัน
จากนั้นให้ถอดสิทธิ์การเข้าถึง shell ออกจากบัญชีนั้น
command -v git-shell | sudo tee -a /etc/shells
sudo chsh -s "$(command -v git-shell)" gitgit-shell จะยอมรับเฉพาะคำสั่งไม่กี่คำสั่งที่ Git ส่งผ่าน SSH เท่านั้น ดังนั้นการล็อกอินแบบโต้ตอบจะหยุดทำงานพร้อมกับข้อความแจ้งเตือนแทนที่จะแสดง prompt:
fatal: Interactive git shell is not enabled.
hint: ~/git-shell-commands should exist and have read and execute access.นั่นคือทั้งหมดของเซิร์ฟเวอร์นี้ ไม่มีฐานข้อมูลและไม่มี web process ให้ต้องอัปเกรด สิ่งที่คุณต้องแลกคือฟีเจอร์ทั้งหมดที่ระบบ forge มีให้: ไม่มีการเรียกดูผ่านเว็บ, ไม่มีระบบติดตามปัญหา (issue tracker), ไม่มี pull request และไม่มีการกำหนดสิทธิ์แยกรายผู้ใช้ ทุก key ในไฟล์นั้นสามารถอ่านและเขียนทุก repository ที่ผู้ใช้ git เป็นเจ้าของได้
ระดับ 1: cgit ให้มุมมองเว็บโดยไม่ต้องใช้ฐานข้อมูล
cgit เป็นโปรแกรม CGI (common gateway interface) ที่เขียนด้วยภาษา C เว็บเซิร์ฟเวอร์จะเรียกใช้งานโปรแกรมนี้หนึ่งครั้งต่อหนึ่งคำขอ โดยโปรแกรมจะอ่านข้อมูล repository โดยตรงจากดิสก์และไม่มีการเก็บสถานะใดๆ ของตัวเอง Ubuntu 24.04 มีโปรแกรมนี้อยู่ในส่วนประกอบ universe
sudo apt update
sudo apt install -y cgit fcgiwrap nginx
sudo install -d -o www-data -g www-data /var/cache/cgitชี้ตำแหน่งไปยังไดเรกทอรี repository ใน /etc/cgitrc:
root-title=Git on example.com
css=/cgit.css
logo=/cgit.png
cache-size=1000
cache-root=/var/cache/cgit
snapshots=tar.gz zip
scan-path=/srv/gitscan-path จะสแกนไดเรกทอรีนั้นและแสดงรายการ repository ทั้งหมดที่พบ ดังนั้น repository แบบ bare ที่สร้างใหม่จะปรากฏขึ้นโดยไม่ต้องตั้งค่าเพิ่มเติม cache-size คือจำนวนหน้าเว็บที่แคชไว้ และการแคชจะถูกปิดใช้งานหากค่านี้เป็นศูนย์ โปรดอ่านสิ่งที่แพ็กเกจของคุณติดตั้งไว้แล้วใน /etc/cgitrc ก่อนที่จะเพิ่มบรรทัดใหม่ เนื่องจากแพ็กเกจของ Debian และ Ubuntu มีการตั้งค่าเริ่มต้นมาให้แล้ว
แต่ละรายการจะแสดงบรรทัดแรกของไฟล์ description ใน repository ดังนั้น repository แบบ bare ที่สร้างใหม่จะแสดงชื่อเป็น Unnamed repository; edit this file 'description' to name the repository. ให้แก้ไขปัญหานี้หนึ่งครั้งต่อหนึ่ง repository:
echo 'Project X, internal tooling' | sudo -u git tee /srv/git/project.git/descriptionไฟล์ไซต์ของ nginx และวิธีการตรวจสอบ
server {
listen 80;
server_name git.example.com;
root /usr/share/cgit;
try_files $uri @cgit;
location @cgit {
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME /usr/lib/cgit/cgit.cgi;
fastcgi_param PATH_INFO $uri;
fastcgi_param QUERY_STRING $args;
fastcgi_param HTTP_HOST $server_name;
fastcgi_pass unix:/run/fcgiwrap.socket;
}
}sudo systemctl enable --now fcgiwrap.socket
sudo nginx -t && sudo systemctl reload nginx
systemctl show fcgiwrap.socket -p Listenroot /usr/share/cgit จะให้บริการ cgit.css และ cgit.png ในรูปแบบไฟล์ธรรมดา และ try_files จะส่งคำขอส่วนที่เหลือไปยัง CGI ที่ /usr/lib/cgit/cgit.cgi หากพบหน้า 502 พร้อมข้อความ connect() to unix:/run/fcgiwrap.socket failed (2: No such file or directory) ใน /var/log/nginx/error.log แสดงว่า socket unit ไม่ได้ทำงานหรือกำลังฟังอยู่ที่ path อื่น บรรทัด systemctl show จะแสดง path ที่โปรแกรมใช้งานจริง
มีข้อจำกัดสองประการที่ควรทราบก่อนเริ่มใช้งาน cgit เป็นแบบอ่านอย่างเดียวและไม่มีระบบล็อกอินในการตั้งค่านี้ ดังนั้นทุกอย่างภายใต้ scan-path จะเป็นสาธารณะ: โปรดเก็บ repository ส่วนตัวไว้นอกไดเรกทอรีดังกล่าว หรือใช้ HTTP basic authentication ครอบหน้าเว็บไซต์ทั้งหมดไว้ และเนื่องจาก CGI ทำงานในฐานะผู้ใช้เว็บเซิร์ฟเวอร์ ผู้ใช้รายนั้นจึงจำเป็นต้องมีสิทธิ์เข้าถึง /srv/git และอ่านแต่ละ repository ได้ ไดเรกทอรีที่ผู้ใช้ไม่สามารถเข้าถึงได้จะแสดงเป็นดัชนีว่างเปล่าแทนที่จะแสดงข้อผิดพลาด
Tier 2: Forgejo หรือ Gitea สำหรับจัดการ Issues และ Pull Requests
Forgejo และ Gitea มีแนวคิดเดียวกัน คือเป็น Go binary ไฟล์เดียวที่ให้บริการเว็บสำหรับจัดการซอร์สโค้ด (web forge) ซึ่งรองรับผู้ใช้, องค์กร, issues, pull requests, releases, package registry และระบบ CI ในตัว การติดตั้งทำได้เพียงแค่ใช้ binary ร่วมกับ SQLite ซึ่งเป็นเหตุผลว่าทำไมซอฟต์แวร์เหล่านี้จึงทำงานบนฮาร์ดแวร์ที่ GitLab ไม่สามารถรองรับได้ ไฟล์ Compose ด้านล่างนี้เป็นไฟล์ที่ระบุไว้ในเอกสารประกอบของ Forgejo โดยใช้ image tag ณ วันที่ 24 ตุลาคม 2026
networks:
forgejo:
external: false
services:
server:
image: codeberg.org/forgejo/forgejo:17
container_name: forgejo
environment:
- USER_UID=1000
- USER_GID=1000
restart: always
networks:
- forgejo
volumes:
- ./forgejo:/data
- /etc/localtime:/etc/localtime:ro
ports:
- '3000:3000'
- '222:22'tag 17 ดังกล่าวเป็นไปตามสายการพัฒนา v17 โดย Forgejo v17.0.1 ซึ่งปล่อยออกมาเมื่อวันที่ 26 ตุลาคม 2026 เป็นรุ่นเสถียรในปัจจุบัน และ Forgejo จะให้การสนับสนุน v17 จนถึงวันที่ 28 มกราคม 2027 ส่วนสายการพัฒนา v16 รุ่นเก่าได้สิ้นสุดการสนับสนุนไปเมื่อวันที่ 29 ตุลาคม 2026 ดังนั้นการติดตั้งเดิมที่ยังใช้ tag 16 อยู่จึงถึงเวลาต้องอัปเกรดแล้ว การย้ายจากเวอร์ชันหลักหนึ่งไปยังเวอร์ชันถัดไปในภายหลังจำเป็นต้องทำด้วยตนเอง ดังนั้นการเริ่มต้นด้วยเวอร์ชันปัจจุบันจึงประหยัดเวลากว่า
docker compose up -d
docker compose ps
curl -sI http://127.0.0.1:3000 | head -1บรรทัด curl ควรแสดงสถานะ HTTP ก่อนที่คุณจะตั้งค่าการใช้งานครั้งแรกเสร็จสิ้น อาจมีการเปลี่ยนเส้นทาง (redirect) ไปยัง /install ซึ่งยังคงหมายความว่าบริการทำงานอยู่ หาก container หยุดทำงานแทน สาเหตุที่พบบ่อยคือเรื่องสิทธิ์การเข้าถึง (ownership): ไดเรกทอรี ./forgejo ต้องเป็นของ UID (user id) ที่ระบุใน USER_UID มิฉะนั้นกระบวนการทำงานจะไม่สามารถเขียนข้อมูลลงในไดเรกทอรีข้อมูลของตนเองได้ Docker Compose บน VPS ได้อธิบายโครงสร้างไฟล์และกฎการเป็นเจ้าของ volume ไว้อย่างละเอียด
คำตอบสองข้อในหน้าตั้งค่าจะเป็นตัวกำหนดว่า clone URL จะทำงานได้หรือไม่ พอร์ต SSH ต้องเป็นพอร์ตฝั่ง host ของการทำ mapping ซึ่งในไฟล์ Compose ด้านบนคือ 222 เนื่องจากมีการ map พอร์ต 222 ของ host ไปยังพอร์ต 22 ของ container ไม่มีความจำเป็นต้องใช้พอร์ต 222 โดยเฉพาะ คุณสามารถใช้พอร์ตใดก็ได้ที่ว่างอยู่ ตราบใดที่การตั้งค่า mapping และคำตอบนี้ตรงกัน และชื่อโดเมนต้องเป็นชื่อที่ผู้ใช้จะพิมพ์ใช้งานจริง หากตั้งค่าผิดพลาด หน้า repository ทุกหน้าจะแสดงคำสั่ง clone ที่ใช้งานไม่ได้สำหรับทุกคนที่คัดลอกไปใช้ ทั้งสองค่านี้จะอยู่ในส่วน [server] ของไฟล์ app.ini ในภายหลัง โดยระบุเป็น SSH_PORT, SSH_DOMAIN และ ROOT_URL
สำหรับการใช้งานแบบสาธารณะ ให้เปิดพอร์ตเว็บเฉพาะบน loopback address ('127.0.0.1:3000:3000') และใช้ nginx วางไว้ด้านหน้าเพื่อทำ TLS (transport layer security) การติดตั้ง Gitea ใช้วิธีเดียวกันจาก image docker.gitea.com/gitea ตามเอกสารประกอบ หรือติดตั้งเป็น binary ไฟล์เดียวพร้อม systemd unit หนึ่งรายการและไฟล์ app.ini หนึ่งไฟล์ รุ่นเสถียรปัจจุบันคือ v28.4.0 ซึ่งปล่อยออกมาเมื่อวันที่ 15 พฤศจิกายน 2026 โดยตั้งแต่รุ่น v28.0.0 ในช่วงปลายเดือนกันยายน โครงการได้ยกเลิกการใช้ prefix 1. แบบเดิม ดังนั้นรุ่นถัดจาก 1.27 จึงเป็น 28 ไม่ใช่ 1.28
ควรใช้ SQLite ต่อไปตราบเท่าที่ทำได้ เพราะจะช่วยให้ instance ทำงานเป็นกระบวนการเดียวและใช้ไฟล์เดียว และสามารถทำงานต่อได้หลังรีบูตโดยไม่ต้องมีบริการอื่นมาคอยดูแล PostgreSQL จะคุ้มค่าก็ต่อเมื่อมีผู้ใช้หลายคนเขียนข้อมูลพร้อมกัน เนื่องจาก SQLite จะจัดลำดับการเขียนข้อมูล และการรัน CI นานๆ จะมีการเขียนข้อมูลตลอดเวลา ทั้งสองโครงการสามารถย้าย instance ที่มีอยู่ไปยัง PostgreSQL ได้ในภายหลัง ดังนั้นนี่ไม่ใช่การตัดสินใจที่ถาวร
Forgejo หรือ Gitea: สิ่งที่แตกต่างกันจริงๆ
ทั้งสองโครงการมีรากฐานเดียวกัน Gitea แยกตัว (fork) มาจาก Gogs ในปี 2016 ในช่วงปลายปี 2022 การควบคุมโดเมนและเครื่องหมายการค้าของ Gitea ได้เปลี่ยนไปอยู่ภายใต้บริษัท Gitea Ltd และผู้ดูแลโครงการหลายคนได้ร่วมกับ Codeberg ก่อตั้ง Forgejo ขึ้นมา Forgejo ถูกพัฒนาโดยชุมชนภายใต้การดูแลของ Codeberg e.V. ซึ่งเป็นสมาคมไม่แสวงหาผลกำไรที่จดทะเบียนในเยอรมนีและเป็นผู้ถือครองโดเมนของโครงการ ในขณะที่การบริหารจัดการยังคงอยู่กับผู้มีส่วนร่วมของ Forgejo เอง โครงการได้เปลี่ยนจากสัญญาอนุญาต MIT มาเป็น GPLv3 (GNU general public license version 3) ในปี 2024 ส่วน Gitea ยังคงใช้สัญญาอนุญาต MIT และพัฒนาโดยมีบริษัทเชิงพาณิชย์ให้การสนับสนุน
ในแง่การใช้งานประจำวัน ชุดฟีเจอร์มีความใกล้เคียงกันมาก แต่เส้นทางการย้ายข้อมูลระหว่างกันนั้นทำได้ยาก Forgejo v10.0 จากเดือนมกราคม 2025 เป็นรุ่นสุดท้ายที่สามารถนำเข้าฐานข้อมูลจาก Gitea ได้โดยตรง และรองรับเฉพาะ Gitea v1.22 หรือเก่ากว่าเท่านั้น ปัจจุบัน Gitea อยู่ที่รุ่น v28.4.0 ณ วันที่ 16 พฤศจิกายน 2026 ดังนั้น instance ของ Gitea ในปัจจุบันจึงไม่มีวิธีการสลับไปใช้ Forgejo แบบ in-place ที่รองรับอย่างเป็นทางการ คุณควรเลือกตัวใดตัวหนึ่งก่อนที่จะเริ่มเก็บข้อมูล และหากต้องการย้ายในภายหลัง ให้ถือว่าเป็นการส่งออก (export) และนำเข้าใหม่ (re-import)
กฎสั้นๆ ในการตัดสินใจเลือก: หากธรรมาภิบาลมีความสำคัญต่อคุณ หรือคุณต้องการโครงการที่อยู่ภายใต้สมาคมไม่แสวงหาผลกำไร ให้เลือกใช้ Forgejo หากคุณต้องการฐานผู้ใช้งานที่ใหญ่กว่าและตัวเลือกการสนับสนุนเชิงพาณิชย์ ให้เลือกใช้ Gitea ทั้งสองโครงการมีการพัฒนาแบบเปิดและปล่อยรุ่นใหม่อยู่เสมอ Forgejo ปล่อยรุ่นเสถียรทุกสามเดือนและรุ่น LTS (long term support) ทุกปี โดยมี v17.0.1 เป็นรุ่นปัจจุบันและ v15.0.11 เป็นรุ่น LTS ณ วันที่ 29 ตุลาคม 2026 Forgejo สนับสนุน v17 จนถึงวันที่ 28 มกราคม 2027 และ v15 จนถึงวันที่ 15 กรกฎาคม 2027 ในขณะที่การสนับสนุน v16 สิ้นสุดลงเมื่อวันที่ 29 ตุลาคม 2026 ดังนั้นควรตรวจสอบหน้า releases ก่อนที่จะกำหนดเวอร์ชันหลัก หากกฎเหล่านี้ยังไม่ช่วยให้ตัดสินใจได้ การเปรียบเทียบฉบับเต็มระหว่าง Forgejo และ Gitea จะอธิบายความแตกต่างของระบบ Actions และ package registries ซึ่งเป็นรายละเอียดที่ควรพิจารณาก่อนที่ข้อมูลของคุณจะทำให้การเปลี่ยนระบบในภายหลังเป็นเรื่องยุ่งยาก
ระดับ 3: ต้นทุนของ GitLab ก่อนเริ่มใช้งานจริง
GitLab CE เป็นซอฟต์แวร์อีกระดับหนึ่ง อินสแตนซ์หนึ่งชุดประกอบด้วยบริการที่ทำงานร่วมกันหลายตัว ได้แก่ Puma สำหรับเว็บแอปพลิเคชัน, Sidekiq สำหรับงานเบื้องหลัง, PostgreSQL, Redis, Gitaly สำหรับการเข้าถึง repository และ nginx ที่ทำหน้าที่เป็นหน้าด่าน แพ็กเกจ Omnibus จะติดตั้งบริการเหล่านี้รวมกัน ซึ่งทำให้การติดตั้งทำได้ง่าย แต่ก็ทำให้ความต้องการหน่วยความจำขั้นต่ำสูงตามไปด้วย
หน้าเอกสารความต้องการของ GitLab ระบุว่า RAM 16 GB และ 8 vCPU คือค่าพื้นฐานสำหรับการติดตั้งบนโหนดเดียว โดยระบุว่า 8 GB คือระดับต่ำสุดสำหรับสภาพแวดล้อมที่มีข้อจำกัดด้านหน่วยความจำ หน้าเดียวกันนี้ยังแนะนำให้ปิดการใช้งาน swap เพราะการทำ swapping ขณะที่ระบบมีโหลดสูงจะทำให้อินสแตนซ์ทำงานได้แย่ลงอย่างมาก ตัวเลขเหล่านี้เป็นข้อมูลที่เผยแพร่อย่างเป็นทางการ ณ เดือนตุลาคม 2026 และมีแนวโน้มเพิ่มสูงขึ้นตลอดหลายปีที่ผ่านมา ดังนั้นควรตรวจสอบหน้านี้อีกครั้งก่อนตัดสินใจเลือกขนาดเซิร์ฟเวอร์
คุณจะได้รับฟีเจอร์จริงเพื่อแลกกับทรัพยากรที่เสียไป เช่น container registry, package registry, การกำหนดสิทธิ์ที่ละเอียด และ CI ที่ผ่านการทดสอบในระดับสเกลใหญ่ ส่วนศูนย์กลางการปฏิบัติตามข้อกำหนด (compliance center) และการตรวจสอบย้อนหลัง (audit trails) ของโปรเจกต์หรือกลุ่มนั้นจำเป็นต้องใช้ GitLab รุ่นที่ต้องชำระเงิน หากไม่มีใครในทีมของคุณระบุได้ว่าต้องการฟีเจอร์ใดจากรายการเหล่านี้ในไตรมาสนี้ แสดงว่าคุณกำลังจ่ายเงินค่า VPS ขนาดใหญ่ขึ้นโดยไม่ได้รับประโยชน์ใดๆ กลับมาเลย
รูปแบบการเข้าถึงผ่าน SSH: ผู้ใช้ git หนึ่งบัญชีกับกุญแจหลายดอก
ในระบบ OpenSSH ทุกระดับชั้นจะใช้วิธีการยืนยันตัวตนแบบเดียวกัน โดยมีบัญชีผู้ใช้ Unix หนึ่งบัญชีชื่อ git และกุญแจสาธารณะทั้งหมดจะถูกเก็บไว้ใน ~/.ssh/authorized_keys ของบัญชีนั้น การยืนยันตัวตนจะขึ้นอยู่กับกุญแจ ส่วนการอนุญาตสิทธิ์จะขึ้นอยู่กับตัวเลือกที่คุณระบุไว้หน้ากุญแจในบรรทัดเดียวกัน
บรรทัดกุญแจแบบปกติจะมอบสิทธิ์ทั้งหมดที่บัญชีนั้นทำได้ให้กับผู้ถือครองกุญแจ สำหรับบัญชีที่ยังคงใช้ /bin/bash เป็น login shell การใช้ forced command จะช่วยจำกัดสิทธิ์ให้เหลือเพียงการใช้งาน Git เท่านั้น:
restrict,command="git-shell -c \"$SSH_ORIGINAL_COMMAND\"" ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIexamplekeyhere alice@laptoprestrict ซึ่งมีให้ใช้งานตั้งแต่ OpenSSH 7.2 เป็นต้นไป จะทำหน้าที่ปิดการใช้งาน port forwarding, agent forwarding, X11 และการจัดสรร PTY (pseudo terminal) ได้ในคำสั่งเดียว ส่วน command= จะเข้ามาแทนที่คำสั่งที่ไคลเอนต์ร้องขอด้วยคำสั่งที่คุณระบุ ซึ่ง Git ยังคงทำงานได้ตามปกติเนื่องจาก SSH server จะนำคำสั่งเดิมของไคลเอนต์ไปเก็บไว้ใน $SSH_ORIGINAL_COMMAND
ซอฟต์แวร์ประเภท forge จะเขียนไฟล์ดังกล่าวให้คุณโดยอัตโนมัติ และนั่นคือความแตกต่างที่แท้จริงระหว่างระดับ 0 และระดับ 2 เมื่อ Forgejo และ Gitea ทำงานอยู่เบื้องหลังระบบ OpenSSH ซึ่งเป็นค่าเริ่มต้น ทั้งสองจะเขียนไฟล์ authorized_keys ใหม่โดยให้มีหนึ่งบรรทัดต่อหนึ่งกุญแจที่ลงทะเบียนไว้ โดยแต่ละบรรทัดจะมี forced command ที่ระบุชื่อกุญแจตาม ID ในฐานข้อมูล:
command="/usr/local/bin/forgejo --config=/etc/forgejo/app.ini serv key-3",no-port-forwarding,no-X11-forwarding,no-agent-forwarding,no-pty,no-user-rc,restrict ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIexamplekeyhere aliceforced command ดังกล่าวคือวิธีที่ทำให้บัญชี Unix บัญชีเดียวที่ใช้ร่วมกันสามารถแยกสิทธิ์รายบุคคลได้ โดย key-3 จะแจ้งให้ forge ทราบว่าผู้ใช้คนใดกำลังเชื่อมต่อเข้ามา และระบบจะตรวจสอบสิทธิ์ของผู้ใช้นั้นกับ repository ก่อนที่จะมีการรับส่งข้อมูลใดๆ ห้ามแก้ไขไฟล์ดังกล่าวด้วยตนเองบนเครื่องที่จัดการโดย forge เพราะไฟล์จะถูกเขียนทับจากฐานข้อมูลและบรรทัดที่คุณเพิ่มเข้าไปจะหายไป หากคุณเปิดใช้งาน SSH server ในตัวของ forge หรือตั้งค่าให้ OpenSSH สอบถามกุญแจจาก forge ผ่าน AuthorizedKeysCommand ทาง forge ก็ไม่จำเป็นต้องใช้ไฟล์นั้นอีกต่อไป และทั้งสองโปรเจกต์แนะนำให้คุณปิดการสร้างไฟล์ดังกล่าวในกรณีหลัง ส่วน deploy keys ก็ใช้กลไกเดียวกัน คือเป็นกุญแจ SSH ปกติที่ลงทะเบียนไว้กับ repository เดียว โดยปกติจะเป็นแบบอ่านอย่างเดียว และการตรวจสอบสิทธิ์จะทำในระดับ forge แทนที่จะเป็น sshd
มีสองนิสัยที่สำคัญยิ่งกว่าการตั้งค่าทั้งหมดข้างต้น คือการออกกุญแจหนึ่งดอกต่อหนึ่งคนหรือหนึ่งเครื่อง ห้ามใช้กุญแจร่วมกันเด็ดขาด เพราะการเพิกถอนกุญแจที่ใช้ร่วมกันหมายถึงคุณต้องเปลี่ยนกุญแจใหม่ให้กับทุกคนพร้อมกัน และต้องลบกุญแจออกทันทีในวันที่พนักงานลาออก เนื่องจากกุญแจเก่าที่ค้างอยู่ในไฟล์นั้นคือช่องทางเข้าสู่ระบบถาวรที่ไม่มีใครคอยตรวจสอบ การจัดการกุญแจ SSH บนเซิร์ฟเวอร์อย่างมีประสิทธิภาพ ครอบคลุมถึงประเภทของกุญแจและรหัสผ่าน ซึ่งทั้งหมดสามารถนำมาประยุกต์ใช้ได้โดยไม่มีการเปลี่ยนแปลง หากเซิร์ฟเวอร์เป็นเครื่องใหม่ สิบนาทีแรกบน VPS ใหม่ คือสิ่งที่คุณควรทำก่อนที่จะนำ repository ไปวางไว้บนนั้น
ฉันสามารถรัน GitHub Actions บนเซิร์ฟเวอร์ Git ของตัวเองได้หรือไม่
คุณสามารถรันเวิร์กโฟลว์ที่เขียนด้วยไวยากรณ์ของ GitHub Actions ได้ แต่คุณไม่สามารถรัน GitHub ได้ โดย Forgejo Actions ได้ถูกเปิดใช้งานเป็นค่าเริ่มต้นตั้งแต่ Forgejo v1.21 เป็นต้นมา ซึ่งจะอ่านไฟล์เวิร์กโฟลว์จาก .forgejo/workflows ในแต่ละรีโพสิทอรี ส่วน Gitea Actions ทำงานในลักษณะเดียวกันและอ่านจาก .gitea/workflows ทั้งสองระบบจำเป็นต้องมีโปรแกรมตัวที่สองที่เรียกว่า runner ซึ่งต้องติดตั้งและลงทะเบียนกับอินสแตนซ์ของคุณโดยใช้โทเค็นจากการตั้งค่าผู้ดูแลระบบ โดย action ที่เผยแพร่ไว้จำนวนมากสามารถนำมาใช้งานได้ทันทีโดยไม่ต้องแก้ไข
จงวางแผนรับมือกับผลกระทบสองประการ ประการแรก ด้วย label ของคอนเทนเนอร์ทั่วไป ตัว runner จะเริ่มคอนเทนเนอร์สำหรับทุกงาน ดังนั้นจึงจำเป็นต้องมี container engine และจัดสรรหน่วยความจำแยกต่างหาก ซึ่งเป็นเหตุผลว่าทำไมจึงไม่ควรติดตั้งบนเครื่องขนาด 1 GB เครื่องเดียวกับที่รัน forge ประการที่สอง runner ทั้งสองแบบสามารถรันงานบนโฮสต์โดยตรงได้ผ่าน label ที่ลงท้ายด้วย :host ใน Forgejo ซึ่งไม่จำเป็นต้องใช้ engine แต่ก็ไม่มีคอนเทนเนอร์คั่นกลางระหว่างงานกับเครื่องนั้น นอกจากนี้ runner จะดำเนินการตามที่ไฟล์เวิร์กโฟลว์ระบุไว้ทุกประการ ซึ่งเอกสารของ Forgejo ได้ระบุไว้อย่างชัดเจนว่า runner จะทำการรันโค้ดจากระยะไกล (remote code execution) ดังนั้นควรแยกโฮสต์ให้ runner หากทำได้ หรืออย่างน้อยที่สุดควรใช้ผู้ใช้ที่ไม่มีสิทธิ์พิเศษ (unprivileged user) และใช้โทเค็นการลงทะเบียนที่จำกัดขอบเขตไว้เพียงรีโพสิทอรีเดียว
หากรีโพสิทอรีของคุณยังคงอยู่บน GitHub และคุณต้องการเพียงแค่ใช้ทรัพยากรประมวลผลบนฮาร์ดแวร์ที่คุณควบคุมเอง นั่นจะเป็นการตั้งค่าที่แตกต่างออกไปและมีขั้นตอนที่ต่างกัน: การใช้ self-hosted GitHub Actions runner จะเชื่อมต่อกับรีโพสิทอรีบน GitHub และไม่จำเป็นต้องใช้ขั้นตอนเหล่านี้ หากคุณยังคงพิจารณาถึงต้นทุนในการย้ายออก สิ่งที่ GitHub มอบให้คุณจริงๆ จะช่วยแยกแยะระหว่างการโฮสต์ Git กับเครือข่ายที่เกี่ยวข้องออกให้เห็นชัดเจน
การสำรองข้อมูล: repository เป็นเพียงสถานะครึ่งหนึ่งเท่านั้น
Bare repository คือไดเรกทอรี ดังนั้นการคัดลอกจึงเป็นการคัดลอกทุกอย่างที่อยู่ภายใน การทำ mirror clone จากเครื่องอื่นถือเป็นการสำรองข้อมูลที่แท้จริง และสามารถอัปเดตข้อมูลในที่เดิมได้:
git clone --mirror git@vps.example.com:/srv/git/project.git
cd project.git && git remote updateคำสั่งนี้จะดึงทุก ref และทุก object มา แต่จะไม่ดึง server-side hooks หรือไฟล์ description มาด้วย ดังนั้นหากคุณมีการใช้ hooks ให้คัดลอกไดเรกทอรีในระดับไฟล์เก็บไว้ด้วย
แพลตฟอร์ม forge จะเก็บข้อมูล issues, pull requests, ผู้ใช้งาน, keys และสิทธิ์ต่างๆ ไว้ในฐานข้อมูล การคัดลอกเฉพาะ repository จะทำให้ข้อมูลเหล่านี้สูญหายไปทั้งหมด ทั้งสองโปรเจกต์มีคำสั่ง dump สำหรับเขียนฐานข้อมูล, repository, การตั้งค่า และไฟล์แนบลงในไฟล์ archive เดียวกัน:
sudo -u git forgejo dump -c /etc/forgejo/app.ini -f /var/backups/forgejo-dump.zipหากใช้งานผ่าน Docker ให้รันคำสั่งเดียวกันนี้ภายใน container โดย path ของการตั้งค่าจะขึ้นอยู่กับ image ที่ใช้ ดังนั้นควรตรวจสอบให้แน่ใจก่อนพิมพ์คำสั่ง:
docker compose exec server ls /data/gitea/conf
docker compose exec -u git server forgejo dump -c /data/gitea/conf/app.iniให้รันคำสั่งด้วยผู้ใช้งานที่เป็นเจ้าของข้อมูล และเขียนไฟล์ archive ลงในไดเรกทอรีที่ผู้ใช้งานนั้นมีสิทธิ์เขียน จากนั้นให้คัดลอกไฟล์ archive ออกจากเซิร์ฟเวอร์ เพราะการสำรองข้อมูลที่เก็บไว้บนเครื่องที่ถูกสำรองข้อมูลเพียงอย่างเดียว ไม่ถือว่าเป็นการสำรองข้อมูลที่สมบูรณ์ ขั้นตอนการกู้คืนคือสิ่งที่คนมักมองข้าม: ให้ลองแตกไฟล์ dump ลงบนเครื่องสำรองตั้งแต่วันนี้ เพื่อให้คุณเรียนรู้วิธีการในเวลาปกติ แทนที่จะต้องมาเรียนรู้ในขณะที่ระบบเกิดปัญหาใช้งานไม่ได้
เลือกตามสถานการณ์
สำหรับผู้ใช้คนเดียวที่มีแล็ปท็อปและ VPS โดยไม่จำเป็นต้องเรียกดูผ่านเบราว์เซอร์: ให้ใช้ bare repositories ผ่าน SSH วิธีนี้ไม่มีบริการส่วนเกินให้รันและไม่มีสิ่งที่ต้องอัปเดต
กรณีเดียวกันแต่ต้องการอ่านโค้ดผ่านเบราว์เซอร์และส่งลิงก์ได้: ให้เพิ่ม cgit เข้าไป วิธีนี้ยังคงไม่ต้องใช้ฐานข้อมูลและไม่มีบริการที่ต้องรันค้างไว้ในหน่วยความจำ
สำหรับทีมที่ต้องการรีวิวโค้ดและติดตามปัญหา: ให้ใช้ Forgejo หรือ Gitea โดยต้องมี RAM 2 GB ขึ้นไป เมื่อปริมาณงานเพิ่มขึ้นจนถึงระดับใช้งานจริง ให้ย้าย CI runner ไปไว้ที่เครื่องที่สอง
สำหรับองค์กรที่ต้องการ container registry และระบบตรวจสอบย้อนกลับ (audit trails) โดยมีงบประมาณ RAM สำหรับเซิร์ฟเวอร์ 16 GB: ให้ใช้ GitLab หากมีทรัพยากรน้อยกว่านี้ ไม่แนะนำให้เริ่มใช้งาน
การขยับขยายจากสามระดับแรกทำได้ง่ายและประหยัด เนื่องจากทั้งสามระดับใช้ Git repositories แบบปกติที่จัดเก็บอยู่บนดิสก์ ให้เริ่มต้นจากระดับต่ำสุดที่ตอบโจทย์การใช้งานของคุณ หากคุณกำลังพิจารณาว่ามีบริการอื่นใดที่ควรติดตั้งบนเซิร์ฟเวอร์เดียวกัน รายการบริการที่คุ้มค่าแก่การ self-host จะช่วยเปรียบเทียบ Git server กับบริการอื่นๆ ที่ต้องใช้ RAM ร่วมกันในเซิร์ฟเวอร์ของคุณ
FAQ
VPS ขนาด 1 GB สามารถรัน Forgejo หรือ Gitea ได้หรือไม่?
ได้ สำหรับทีมขนาดเล็กที่ใช้ SQLite และไม่มีบริการอื่นที่กินทรัพยากรสูงรันอยู่บนเครื่องเดียวกัน เอกสารของ Gitea ระบุว่า RAM ขนาด 1 GB และ CPU 2 คอร์เพียงพอสำหรับทีมและโปรเจกต์ขนาดเล็ก ส่วน Forgejo เป็น fork ของ Gitea ซึ่งมีลักษณะการทำงานที่เหมือนกัน ห้ามติดตั้ง PostgreSQL หรือ CI runner เพิ่มบนเครื่องดังกล่าว หากบริการหายไปโดยไม่มีข้อความผิดพลาดใน log ของตัวเอง ให้รันคำสั่ง sudo dmesg -T | grep -Ei 'oom|out of memory|killed process' หากพบชื่อ process ที่ถูกสั่ง kill แสดงว่า kernel out of memory killer เป็นผู้จัดการ process นั้น วิธีแก้คือการขยายขนาดแผนบริการ (plan) ไม่ใช่การปรับแต่ง flag
Forgejo และ Gitea แตกต่างกันอย่างไร?
ทั้งสองมีประวัติ codebase และฟีเจอร์ส่วนใหญ่ร่วมกัน Gitea fork มาจาก Gogs ในปี 2016 และ Forgejo fork มาจาก Gitea ในช่วงปลายปี 2022 หลังจากสิทธิ์ในการควบคุมเครื่องหมายการค้า Gitea ถูกโอนไปยังบริษัทแห่งหนึ่ง Forgejo พัฒนาโดยชุมชนภายใต้การดูแลของ Codeberg e.V. ซึ่งเป็นองค์กรไม่แสวงหาผลกำไรในประเทศเยอรมนี และเผยแพร่ภายใต้สัญญาอนุญาต GPLv3 ส่วน Gitea ยังคงใช้สัญญาอนุญาต MIT และได้รับการสนับสนุนเชิงพาณิชย์ ความแตกต่างในทางปฏิบัติคือเส้นทางการย้ายข้อมูล Forgejo v10.0 ซึ่งออกเมื่อเดือนมกราคม 2025 เป็นรุ่นสุดท้ายที่สามารถนำฐานข้อมูลของ Gitea มาใช้ได้โดยตรง และรองรับเฉพาะ Gitea v1.22 หรือเก่ากว่าเท่านั้น ดังนั้น instance ของ Gitea ในปัจจุบันจึงไม่มีวิธีการสลับมาใช้ Forgejo แบบ in-place ที่รองรับอย่างเป็นทางการ
ฉันสามารถรัน GitHub Actions workflows บนเซิร์ฟเวอร์ Git ที่โฮสต์เองได้หรือไม่?
ทั้ง Forgejo Actions และ Gitea Actions สามารถรัน workflow ที่เขียนด้วยไวยากรณ์ YAML ของ GitHub Actions ซึ่งอ่านจาก .forgejo/workflows และ .gitea/workflows คุณต้องติดตั้งโปรแกรม runner แยกต่างหากและลงทะเบียนเข้ากับ instance ของคุณ โดย action ที่เผยแพร่ทั่วไปจำนวนมากสามารถทำงานได้โดยไม่ต้องแก้ไข ตัว runner จะรันโค้ดตามอำเภอใจจาก repository ของคุณ และจะเริ่ม container ต่อหนึ่งงานตาม label ที่กำหนด ดังนั้นควรแยกเครื่องโฮสต์สำหรับ runner หรืออย่างน้อยต้องรันด้วยผู้ใช้ที่ไม่มีสิทธิ์ (unprivileged user) และไม่ควรติดตั้งบนเซิร์ฟเวอร์ขนาด 1 GB ที่รันตัว forge อยู่แล้ว
ฉันจะสำรองข้อมูลเซิร์ฟเวอร์ Git ที่โฮสต์เองได้อย่างไร?
สำหรับ bare repositories การใช้ git clone --mirror จากเครื่องอื่นจะคัดลอกทุก ref และ object ไปยังเครื่องปลายทาง และการใช้ git remote update ภายใน mirror นั้นจะเป็นการอัปเดตข้อมูลให้เป็นปัจจุบัน สำหรับ Forgejo หรือ Gitea ข้อมูล repository เป็นเพียงส่วนหนึ่งของสถานะระบบเท่านั้น เนื่องจาก issue, pull request, ผู้ใช้ และ key ต่างๆ ถูกเก็บไว้ในฐานข้อมูล ให้ใช้คำสั่ง dump ที่มีมาให้ในตัวคือ sudo -u git forgejo dump -c /etc/forgejo/app.ini หรือใช้คำสั่งเดียวกันภายใน container สำหรับการติดตั้งแบบ Docker จากนั้นให้คัดลอกไฟล์ archive ออกจากเซิร์ฟเวอร์ และทดลองกู้คืนลงในเครื่องสำรองอย่างน้อยหนึ่งครั้งเพื่อให้มั่นใจว่าขั้นตอนการทำงานถูกต้อง