Git server tự host: Forgejo, Gitea hay cgit
So sánh 4 cách chạy Git server tự host theo RAM: bare repo qua SSH, cgit, Forgejo hoặc Gitea và GitLab. VPS 1 GB chạy được lựa chọn nào?
Bạn nên chạy Git server tự host nào
Một Git server tự host không phải là một sản phẩm duy nhất, và dung lượng RAM (random access memory) trên VPS của bạn sẽ quyết định phiên bản nào bạn có thể chạy. Git không cần daemon riêng: một bare repository cộng với tài khoản SSH (secure shell) đã là một server hoạt động tốt trên máy chủ nhỏ nhất mà bạn có thể thuê. Mọi thứ nằm trên mức đó là một ứng dụng web mà bạn chọn chạy kèm, và mỗi bước nâng cấp đều tiêu tốn bộ nhớ mà một VPS nhỏ có thể không đáp ứng được. Nếu bạn vẫn chưa rõ Git kết thúc ở đâu và GitHub bắt đầu từ đâu, sự khác biệt giữa Git, GitHub và Git server của riêng bạn sẽ làm rõ ranh giới đó trước khi bạn chọn cấp độ phù hợp.
Có bốn bước. Một bare repository qua SSH, không cần thêm bất kỳ tiến trình nào lắng nghe ngoài những gì đã có sẵn. cgit, một giao diện web đọc-chỉ nhanh chóng không cần database. Forgejo hoặc Gitea, một nền tảng quản lý đầy đủ với tài khoản, issues và pull requests trong vài trăm megabyte. GitLab, yêu cầu một server có dung lượng lớn hơn nhiều lần so với các lựa chọn còn lại.
Hãy quyết định dựa trên công việc bạn cần thực hiện, sau đó đối chiếu con số bộ nhớ với gói dịch vụ bạn đang trả phí.
Mỗi lựa chọn thực sự cần bao nhiêu RAM
Chỉ có 2 project trong số này công bố thông số phần cứng. Hãy xem thông số đã công bố là mức tối thiểu, không phải cam kết, và đo instance của bạn sau khi chạy bằng systemd-cgtop hoặc ps -o rss= -C forgejo.
Dữ liệu đằng sau biểu đồ này
[
{
"label": "Gitea, small team",
"ram_gb": 1
},
{
"label": "GitLab, memory constrained",
"ram_gb": 8
},
{
"label": "GitLab, single node baseline",
"ram_gb": 16
}
]Gitea ghi rõ 1 GB RAM cùng 2 CPU core thường là đủ cho các team và project nhỏ, đồng thời cho biết Raspberry Pi 3 đủ cho workload nhỏ. GitLab ghi rõ 16 GB là mức cơ bản cho một installation single-node, và 8 GB là mức thấp nhất cho môi trường bị giới hạn bộ nhớ, theo cách gọi trên chính trang của họ. Tài liệu installation của Forgejo không nêu thông số RAM. Forgejo là fork của Gitea và hoạt động tương tự, nên thông số của Gitea là hướng dẫn đã công bố gần nhất mà bạn có.
Điều đó có nghĩa là trên VPS 1 GB: bare repository và cgit vẫn chạy được, còn dư tài nguyên, vì không thành phần nào chạy như một service thường trú. Forgejo hoặc Gitea sẽ khởi động và phục vụ một team nhỏ trên SQLite, nhưng bạn đang ở đúng mức tối thiểu được tài liệu nêu, nên không chạy PostgreSQL và CI (continuous integration) runner trên máy đó. Nếu web interface biến mất mà không có lỗi, hãy chạy sudo dmesg -T | grep -Ei 'oom|out of memory|killed process' và tìm dòng tương tự Out of memory: Killed process 1181 (forgejo). Dòng này có nghĩa là OOM killer của kernel đã dừng nó. GitLab trên máy 1 GB không phải vấn đề tuning. Nó sẽ không chạy.
Tier 0: kho lưu trữ bare qua SSH
Git không có network daemon nào cần khởi động. git push qua SSH chạy git-receive-pack ở đầu bên kia như một tiến trình Unix thông thường, nên mọi account mà bạn có thể truy cập bằng key đều đã là một Git remote. Tạo một account riêng cho các repository và đặt các repository bên ngoài thư mục home của account đó, để sau này thêm web view không cần truy cập thư mục home này.
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 tạo một repository không có working copy, đúng với loại repository mà server lưu giữ. Theo mặc định, việc push vào branch đã checkout của một repository có working copy sẽ bị từ chối với refusing to update checked out branch: refs/heads/main. Đây là lỗi phổ biến nhất ở tier này.
Bây giờ cấp cho account một key rồi clone repository đó.
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 mainMột lần push đầu tiên thành công sẽ kết thúc bằng * [new branch] main -> main. Nếu kết thúc bằng git@vps.example.com: Permission denied (publickey) thì quá trình xác thực chưa bao giờ thành công, vì vậy hãy đọc server log bằng sudo journalctl -u ssh -n 20. Dòng có nội dung Authentication refused: bad ownership or modes for file /home/git/.ssh/authorized_keys cho biết ownership hoặc file mode bị sai, vì sshd từ chối key file có owner không đáng tin cậy hoặc có permission cho phép user khác ghi vào.
Nếu origin của project đã trỏ đến GitHub, git remote add origin sẽ dừng với error: remote origin already exists.. Thêm server này làm push URL thứ hai trên remote đó sẽ cho phép một git push cập nhật cả hai nơi.
Sau đó, loại bỏ quyền shell của account.
command -v git-shell | sudo tee -a /etc/shells
sudo chsh -s "$(command -v git-shell)" gitgit-shell chỉ chấp nhận một vài command mà Git gửi qua SSH, nên lần đăng nhập tương tác tiếp theo sẽ dừng với một thông báo thay vì prompt:
fatal: Interactive git shell is not enabled.
hint: ~/git-shell-commands should exist and have read and execute access.Đó là toàn bộ server. Không có database và cũng không có web process nào cần upgrade. Đổi lại, bạn không có những tính năng mà một forge cung cấp: không có giao diện duyệt repository, issue tracker, pull request hay permission riêng cho từng user. Mọi key trong file đó đều có thể đọc và ghi mọi repository mà user git sở hữu.
Tầng 1: cgit cung cấp giao diện web mà không cần database
cgit là một chương trình CGI (common gateway interface) được viết bằng C. Web server chạy chương trình này một lần cho mỗi request. cgit đọc trực tiếp các repository từ disk và không tự lưu state. Ubuntu 24.04 có sẵn cgit trong component universe.
sudo apt update
sudo apt install -y cgit fcgiwrap nginx
sudo install -d -o www-data -g www-data /var/cache/cgitTrỏ cgit vào thư mục repository trong /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 duyệt thư mục đó và liệt kê mọi repository tìm thấy, nên bare repo mới sẽ xuất hiện mà không cần cấu hình thêm. cache-size là số lượng page được cache; cache vẫn tắt khi giá trị này bằng 0. Hãy đọc nội dung package đã ghi sẵn vào /etc/cgitrc trước khi thêm các dòng mới, vì package Debian và Ubuntu đã có một số thiết lập mặc định riêng.
Mỗi entry hiển thị dòng đầu tiên trong file description của repository, nên bare repo mới sẽ tự hiển thị là Unnamed repository; edit this file 'description' to name the repository.. Sửa một lần cho từng repository:
echo 'Project X, internal tooling' | sudo -u git tee /srv/git/project.git/descriptionFile site của nginx và cách kiểm tra
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 phục vụ cgit.css và cgit.png dưới dạng file thuần, còn try_files chuyển mọi request khác đến CGI tại /usr/lib/cgit/cgit.cgi. Nếu xuất hiện page 502, trong đó có connect() to unix:/run/fcgiwrap.socket failed (2: No such file or directory) tại /var/log/nginx/error.log, nghĩa là socket unit chưa chạy hoặc đang listen tại path khác. Dòng systemctl show in ra path mà nó thực sự sử dụng.
Có 2 giới hạn bạn nên biết trước khi xây dựng dựa trên cgit. cgit chỉ cho đọc và không có chức năng đăng nhập trong cấu hình này, nên mọi thứ bên dưới scan-path đều public: hãy để repository private bên ngoài thư mục đó, hoặc đặt HTTP basic authentication trước toàn bộ site. CGI chạy dưới user của web server, nên user đó phải traverse được /srv/git và đọc được từng repository. Nếu user không thể đi vào một thư mục, thư mục đó sẽ hiển thị dưới dạng index trống thay vì báo lỗi.
Forgejo hoặc Gitea cấp 2: quản lý issue và pull request
Forgejo và Gitea cùng một mô hình: một binary Go cung cấp web forge với user, organization, issue, pull request, release, package registry và hệ thống CI tích hợp sẵn. Chỉ cần binary và SQLite là đủ để cài đặt. Vì vậy, chúng chạy được trên phần cứng mà GitLab không thể chạy. File Compose dưới đây là file trong tài liệu Forgejo, với image tag được tài liệu này ghi nhận vào ngày 24 October 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 này theo nhánh v17. Forgejo v17.0.1, phát hành ngày 26 October 2026, là bản stable hiện tại. Forgejo hỗ trợ v17 đến ngày 28 January 2027. Nhánh v16 cũ đã hết hỗ trợ vào ngày 29 October 2026. Vì vậy, nếu instance hiện tại vẫn dùng tag 16 thì đã đến lúc nâng cấp. Việc chuyển từ major version này sang major version tiếp theo sau đó là nâng cấp thủ công. Bắt đầu với version hiện tại sẽ tiết kiệm công sức hơn.
docker compose up -d
docker compose ps
curl -sI http://127.0.0.1:3000 | head -1Dòng curl phải in ra một HTTP status line. Trước khi hoàn tất thiết lập lần đầu, dòng này có thể là redirect đến /install. Điều đó vẫn có nghĩa là service đang hoạt động. Nếu container thoát thay vì vậy, nguyên nhân thường là ownership: thư mục ./forgejo phải thuộc về UID (user id) trong USER_UID. Nếu không, process không thể ghi vào data directory của chính nó. Docker Compose trên VPS giải thích đầy đủ layout file và quy tắc ownership của volume.
Hai câu trả lời trên trang setup quyết định clone URL có hoạt động hay không. SSH port phải là phía host của SSH mapping. Trong file Compose ở trên, giá trị này là 222, vì nó map host port 222 vào port 22 của container. Không bắt buộc phải dùng chính port 222. Bất kỳ host port còn trống nào cũng được, miễn là mapping và câu trả lời này khớp nhau. Domain cũng phải là tên mà người dùng sẽ thực sự nhập. Nếu điền sai một trong hai, mọi repository page sẽ đưa ra clone command bị lỗi với tất cả những người sao chép command đó. Sau này, cả hai giá trị nằm trong section [server] của app.ini, lần lượt là SSH_PORT, SSH_DOMAIN và ROOT_URL.
Với instance public, chỉ publish web port trên loopback address ('127.0.0.1:3000:3000'), rồi đặt nginx phía trước để xử lý TLS (transport layer security). Gitea cũng cài theo cách tương tự từ image docker.gitea.com/gitea được dùng trong tài liệu của dự án, hoặc dưới dạng một binary duy nhất với một systemd unit và một app.ini. Bản stable hiện tại là v28.4.0, phát hành ngày 15 November 2026. Khi v28.0.0 được phát hành vào cuối September, dự án đã bỏ prefix 1. cũ. Vì vậy, release sau 1.27 là 28, không phải 1.28.
Hãy dùng SQLite khi vẫn có thể. Nó giữ instance ở dạng một process và một file, đồng thời vẫn hoạt động sau reboot mà không cần giám sát thêm service nào. PostgreSQL đáng dùng khi có nhiều người ghi dữ liệu đồng thời, vì SQLite tuần tự hóa thao tác ghi và các lần chạy CI dài thường xuyên ghi dữ liệu. Cả hai dự án đều cho phép chuyển instance hiện có sang PostgreSQL sau này. Đây không phải quyết định không thể thay đổi.
Forgejo hoặc Gitea: khác biệt thực tế là gì
Hai dự án có chung nguồn gốc. Gitea fork từ Gogs vào năm 2016. Cuối năm 2022, quyền kiểm soát domain và trademark của Gitea được chuyển cho một công ty là Gitea Ltd. Một số maintainer cùng Codeberg sau đó bắt đầu Forgejo. Forgejo được community phát triển dưới sự bảo trợ của Codeberg e.V., một hiệp hội phi lợi nhuận đăng ký tại Đức và nắm giữ các domain của dự án. Việc quản trị vẫn do các contributor của Forgejo đảm nhiệm. Năm 2024, dự án chuyển từ MIT licence sang GPLv3 (GNU general public license version 3). Gitea vẫn dùng MIT licence và được phát triển với sự hỗ trợ thương mại.
Trong sử dụng hằng ngày, feature set của hai dự án khá giống nhau. Nhưng đường chuyển đổi giữa chúng không giống nhau. Forgejo v10.0, phát hành vào January 2025, là release cuối cùng có thể dùng trực tiếp database của Gitea. Release này chỉ hỗ trợ database từ Gitea v1.22 trở về trước. Tính đến ngày 16 November 2026, Gitea đang ở v28.4.0. Vì vậy, instance Gitea hiện tại không có cách chuyển tại chỗ được hỗ trợ sang Forgejo. Hãy chọn một dự án trước khi thêm dữ liệu. Nếu chuyển sau này, hãy xem đó là quy trình export rồi re-import.
Quy tắc chọn có thể tóm tắt như sau. Nếu governance quan trọng với bạn hoặc bạn muốn dùng một dự án dưới sự bảo trợ của tổ chức phi lợi nhuận, hãy chạy Forgejo. Nếu bạn muốn install base lớn hơn và tùy chọn commercial support, hãy chạy Gitea. Cả hai đều được phát triển công khai và phát hành thường xuyên. Forgejo phát hành stable release mỗi ba tháng và một LTS (long term support) release mỗi năm. Tính đến ngày 29 October 2026, v17.0.1 là bản hiện tại và v15.0.11 là LTS. Forgejo hỗ trợ v17 đến ngày 28 January 2027 và v15 đến ngày 15 July 2027. Hỗ trợ v16 đã kết thúc vào ngày 29 October 2026. Vì vậy, hãy kiểm tra releases page trước khi pin một major version. Nếu hai quy tắc trên vẫn chưa giúp bạn quyết định, bản so sánh đầy đủ giữa Forgejo và Gitea trình bày khác biệt về Actions và package registry của hai dự án. Đây là chi tiết cần chốt trước khi dữ liệu khiến việc chuyển đổi trở nên tốn kém.
Tier 3: GitLab tốn tài nguyên trước khi thực hiện bất kỳ việc gì
GitLab CE thuộc một nhóm phần mềm khác. Một instance là tập hợp các service phối hợp với nhau: Puma cho web application, Sidekiq cho background job, PostgreSQL, Redis, Gitaly để truy cập repository và nginx ở phía trước. Gói Omnibus cài đặt tất cả cùng nhau, nên việc cài đặt đơn giản nhưng mức RAM tối thiểu rất cao.
Trang yêu cầu của GitLab ghi rõ 16 GB RAM và 8 vCPU là mức cơ bản cho một cài đặt single-node, đồng thời nêu 8 GB là mức thấp nhất trong môi trường bị giới hạn bộ nhớ. Trang này cũng yêu cầu bạn tắt swap, vì swap khi hệ thống chịu tải sẽ làm instance giảm hiệu năng nghiêm trọng. Đây là các con số được công bố tính đến tháng 10 năm 2026 và chúng đã tăng dần qua các năm, nên hãy đọc lại trang này trước khi tính cấu hình server.
Với mức tài nguyên đó, bạn có được những tính năng thực sự hữu ích: container registry, package registry, phân quyền chi tiết và CI đã được kiểm thử ở quy mô lớn; compliance center và audit trail của project hoặc group yêu cầu một gói GitLab trả phí. Nếu không ai trong team có thể nêu một tính năng trong danh sách đó mà họ cần trong quý này, bạn đang trả tiền cho một VPS lớn hơn nhưng không nhận được lợi ích tương xứng.
Mô hình truy cập SSH: một git user và nhiều key
Với system OpenSSH, mọi tier trong mô hình này xác thực theo cùng một cách. Có một Unix account tên là git, và mọi public key được ghi vào file ~/.ssh/authorized_keys của account đó. Key thực hiện việc xác thực. Quyền được cấp là các option bạn ghi trước key trên cùng một dòng.
Một dòng key thông thường cấp cho người giữ key mọi quyền mà account đó có thể thực hiện. Với một account vẫn dùng /bin/bash làm login shell, forced command sẽ giới hạn account này chỉ dùng cho Git:
restrict,command="git-shell -c \"$SSH_ORIGINAL_COMMAND\"" ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIexamplekeyhere alice@laptoprestrict, có từ OpenSSH 7.2, tắt port forwarding, agent forwarding, X11 và việc cấp phát PTY (pseudo terminal) chỉ bằng một từ. command= thay thế yêu cầu của client bằng command bạn chỉ định, còn Git vẫn hoạt động vì SSH server đặt command ban đầu của client vào $SSH_ORIGINAL_COMMAND.
Một forge tự ghi file đó cho bạn, và đây là khác biệt thực sự giữa tier 0 và tier 2. Khi chạy phía sau system OpenSSH server, vốn là cấu hình mặc định của chúng, Forgejo và Gitea ghi lại authorized_keys với một dòng cho mỗi key đã đăng ký. Mỗi dòng chứa một forced command xác định key bằng database 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 đó biến một Unix account dùng chung thành quyền riêng cho từng user: key-3 cho forge biết user nào đang kết nối, rồi forge kiểm tra user đó với repository trước khi bất kỳ object nào được truyền đi. Không tự sửa file đó trên máy do forge quản lý, vì file sẽ được ghi lại từ database và dòng bạn thêm sẽ biến mất. Nếu bật SSH server tích hợp của forge, hoặc cấu hình OpenSSH lấy key từ forge qua AuthorizedKeysCommand, forge không cần file đó nữa. Cả hai project đều yêu cầu bạn tắt việc tạo file trong trường hợp thứ hai. Deploy key dùng cùng cơ chế: deploy key là một SSH key thông thường được đăng ký cho một repository duy nhất, thường ở chế độ read-only, và forge thực hiện việc kiểm tra thay vì sshd.
Có 2 thói quen quan trọng hơn mọi cấu hình ở trên. Cấp một key cho mỗi người hoặc mỗi máy, không dùng key chung, vì thu hồi một key chung đồng nghĩa với việc phải rotate key cho tất cả mọi người cùng lúc. Đồng thời xóa key ngay trong ngày người đó rời đi, vì một key cũ còn trong file này là một login vĩnh viễn mà không ai theo dõi. Quản lý SSH key đúng cách trên server trình bày về các loại key và passphrase; mọi nội dung trong đó đều áp dụng nguyên vẹn ở đây. Nếu máy còn mới, 10 phút đầu tiên trên một VPS mới là việc nên làm trước khi đưa repository lên máy.
Tôi có thể chạy GitHub Actions trên Git server của mình không?
Bạn có thể chạy các workflow viết theo cú pháp GitHub Actions. Bạn không thể chạy GitHub. Forgejo Actions được bật mặc định từ Forgejo v1.21 và đọc các file workflow từ .forgejo/workflows trong mỗi repository. Gitea Actions hoạt động tương tự và đọc .gitea/workflows. Cả hai đều cần cài đặt và đăng ký thêm một chương trình là runner với instance của bạn bằng token lấy từ phần cài đặt của admin. Nhiều action được phát hành có thể chạy nguyên trạng.
Hãy tính đến 2 hệ quả. Với các container label thông thường, runner khởi động một container cho mỗi job. Vì vậy, runner cần một container engine và phần bộ nhớ riêng. Đây là lý do không nên đặt runner trên cùng box 1 GB với forge. Cả hai runner cũng có thể chạy job trực tiếp trên host thông qua label kết thúc bằng :host trên Forgejo. Cách này không cần engine, nhưng cũng không có container ngăn cách job với máy đó. Runner thực thi mọi thứ được chỉ định trong file workflow. Tài liệu Forgejo nêu rõ: runner thực hiện remote code execution. Nếu có thể, hãy dành riêng một host cho runner. Tối thiểu, hãy dùng một user không có quyền đặc biệt riêng và registration token chỉ có phạm vi trong một repository.
Nếu repositories của bạn vẫn ở trên GitHub và bạn chỉ muốn chạy compute trên phần cứng do bạn kiểm soát, đó là một thiết lập khác với các bước khác: runner GitHub Actions tự host kết nối với một GitHub repository và không cần những thành phần này. Nếu bạn vẫn đang cân nhắc chi phí của việc rời GitHub, những gì GitHub thực sự cung cấp sẽ tách phần Git hosting khỏi network xung quanh nó.
Sao lưu: repository chỉ là một nửa trạng thái
Một bare repository là một thư mục, vì vậy việc sao chép nó sẽ sao chép mọi thứ bên trong. Một bản mirror clone từ máy khác là một bản sao lưu thực thụ và nó có thể được làm mới tại chỗ:
git clone --mirror git@vps.example.com:/srv/git/project.git
cd project.git && git remote updateLệnh đó kéo mọi ref và mọi object. Nó không kéo các server-side hook hoặc file description, vì vậy hãy giữ một bản sao cấp độ file của thư mục nếu bạn có sử dụng hook.
Một nền tảng forge lưu trữ các issue, pull request, người dùng, key và quyền hạn trong database của nó, và việc chỉ sao chép các repository sẽ làm mất tất cả những dữ liệu đó. Cả hai dự án đều cung cấp một lệnh dump để ghi database, các repository, cấu hình và file đính kèm vào một file lưu trữ duy nhất:
sudo -u git forgejo dump -c /etc/forgejo/app.ini -f /var/backups/forgejo-dump.zipVới Docker, lệnh tương tự chạy bên trong container và đường dẫn cấu hình phụ thuộc vào image, vì vậy hãy kiểm tra kỹ trước khi gõ:
docker compose exec server ls /data/gitea/conf
docker compose exec -u git server forgejo dump -c /data/gitea/conf/app.iniHãy chạy lệnh với tư cách người dùng sở hữu dữ liệu và ghi file lưu trữ vào một thư mục mà người dùng đó có quyền ghi. Sau đó, hãy sao chép file lưu trữ ra khỏi máy chủ, vì bản sao lưu chỉ tồn tại trên chính máy đang được sao lưu thì không được coi là bản sao lưu. Khôi phục là bước mà mọi người thường bỏ qua: hãy giải nén một bản dump lên một máy dự phòng ngay bây giờ, để bạn nắm được quy trình vào lúc bình thường thay vì phải học khi đang gặp sự cố.
Chọn theo kịch bản
Một người dùng với một laptop và một VPS, không cần trình duyệt: dùng bare repository qua SSH. Không có dịch vụ bổ sung nào chạy và không cần nâng cấp gì cả.
Vẫn kịch bản đó, nhưng bạn muốn đọc code trên trình duyệt và gửi link: thêm cgit. Vẫn không cần database, vẫn không có tiến trình chạy thường trú.
Một nhóm cần review code của nhau và theo dõi issue: dùng Forgejo hoặc Gitea, trên VPS có từ 2 GB RAM trở lên. Hãy chuyển CI runner sang máy chủ thứ hai khi các job bắt đầu chạy nặng.
Một tổ chức cần container registry và audit trail, với 16 GB RAM cho máy chủ: dùng GitLab. Nếu ngân sách thấp hơn mức này, đừng cài đặt nó.
Việc nâng cấp giữa ba cấp độ đầu rất rẻ, vì ở tất cả các cấp đó, các repository đều là thư mục Git thông thường trên ổ cứng. Hãy bắt đầu ở cấp độ thấp nhất đáp ứng được công việc. Nếu bạn đang cân nhắc xem những gì khác xứng đáng có chỗ trên cùng máy chủ, danh sách rút gọn các dịch vụ đáng tự host sẽ đặt một Git server bên cạnh các dịch vụ khác đang cạnh tranh tài nguyên RAM đó.
FAQ
Một VPS 1 GB có chạy được Forgejo hoặc Gitea không?
Có, nếu dùng cho một nhóm nhỏ, chạy trên SQLite và máy đó không chạy thêm tác vụ nặng nào. Tài liệu Gitea cho biết 1 GB RAM và 2 CPU core thường đủ cho các nhóm và dự án nhỏ, còn Forgejo là fork của Gitea với yêu cầu tương tự. Không nên cài thêm PostgreSQL hoặc CI runner trên máy đó. Nếu service biến mất mà log riêng không có lỗi, hãy chạy sudo dmesg -T | grep -Ei 'oom|out of memory|killed process': dòng nêu tên process bị kill cho biết kernel out of memory killer đã dừng process đó. Khi đó, bạn cần nâng gói VPS thay vì chỉnh một flag.
Forgejo và Gitea khác nhau như thế nào?
Hai dự án có chung lịch sử codebase và hầu hết tính năng. Gitea fork từ Gogs vào năm 2016, còn Forgejo fork từ Gitea vào cuối năm 2022, sau khi quyền kiểm soát trademark Gitea chuyển sang một công ty. Forgejo do cộng đồng phát triển dưới sự bảo trợ của Codeberg e.V., một tổ chức phi lợi nhuận tại Đức, và phát hành theo GPLv3; Gitea vẫn dùng giấy phép MIT và có hỗ trợ thương mại. Khác biệt thực tế nằm ở đường dẫn migration. Forgejo v10.0, phát hành vào tháng 1 năm 2025, là release cuối cùng có thể nhận trực tiếp database của Gitea, và chỉ nhận từ Gitea v1.22 hoặc cũ hơn. Vì vậy, một instance Gitea hiện tại không có cách chuyển đổi tại chỗ được hỗ trợ.
Tôi có thể chạy workflow GitHub Actions trên Git server tự host không?
Forgejo Actions và Gitea Actions đều chạy các workflow được viết theo cú pháp YAML của GitHub Actions, đọc từ .forgejo/workflows và .gitea/workflows. Bạn cài một runner program riêng rồi đăng ký runner đó với instance của mình. Nhiều action đã được công bố có thể chạy mà không cần thay đổi. Runner thực thi code tùy ý từ các repository của bạn và, với các container label thông thường, khởi động một container cho mỗi job. Vì vậy, hãy dành riêng một host cho runner hoặc ít nhất dùng một unprivileged user riêng, đồng thời không chạy runner trên server 1 GB đã chạy forge.
Tôi sao lưu Git server tự host như thế nào?
Đối với bare repository, git clone --mirror từ một máy khác sẽ sao chép mọi ref và object, còn git remote update bên trong mirror sẽ cập nhật mirror đó. Với Forgejo hoặc Gitea, repository chỉ là một phần của state, vì issue, pull request, user và key nằm trong database. Hãy dùng lệnh dump tích hợp, sudo -u git forgejo dump -c /etc/forgejo/app.ini, hoặc chạy cùng lệnh đó bên trong container nếu cài bằng Docker. Sao chép archive ra khỏi server, rồi khôi phục archive đó một lần trên máy dự phòng để chắc chắn quy trình hoạt động.