Rode seu próprio servidor Git estilo GitHub com Gitea, PostgreSQL e HTTPS num VPS de 12 €: docker compose, reverse proxy Caddy, acesso SSH para git push e backups.
O Gitea é um serviço Git leve com issues, pull requests e hooks de CI - tudo o que espera, a correr em algumas centenas de megabytes. Num VPS de 16 € serve uma equipa inteira.
apt update && apt install -y docker.io docker-compose-v2 git systemctl enable --now docker
Passo a passo completo, incluindo noções básicas do Compose: guia do Docker.
mkdir -p /opt/gitea && cd /opt/gitea
cat > docker-compose.yml <<'EOF'
services:
db:
image: postgres:16-alpine
restart: unless-stopped
environment:
POSTGRES_USER: gitea
POSTGRES_PASSWORD: change-me-db
POSTGRES_DB: gitea
volumes:
- ./db:/var/lib/postgresql/data
gitea:
image: gitea/gitea:1
restart: unless-stopped
depends_on: [db]
environment:
GITEA__database__DB_TYPE: postgres
GITEA__database__HOST: db:5432
GITEA__database__NAME: gitea
GITEA__database__USER: gitea
GITEA__database__PASSWD: change-me-db
volumes:
- ./data:/data
- /etc/timezone:/etc/timezone:ro
- /etc/localtime:/etc/localtime:ro
ports:
- "127.0.0.1:3000:3000"
- "2222:22"
EOF
docker compose up -dRepare nas ligações: a interface web escuta apenas em localhost, enquanto o SSH para `git push` está na porta 2222. Torne a porta acessível - abrindo a 2222 na firewall ou servindo o Git mais tarde por HTTPS.
apt install -y caddy
cat > /etc/caddy/Caddyfile <<'EOF'
git.example.com {
reverse_proxy 127.0.0.1:3000
}
EOF
systemctl reload caddyO Caddy obtém o certificado automaticamente. Aponte primeiro o registo A do domínio para o servidor e conclua o assistente de configuração no navegador - a primeira conta registada torna-se o administrador.
git remote add origin ssh://[email protected]:2222/you/project.git git push -u origin main
Adicione a sua chave pública nas definições do Gitea uma só vez e todos os pushes seguintes ficam sem palavra-passe.
docker compose exec -u git gitea gitea dump -c /data/gitea/conf/app.ini # the dump lands in /opt/gitea/data/gitea, then ship it off-site: restic backup /opt/gitea/data --exclude-caches
O comando `gitea dump` reúne a base de dados, os repositórios e a configuração num único arquivo. Para cópias fora do servidor, veja o guia do restic.
O contentor em repouso usa cerca de 150–250 MB e o PostgreSQL mais 100–200 MB. Um servidor de 2 GB é confortável para uma equipa pequena; 4 GB se também executar runners de CI ou muitos repositórios grandes.
Sim. No Gitea escolha Nova migração, cole o URL do repositório e ele copia o código, as issues e os pull requests. Os repositórios privados precisam de um token de acesso do GitHub.
É tão seguro quanto a administração do seu servidor: chaves SSH, firewall, atualizações e cópias fora do servidor cobrem os riscos realistas. Para muitas equipas, isso é mais controlo do que confiar tudo a terceiros.
O Gitea e o PostgreSQL cabem com folga num Core VPS 6 (16 €/mês).