- O Gitea é uma alternativa leve ao GitLab e ao GitHub que consome muito poucos recursos do sistema.
- A instalação é baseada em um arquivo binário executável gerenciado como um serviço através do SystemD.
- Utilizar um proxy reverso com Nginx é essencial para permitir o acesso seguro via HTTPS.
- Permite migrar repositórios existentes de outras plataformas, mantendo os problemas e as tags.
Se você está cansado de depender das regras, custos ou disponibilidade de gigantes como GitHub ou GitLab, construir sua própria infraestrutura é o caminho a seguir. Ter um servidor Git em casa ou no seu escritório lhe dá as chaves do reino: controle absoluto sobre o código , gerenciamento total de acesso e a tranquilidade de não ter limitações de terceiros em seus repositórios privados.
Dentre todas as opções disponíveis, o Gitea se destaca como uma joia. É uma ferramenta escrita em Go, o que a torna incrivelmente leve e rápida , ideal para quem não quer dedicar 16 GB de RAM a um servidor Git. Ao contrário do GitLab, que é um transatlântico repleto de recursos, mas que consome muitos recursos, o Gitea é como uma lancha: vai direto ao ponto, consome poucos recursos e oferece uma interface muito familiar para qualquer pessoa que já tenha usado o GitHub.
Comparação rápida: Gitea, GitLab e Forgejo
Antes de mergulhar na instalação, vale a pena saber o que você está adquirindo. O GitLab é a opção empresarial por excelência, ideal para grandes equipes que precisam de CI/CD integrado, mas exige hardware potente. O Gitea, por outro lado, é a melhor escolha para servidores modestos ou projetos pessoais devido ao seu consumo de memória muito baixo. Por fim, há o Forgejo, um fork do Gitea desenvolvido pela comunidade; se você é um purista do software livre e prefere governança aberta sem conotações corporativas, esta é a alternativa ideal.
O que você precisa antes de começar
Para garantir que tudo funcione sem problemas, certifique-se de ter um servidor Linux (Ubuntu, Debian ou Rocky Linux) com acesso root. Também é essencial ter o Git instalado na máquina e, embora o Gitea permita o uso do SQLite, para ambientes de produção, o PostgreSQL ou o MariaDB são altamente recomendados para garantir a estabilidade dos dados.
Preparando o terreno no sistema
Executar o Gitea como root não é uma boa ideia por motivos de segurança. O ideal é criar um usuário dedicado. Você pode fazer isso executando o comando adduser --system --shell /bin/bash --group --home /home/gitea gitea. É essencial usar /bin/bash como shell Porque o Gitea precisa interagir com o git-shell via SSH. Se você ainda não tem o Git instalado, basta fazer o seguinte: apt install git resolverá o problema rapidamente.
Instalação binária e estrutura de pastas
O Gitea pode ser instalado de várias maneiras, mas o binário é a mais simples. Você deve localizar a versão estável mais recente no site oficial e baixá-la usando [método/método]. wget en /usr/local/bin/giteadando-o mais tarde Execute as permissões com chmod +xPara que o programa funcione corretamente, é necessário criar uma série de diretórios específicos: /etc/gitea para configuração e /var/lib/gitea Para dados, registros e arquivos personalizados. Não se esqueça de ajustar o permissões de propriedade (chown) para que o usuário gitea possa escrever para eles.
Configuração do banco de dados
Se você escolher o PostgreSQL, precisará instalar o pacote e criar uma função específica com uma senha forte, além do banco de dados. giteadb com codificação UTF-8. Se preferir o MariaDB, o processo é semelhante: você cria o banco de dados e o usuário, certificando-se de que o O mecanismo de armazenamento é o InnoDB. e que o servidor está escutando na porta 3306.
Automação com SystemD
Para evitar ter que iniciar o Gitea manualmente sempre que reiniciar o servidor, é melhor criar um arquivo de unidade em /etc/systemd/system/gitea.serviceEste arquivo informa ao sistema que O Gitea deve ser executado como um serviço.Definindo o usuário, o grupo e o caminho do binário. Uma vez criado, basta executar. systemctl enable --now gitea e o servidor começará a escutar, por padrão, na porta 3000.
O primeiro contato com a interface web
Ao entrar http://tu-ip:3000Em seguida, você encontrará o assistente de configuração. É aqui que você conecta o banco de dados (especificando o host, nome de usuário e senha) e define o configurações gerais do site, como o nome da instância e o URL base. Também é hora de configurar o servidor SSH e decidir se você quer que qualquer pessoa possa se registrar ou se prefere... desativar registro público para manter o servidor privado.
Segurança e acesso profissional com Nginx
Acessar o Gitea pela porta 3000 é ineficiente e inseguro. A solução ideal é configurar um proxy reverso com o Nginx . Isso permite que os usuários acessem o site por meio de um domínio (por exemplo, git.seudominio.com) e garante que todo o tráfego seja criptografado usando certificados SSL do Let's Encrypt . Na configuração do Nginx, basta redirecionar o tráfego da porta 443 para a porta 3000 do Gitea, adicionando os cabeçalhos X-Forwarded-For para evitar a perda do endereço IP real do cliente.
Gerenciamento de usuários e migração de código
Se você desativou o registro aberto, pode criar o primeiro administrador usando a linha de comando com o comando gitea admin user createUma vez lá dentro, você poderá adicionar o seu chaves SSH públicas No perfil do usuário, é possível clonar repositórios sem precisar digitar a senha todas as vezes. Se você já tem código no GitHub, o Gitea oferece uma opção adicional. ferramenta de migração integrada Ele importa automaticamente não apenas o código, mas também os problemas e as tags.
Manutenção e ajuste
A manutenção do Gitea é incrivelmente fácil. Para atualizar, basta baixar o novo binário, substituir o antigo e reiniciar o serviço. Para backups, use o comando gitea dump é seu melhor amigo, já que gera um arquivo compactado com tudoBanco de dados, configuração e repositórios. Para e-mail, você pode configurar um servidor SMTP externo (como o Gmail) ou instalar o Postfix no servidor para receber notificações de solicitações de pull e alertas.
Implementar o Gitea permite que você tenha uma plataforma de controle de versão robusta, leve e totalmente privada, eliminando a dependência de serviços externos por meio de uma instalação baseada em binários, um banco de dados otimizado e um proxy reverso que garante a segurança do tráfego via HTTPS.