Pilihan Pelayan Git Sendiri: Forgejo, Gitea atau cgit
Ketahui empat cara mengendalikan pelayan Git sendiri berdasarkan penggunaan RAM. Bandingkan keperluan memori bagi repositori SSH, cgit, Forgejo, Gitea dan GitLab di VPS 1GB.
Pelayan Git yang manakah perlu anda jalankan
Pelayan Git yang dihoskan sendiri bukanlah satu produk tunggal, dan jumlah RAM (random access memory) pada VPS anda menentukan versi yang boleh anda gunakan. Git tidak memerlukan daemon sendiri: repositori bare berserta akaun SSH (secure shell) sudah memadai sebagai pelayan yang berfungsi pada mesin paling kecil yang boleh anda sewa. Segala-galanya di atas tahap itu ialah aplikasi web yang anda pilih untuk dijalankan bersamanya, dan setiap peningkatan tahap memerlukan memori yang mungkin tidak dimiliki oleh VPS kecil. Jika anda masih tidak pasti di mana Git berakhir dan GitHub bermula, perbezaan antara Git, GitHub dan pelayan Git anda sendiri menjelaskan pembahagian tersebut sebelum anda memilih tahap yang sesuai.
Terdapat empat langkah. Repositori bare melalui SSH, tanpa sebarang perkhidmatan yang mendengar selain daripada apa yang sedia ada. cgit, paparan web baca-sahaja yang pantas tanpa pangkalan data. Forgejo atau Gitea, sebuah forge lengkap dengan akaun, isu dan pull request dalam beberapa ratus megabait. GitLab, yang memerlukan pelayan dengan saiz berkali-kali ganda lebih besar daripada yang lain.
Tentukan berdasarkan kerja yang perlu anda lakukan, kemudian semak angka memori tersebut dengan pelan yang anda langgan.
Berapa banyak RAM yang sebenarnya diperlukan oleh setiap pilihan
Hanya dua daripada projek ini menerbitkan angka keperluan perkakasan. Anggap angka yang diterbitkan sebagai tahap minimum dan bukannya jaminan, dan ukur instans anda sendiri sebaik sahaja ia berjalan, menggunakan systemd-cgtop atau ps -o rss= -C forgejo.
Data di sebalik carta ini
[
{
"label": "Gitea, small team",
"ram_gb": 1
},
{
"label": "GitLab, memory constrained",
"ram_gb": 8
},
{
"label": "GitLab, single node baseline",
"ram_gb": 16
}
]Gitea mendokumentasikan 1 GB RAM dengan 2 teras CPU sebagai jumlah yang biasanya mencukupi untuk pasukan dan projek kecil, serta menyatakan bahawa Raspberry Pi 3 sudah memadai untuk beban kerja kecil. GitLab mendokumentasikan 16 GB sebagai garis dasar untuk pemasangan nod tunggal, dan 8 GB sebagai tahap rendah untuk apa yang dipanggil oleh halaman mereka sendiri sebagai persekitaran yang terhad memori. Dokumentasi pemasangan Forgejo tidak memberikan angka RAM. Ia merupakan fork daripada Gitea dan berkelakuan serupa, jadi angka Gitea adalah panduan terbitan paling hampir yang anda miliki.
Apa maksudnya pada VPS 1 GB: repositori kosong dan cgit boleh dimuatkan dengan ruang yang masih berbaki, kerana kedua-duanya tidak menjalankan servis residen. Forgejo atau Gitea akan bermula dan boleh melayani pasukan kecil menggunakan SQLite, tetapi anda berada pada tahap minimum yang didokumentasikan, jadi jangan jalankan PostgreSQL dan runner CI (continuous integration) pada pelayan tersebut. Jika antara muka web hilang tanpa ralat, jalankan sudo dmesg -T | grep -Ei 'oom|out of memory|killed process' dan cari baris seperti Out of memory: Killed process 1181 (forgejo), yang bermaksud kernel out of memory killer telah menamatkannya. GitLab pada pelayan 1 GB bukanlah masalah penalaan. Ia tidak akan berjalan.
Tahap 0: repositori kosong melalui SSH
Git tidak mempunyai daemon rangkaian yang perlu anda mulakan. git push melalui SSH menjalankan git-receive-pack pada hujung jauh sebagai proses Unix biasa, jadi mana-mana akaun yang boleh anda capai dengan kunci sudah menjadi remote Git. Cipta satu akaun untuk repositori tersebut, dan simpan repositori di luar direktori home akaun itu supaya paparan web yang ditambah kemudian tidak memerlukan akses kepada direktori home tersebut.
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 mencipta repositori tanpa salinan kerja (working copy), iaitu format yang disimpan oleh pelayan. Menolak (push) ke cawangan yang sedang diperiksa (checked-out) dalam repositori yang mempunyai salinan kerja akan ditolak secara lalai dengan refusing to update checked out branch: refs/heads/main, dan itu adalah kesilapan paling biasa pada tahap ini.
Sekarang, berikan kunci kepada akaun tersebut dan lakukan 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 mainPush pertama yang berjaya akan berakhir dengan * [new branch] main -> main. Push yang berakhir dengan git@vps.example.com: Permission denied (publickey) tidak disahkan, jadi baca log pelayan dengan sudo journalctl -u ssh -n 20. Baris yang memaparkan Authentication refused: bad ownership or modes for file /home/git/.ssh/authorized_keys bermaksud pemilikan atau mod fail adalah salah, kerana sshd menolak fail kunci yang mempunyai pemilik tidak dipercayai atau kebenaran yang membenarkan pengguna lain menulis padanya.
Jika origin projek sudah menghala ke GitHub, git remote add origin akan berhenti dengan error: remote origin already exists., dan menambah pelayan ini sebagai URL push kedua pada remote tersebut membolehkan seseorang git push mengemas kini kedua-duanya.
Kemudian, tarik balik akses shell daripada akaun tersebut.
command -v git-shell | sudo tee -a /etc/shells
sudo chsh -s "$(command -v git-shell)" gitgit-shell hanya menerima beberapa arahan yang dihantar oleh Git melalui SSH, jadi log masuk interaktif kini akan berhenti dengan mesej dan bukannya prompt:
fatal: Interactive git shell is not enabled.
hint: ~/git-shell-commands should exist and have read and execute access.Itu adalah keseluruhan pelayan. Tiada pangkalan data, dan tiada proses web untuk dinaik taraf. Apa yang anda korbankan adalah segala fungsi yang disediakan oleh forge: tiada pelayaran, tiada penjejak isu, tiada pull request, dan tiada kebenaran bagi setiap pengguna. Setiap kunci dalam fail tersebut boleh membaca dan menulis setiap repositori yang dimiliki oleh pengguna git.
Tahap 1: cgit memberikan paparan web tanpa pangkalan data
cgit ialah program CGI (common gateway interface) yang ditulis dalam C. Pelayan web menjalankannya sekali bagi setiap permintaan, ia membaca repositori terus daripada cakera, dan ia tidak menyimpan sebarang status sendiri. Ubuntu 24.04 menyediakannya dalam komponen universe.
sudo apt update
sudo apt install -y cgit fcgiwrap nginx
sudo install -d -o www-data -g www-data /var/cache/cgitHalakan ia ke direktori repositori dalam /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 melayari direktori tersebut dan menyenaraikan setiap repositori yang ditemui, jadi repositori bare yang baharu akan muncul tanpa konfigurasi tambahan. cache-size ialah bilangan halaman yang dicache, dan caching kekal dimatikan selagi nilainya sifar. Baca kandungan yang telah diletakkan oleh pakej anda dalam /etc/cgitrc sebelum menambah baris baharu, memandangkan pakej Debian dan Ubuntu sudah menyertakan beberapa tetapan lalai.
Setiap entri memaparkan baris pertama fail description repositori tersebut, jadi repositori bare yang baharu akan menyenaraikan dirinya sebagai Unnamed repository; edit this file 'description' to name the repository.. Betulkan perkara itu sekali bagi setiap repositori:
echo 'Project X, internal tooling' | sudo -u git tee /srv/git/project.git/descriptionFail tapak nginx, dan cara untuk menyemaknya
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 menghidangkan cgit.css dan cgit.png sebagai fail biasa, dan try_files menyerahkan segala yang lain kepada CGI di /usr/lib/cgit/cgit.cgi. Halaman 502, dengan connect() to unix:/run/fcgiwrap.socket failed (2: No such file or directory) dalam /var/log/nginx/error.log, bermaksud unit soket tidak berjalan atau mendengar pada laluan lain. Baris systemctl show mencetak laluan yang sebenarnya digunakan.
Dua had perlu diketahui sebelum anda membina di atasnya. cgit adalah baca-sahaja dan tidak mempunyai log masuk dalam konfigurasi ini, jadi segala-galanya di bawah scan-path adalah awam: jauhkan repositori peribadi daripada direktori tersebut, atau letakkan pengesahan HTTP basic di hadapan keseluruhan tapak. Dan CGI berjalan sebagai pengguna pelayan web, jadi pengguna tersebut perlu mempunyai kebenaran untuk melayari /srv/git dan membaca setiap repositori. Direktori yang tidak boleh dimasuki akan dipaparkan sebagai indeks kosong dan bukannya ralat.
Tahap 2: Forgejo atau Gitea untuk isu dan pull request
Forgejo dan Gitea mempunyai konsep yang sama: satu binari Go yang menyediakan forge web dengan pengguna, organisasi, isu, pull request, keluaran (releases), pendaftaran pakej dan sistem CI terbina dalam. Binari berserta SQLite merangkumi keseluruhan pemasangan, sebab itulah ia sesuai pada perkakasan yang tidak mampu dikendalikan oleh GitLab. Fail Compose di bawah adalah fail yang terdapat dalam dokumentasi Forgejo, dengan tag imej yang dinamakan setakat 24 Oktober 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 tersebut mengikuti baris v17. Forgejo v17.0.1, yang dikeluarkan pada 26 Oktober 2026, merupakan keluaran stabil semasa, dan Forgejo menyokong v17 sehingga 28 Januari 2027. Baris v16 yang lebih lama telah tamat sokongan pada 29 Oktober 2026, jadi pemasangan sedia ada yang masih menggunakan tag 16 perlu dinaik taraf sekarang. Berpindah dari satu versi utama ke versi seterusnya kemudian hari memerlukan naik taraf manual, jadi lebih jimat untuk bermula dengan versi semasa.
docker compose up -d
docker compose ps
curl -sI http://127.0.0.1:3000 | head -1Baris curl sepatutnya mencetak baris status HTTP. Sebelum anda melengkapkan persediaan kali pertama, ia mungkin merupakan redirect ke /install, yang masih bermakna servis tersebut sedang berjalan. Jika kontena keluar (exit) sebaliknya, punca biasa ialah pemilikan: direktori ./forgejo mestilah dimiliki oleh UID (user id) dalam USER_UID, atau proses tersebut tidak dapat menulis ke direktori datanya sendiri. Docker Compose pada VPS merangkumi susun atur fail tersebut dan peraturan pemilikan volum sepenuhnya.
Dua jawapan pada halaman persediaan menentukan sama ada URL klon berfungsi. Port SSH mestilah bahagian hos bagi pemetaan SSH, yang dalam fail Compose di atas ialah 222, kerana ia memetakan port hos 222 ke port 22 kontena. Tiada apa-apa yang mewajibkan 222 itu sendiri: mana-mana port hos yang bebas boleh digunakan, selagi pemetaan dan jawapan ini sepadan. Dan domain mestilah nama yang akan ditaip oleh pengguna. Jika salah satu daripadanya salah, setiap halaman repositori akan menawarkan arahan klon yang gagal bagi sesiapa sahaja yang menyalinnya. Kedua-duanya berada dalam bahagian [server] bagi app.ini selepas itu, sebagai SSH_PORT, SSH_DOMAIN dan ROOT_URL.
Untuk instans awam, terbitkan port web pada alamat loopback sahaja ('127.0.0.1:3000:3000') dan letakkan nginx di hadapannya untuk TLS (transport layer security). Gitea dipasang dengan cara yang sama daripada imej docker.gitea.com/gitea yang digunakan dalam dokumentasinya, atau sebagai binari tunggal dengan satu unit systemd dan satu app.ini. Keluaran stabil semasanya ialah v28.4.0, yang diterbitkan pada 15 November 2026. Dengan v28.0.0 pada akhir September, projek tersebut menggugurkan awalan 1. yang lama, jadi keluaran selepas 1.27 ialah 28, bukan 1.28.
Kekal menggunakan SQLite selagi boleh. Ia mengekalkan instans kepada satu proses dan satu fail, serta bertahan selepas but semula tanpa servis tambahan untuk diselia. PostgreSQL berbaloi apabila beberapa orang menulis secara serentak, kerana SQLite mensirikan (serialise) penulisan dan larian CI yang panjang menulis secara berterusan. Kedua-dua projek boleh memindahkan instans sedia ada ke PostgreSQL kemudian hari, jadi ini bukanlah keputusan yang muktamad.
Forgejo atau Gitea: apa sebenarnya yang berbeza
Salasilahnya dikongsi bersama. Gitea di-fork daripada Gogs pada tahun 2016. Pada akhir 2022, kawalan domain dan tanda dagangan Gitea berpindah kepada sebuah syarikat, Gitea Ltd, dan beberapa penyelenggara bersama Codeberg memulakan Forgejo. Forgejo dibangunkan oleh komunitinya di bawah naungan Codeberg e.V., sebuah persatuan bukan untung yang berdaftar di Jerman yang memegang domain projek tersebut, manakala tadbir urus kekal dengan penyumbang Forgejo sendiri. Ia berpindah daripada lesen MIT kepada GPLv3 (GNU general public license version 3) pada tahun 2024. Gitea kekal dengan lesen MIT dan dibangunkan dengan sokongan komersial di belakangnya.
Dari hari ke hari, set ciri-cirinya hampir sama. Laluan antara keduanya tidak. Forgejo v10.0, dari Januari 2025, merupakan keluaran terakhir yang boleh mengambil pangkalan data Gitea secara terus, dan hanya daripada Gitea v1.22 atau lebih lama. Gitea berada pada v28.4.0 setakat 16 November 2026, jadi instans Gitea semasa tidak mempunyai cara penukaran terus (in-place switch) yang disokong ke Forgejo. Pilih satu sebelum anda mengisinya dengan data, dan anggap sebarang perpindahan kemudian hari sebagai eksport dan import semula.
Satu peraturan ringkas untuk memilih. Jika tadbir urus penting bagi anda, atau anda mahukan projek di bawah naungan bukan untung, jalankan Forgejo. Jika anda mahukan pangkalan pemasangan yang lebih besar dan pilihan sokongan komersial, jalankan Gitea. Kedua-duanya diselenggara secara terbuka dan kerap mengeluarkan keluaran: Forgejo menghantar keluaran stabil setiap tiga bulan dan keluaran LTS (long term support) setiap tahun, dengan v17.0.1 sebagai semasa dan v15.0.11 sebagai LTS setakat 29 Oktober 2026. Forgejo menyokong v17 sehingga 28 Januari 2027 dan v15 sehingga 15 Julai 2027, manakala sokongan v16 berakhir pada 29 Oktober 2026, jadi semak halaman keluarannya sebelum anda menetapkan (pin) versi utama. Jika tiada peraturan yang menyelesaikan pilihan anda, perbandingan penuh Forgejo dan Gitea menetapkan bagaimana Actions dan pendaftaran pakej mereka berbeza, dan itu adalah perincian yang perlu diselesaikan sebelum data anda menjadikan proses penukaran menjadi mahal.
Tahap 3: kos GitLab sebelum ia berfungsi
GitLab CE ialah kelas perisian yang berbeza. Satu instans terdiri daripada set servis yang bekerjasama: Puma untuk aplikasi web, Sidekiq untuk tugasan latar belakang, PostgreSQL, Redis, Gitaly untuk akses repositori, dan nginx di bahagian hadapan. Pakej Omnibus memasang kesemuanya secara serentak, yang menjadikan pemasangan mudah tetapi penggunaan memori asas menjadi tinggi.
Halaman keperluan GitLab mendokumentasikan 16 GB RAM dan 8 vCPU sebagai garis dasar untuk pemasangan nod tunggal, dengan 8 GB dinyatakan sebagai tahap minimum dalam persekitaran yang terhad memori. Halaman yang sama menasihatkan anda untuk menyahdayakan swap, kerana penggunaan swap semasa beban tinggi akan merosakkan prestasi instans dengan teruk. Itu adalah angka yang diterbitkan setakat Oktober 2026, dan ia telah meningkat sepanjang tahun, jadi baca semula halaman tersebut sebelum anda menentukan saiz pelayan.
Anda mendapat perkara sebenar untuk bajet tersebut: container registry, package registry, kebenaran yang terperinci dan CI yang telah diuji pada skala besar; pusat pematuhan (compliance center) serta jejak audit projek atau kumpulan memerlukan tier GitLab berbayar. Jika tiada sesiapa dalam pasukan anda boleh menamakan sesuatu daripada senarai itu yang mereka perlukan pada suku tahun ini, anda sebenarnya membayar untuk VPS yang lebih besar tanpa mendapat sebarang pulangan.
Model akses SSH: satu pengguna git dan banyak kunci
Dengan OpenSSH sistem, setiap peringkat di sini mengesahkan identiti dengan cara yang sama. Terdapat satu akaun Unix bernama git, dan setiap kunci awam dimasukkan ke dalam ~/.ssh/authorized_keys akaun tersebut. Pengesahan adalah kuncinya. Kebenaran pula adalah apa jua pilihan yang anda tulis di hadapan kunci pada baris yang sama.
Baris kunci biasa memberikan pemegangnya apa sahaja yang boleh dilakukan oleh akaun tersebut. Bagi akaun yang masih menggunakan /bin/bash sebagai shell log masuknya, arahan paksa (forced command) mengehadkannya kepada Git sahaja:
restrict,command="git-shell -c \"$SSH_ORIGINAL_COMMAND\"" ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIexamplekeyhere alice@laptoprestrict, yang tersedia sejak OpenSSH 7.2, mematikan port forwarding, agent forwarding, X11 dan peruntukan PTY (pseudo terminal) dalam satu perkataan. command= menggantikan apa sahaja yang diminta oleh klien dengan arahan yang anda namakan, dan Git masih berfungsi kerana pelayan SSH meletakkan arahan asal klien dalam $SSH_ORIGINAL_COMMAND.
Forge akan menulis fail tersebut untuk anda, dan itulah perbezaan sebenar antara peringkat 0 dan peringkat 2. Apabila ia berada di belakang pelayan OpenSSH sistem, yang merupakan tetapan lalai, Forgejo dan Gitea menulis semula authorized_keys dengan satu baris bagi setiap kunci yang didaftarkan, setiap satunya membawa arahan paksa yang menamakan kunci tersebut mengikut id pangkalan datanya:
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 aliceArahan paksa itulah cara satu akaun Unix yang dikongsi menjadi kebenaran bagi setiap pengguna: key-3 memberitahu forge pengguna mana yang sedang menyambung, dan ia menyemak pengguna tersebut terhadap repositori sebelum sebarang objek dipindahkan. Jangan sunting fail tersebut secara manual pada kotak yang diuruskan oleh forge, kerana ia ditulis semula daripada pangkalan data dan baris anda akan hilang. Jika anda menghidupkan pelayan SSH terbina dalam forge, atau meminta OpenSSH mendapatkan kunci daripada forge melalui AuthorizedKeysCommand, forge tidak memerlukan fail tersebut langsung, dan kedua-dua projek menasihatkan anda untuk mematikan penciptaannya dalam kes kedua. Kunci deploy (deploy keys) datang daripada mekanisme yang sama: kunci deploy ialah kunci SSH biasa yang didaftarkan pada satu repositori, biasanya baca-sahaja, dengan semakan dilakukan dalam forge dan bukannya dalam sshd.
Dua tabiat lebih penting daripada mana-mana konfigurasi di atas. Keluarkan satu kunci bagi setiap orang atau setiap mesin, jangan sekali-kali berkongsi kunci, kerana membatalkan kunci yang dikongsi bermakna anda perlu menukar kunci untuk semua orang serentak. Dan buang kunci pada hari seseorang berhenti, kerana kunci lama dalam fail tersebut adalah akses log masuk kekal yang tidak dipantau oleh sesiapa. Pengurusan kunci SSH yang baik pada pelayan merangkumi jenis kunci dan frasa laluan, dan semuanya terpakai di sini tanpa perubahan. Jika kotak tersebut baharu, sepuluh minit pertama pada VPS baharu adalah perkara yang perlu dilakukan sebelum anda meletakkan repositori di atasnya.
Bolehkah saya menjalankan GitHub Actions pada pelayan Git saya sendiri?
Anda boleh menjalankan aliran kerja (workflow) yang ditulis menggunakan sintaks GitHub Actions. Anda tidak boleh menjalankan GitHub. Forgejo Actions telah didayakan secara lalai sejak Forgejo v1.21 dan membaca fail aliran kerja daripada .forgejo/workflows dalam setiap repositori. Gitea Actions berfungsi dengan cara yang sama dan membaca .gitea/workflows. Kedua-duanya memerlukan program kedua, iaitu runner, yang dipasang dan didaftarkan pada instans anda menggunakan token daripada tetapan pentadbir. Banyak tindakan (action) yang diterbitkan boleh dijalankan tanpa sebarang perubahan.
Rancang untuk dua akibat. Dengan label kontena biasa, runner akan memulakan kontena bagi setiap tugasan, jadi ia memerlukan enjin kontena dan peruntukan memori sendiri. Itulah sebabnya ia tidak sepatutnya diletakkan pada pelayan 1 GB yang sama dengan forge. Kedua-dua runner juga boleh menjalankan tugasan secara terus pada hos, melalui label yang berakhir dengan :host pada Forgejo, yang tidak memerlukan enjin tetapi juga tidak meletakkan sebarang kontena antara tugasan dan mesin tersebut. Selain itu, runner akan melaksanakan apa sahaja yang diarahkan oleh fail aliran kerja, seperti yang dinyatakan dengan jelas dalam dokumentasi Forgejo: runner tersebut melakukan pelaksanaan kod jauh (remote code execution). Berikan ia hos sendiri jika boleh, atau sekurang-kurangnya pengguna tanpa keistimewaan (unprivileged user) dan token pendaftaran yang dihadkan kepada satu repositori sahaja.
Jika repositori anda kekal di GitHub dan anda hanya mahukan kuasa pengkomputeran pada perkakasan yang anda kawal, itu adalah persediaan berbeza dengan langkah yang berbeza: runner GitHub Actions yang dihoskan sendiri disambungkan kepada repositori GitHub dan tidak memerlukan semua ini. Jika anda masih menimbang kos untuk berpindah, apa yang GitHub sebenarnya berikan kepada anda memisahkan pengehosan Git daripada rangkaian di sekelilingnya.
Sandaran: repositori hanyalah separuh daripada keadaan sebenar
Repositori bare ialah satu direktori, jadi menyalinnya bermakna menyalin segala-galanya di dalamnya. Mirror clone daripada mesin lain merupakan sandaran sebenar, dan ia dikemas kini di tempat asal:
git clone --mirror git@vps.example.com:/srv/git/project.git
cd project.git && git remote updatePerintah itu menarik setiap ref dan setiap objek. Ia tidak menarik hooks bahagian pelayan atau fail description, jadi simpan juga salinan direktori pada peringkat fail jika anda menggunakan hooks.
Forge menyimpan isu, pull request, pengguna, kunci dan kebenaran dalam pangkalan datanya, dan salinan repositori sahaja akan melupuskan semua maklumat tersebut. Kedua-dua projek mengeluarkan perintah dump yang menulis pangkalan data, repositori, konfigurasi dan lampiran ke dalam satu arkib:
sudo -u git forgejo dump -c /etc/forgejo/app.ini -f /var/backups/forgejo-dump.zipDi bawah Docker, perintah yang sama dijalankan di dalam container, dan laluan konfigurasi bergantung pada imej, jadi periksa dahulu sebelum anda menaip:
docker compose exec server ls /data/gitea/conf
docker compose exec -u git server forgejo dump -c /data/gitea/conf/app.iniJalankan perintah tersebut sebagai pengguna yang memiliki data, dan tulis arkib ke direktori yang boleh ditulis oleh pengguna tersebut. Kemudian, salin arkib keluar dari pelayan, kerana sandaran yang hanya wujud pada mesin yang disandarkan bukanlah satu sandaran. Pemulihan adalah langkah yang sering dilupakan oleh orang ramai: nyahzip satu dump ke atas mesin simpanan sekarang, supaya anda mempelajari prosedurnya pada waktu yang tenang dan bukannya semasa gangguan berlaku.
Pemilihan mengikut senario
Seorang pengguna dengan komputer riba dan satu VPS, tanpa keperluan pelayaran web: gunakan bare repositories melalui SSH. Tiada servis tambahan yang perlu dijalankan dan tiada apa-apa yang perlu dikemas kini.
Senario yang sama, tetapi anda ingin membaca kod dalam pelayar web dan menghantar pautan kepadanya: tambahkan cgit. Masih tiada pangkalan data, dan tiada servis yang perlu sentiasa berjalan.
Satu pasukan yang menyemak kod antara satu sama lain dan menjejak isu: gunakan Forgejo atau Gitea, pada 2 GB RAM atau lebih. Pindahkan CI runner ke pelayan kedua apabila beban kerja menjadi berat.
Sebuah organisasi yang memerlukan container registry dan audit trail, dengan peruntukan 16 GB RAM pada pelayan: gunakan GitLab. Jangan mulakan GitLab jika bajet RAM kurang daripada itu.
Peralihan antara tiga tahap pertama adalah murah, kerana dalam kesemuanya, repositori hanyalah direktori Git biasa pada cakera. Mulakan pada tahap terendah yang memenuhi keperluan anda. Jika anda sedang mempertimbangkan perkhidmatan lain yang sesuai untuk diletakkan pada pelayan yang sama, senarai pendek perkhidmatan yang berbaloi untuk di-self-host meletakkan pelayan Git bersama perkhidmatan lain yang bersaing untuk mendapatkan ruang RAM tersebut.
FAQ
Bolehkah VPS 1 GB menjalankan Forgejo atau Gitea?
Boleh, untuk pasukan kecil yang menggunakan SQLite dan tiada beban berat lain pada pelayan tersebut. Dokumentasi Gitea menyatakan 1 GB RAM dan 2 teras CPU biasanya mencukupi untuk pasukan dan projek kecil, manakala Forgejo merupakan fork daripada Gitea dengan spesifikasi yang sama. Jangan tambah PostgreSQL atau CI runner pada mesin tersebut. Jika servis hilang tanpa ralat dalam lognya sendiri, jalankan sudo dmesg -T | grep -Ei 'oom|out of memory|killed process': baris yang menamakan proses yang ditamatkan bermakna kernel out of memory killer telah menghentikannya, dan penyelesaiannya adalah pelan yang lebih besar, bukannya flag penalaan.
Apakah perbezaan antara Forgejo dan Gitea?
Kedua-duanya berkongsi sejarah kod sumber dan kebanyakan ciri. Gitea di-fork daripada Gogs pada tahun 2016, dan Forgejo di-fork daripada Gitea pada akhir tahun 2022 selepas kawalan tanda dagangan Gitea berpindah kepada sebuah syarikat. Forgejo dibangunkan oleh komunitinya di bawah naungan Codeberg e.V., sebuah pertubuhan bukan untung di Jerman, dan dikeluarkan di bawah lesen GPLv3; Gitea kekal dengan lesen MIT dan sokongan komersial. Perbezaan praktikalnya ialah laluan migrasi. Forgejo v10.0, dari Januari 2025, merupakan keluaran terakhir yang boleh menerima pangkalan data Gitea secara terus, dan hanya daripada Gitea v1.22 atau lebih lama, jadi instans Gitea semasa tidak mempunyai kaedah pertukaran terus yang disokong.
Bolehkah saya menjalankan workflow GitHub Actions pada pelayan Git yang dihoskan sendiri?
Forgejo Actions dan Gitea Actions kedua-duanya menjalankan workflow yang ditulis dalam sintaks YAML GitHub Actions, yang dibaca daripada .forgejo/workflows dan .gitea/workflows. Anda perlu memasang program runner yang berasingan dan mendaftarkannya pada instans anda. Banyak tindakan yang diterbitkan berfungsi tanpa perubahan. Runner tersebut melaksanakan kod arbitrari daripada repositori anda dan, dengan label kontena yang biasa, memulakan satu kontena bagi setiap kerja. Oleh itu, sediakan hos sendiri untuknya, atau sekurang-kurangnya gunakan pengguna tanpa keistimewaan (unprivileged user), dan jangan jalankan pada pelayan 1 GB yang sudah pun menjalankan forge tersebut.
Bagaimanakah cara membuat sandaran pelayan Git yang dihoskan sendiri?
Untuk repositori bare, git clone --mirror daripada mesin lain akan menyalin setiap ref dan objek, dan git remote update di dalam cermin tersebut akan menyegarkannya. Bagi Forgejo atau Gitea, repositori hanyalah sebahagian daripada keadaan sistem, kerana isu, pull request, pengguna dan kunci disimpan dalam pangkalan data. Gunakan fungsi dump terbina dalam, sudo -u git forgejo dump -c /etc/forgejo/app.ini, atau arahan yang sama di dalam kontena untuk pemasangan Docker. Salin arkib tersebut keluar dari pelayan, dan lakukan pemulihan pada mesin simpanan sekali untuk memastikan prosedur tersebut berfungsi.