Problemas de acesso SSH com servidor Gitea auto-hospedado

Configurando autenticação de chave SSH para Gitea

Usando script Bash para configuração de front-end

# Step 1: Generate SSH Key
ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
# Step 2: Start the ssh-agent in the background
eval "$(ssh-agent -s)"
# Step 3: Add your SSH key to the ssh-agent
ssh-add ~/.ssh/id_rsa
# Step 4: Copy the SSH key to clipboard
pbcopy < ~/.ssh/id_rsa.pub
# If using xclip
xclip -sel clip < ~/.ssh/id_rsa.pub

Configurando o proxy reverso Nginx para Gitea

Usando o arquivo de configuração Nginx

server {
    listen 80;
    server_name your_domain;
    return 301 https://$host$request_uri;
}
server {
    listen 443 ssl;
    server_name your_domain;
    ssl_certificate /etc/letsencrypt/live/your_domain/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/your_domain/privkey.pem;
    location / {
        proxy_pass http://localhost:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

Diagnosticando problemas de conexão SSH

Usando um script Python para testar a conectividade SSH

import paramiko
def test_ssh_connection(host, port, username, key_path):
    k = paramiko.RSAKey.from_private_key_file(key_path)
    c = paramiko.SSHClient()
    c.set_missing_host_key_policy(paramiko.AutoAddPolicy())
    try:
        c.connect(hostname=host, port=port, username=username, pkey=k)
        print("SSH connection successful")
    except Exception as e:
        print(f"Failed to connect: {e}")
    finally:
        c.close()
test_ssh_connection('your_domain', 22, 'your_username', '/path/to/id_rsa')

Atualizando a configuração SSH para Gitea

Usando arquivo de configuração SSH

# Open SSH config file
nano ~/.ssh/config
# Add the following configuration
Host gitea_server
    HostName your_domain
    User your_username
    IdentityFile ~/.ssh/id_rsa
# Save and exit
chmod 600 ~/.ssh/config
# Test SSH connection
ssh -T gitea_server

Perguntas comuns e soluções para problemas de acesso SSH

1. Por que estou recebendo um erro de “Permissão negada”?
2. Certifique-se de que suas chaves SSH sejam adicionadas corretamente ao agente SSH e que a chave pública seja adicionada às chaves autorizadas do seu servidor Gitea.
3. Como faço para gerar um novo par de chaves SSH?
4. Use o comando ssh-keygen -t rsa -b 4096 -C "your_email@example.com" para gerar um novo par de chaves SSH.
5. Como adiciono minha chave SSH ao agente ssh?
6. Use o comando eval "$(ssh-agent -s)" para iniciar o agente e ssh-add ~/.ssh/id_rsa para adicionar sua chave.
7. Como posso copiar minha chave pública SSH para a área de transferência?
8. Usar pbcopy < ~/.ssh/id_rsa.pub no macOS ou xclip -sel clip < ~/.ssh/id_rsa.pub no Linux.
9. O que devo fazer se minha chave SSH estiver comprometida?
10. Gere um novo par de chaves SSH e atualize as chaves no seu servidor Gitea e em todos os outros serviços onde a chave foi usada.
11. Como posso definir as permissões corretas nos meus arquivos de chave SSH?
12. Use o comando chmod 600 ~/.ssh/id_rsa para definir as permissões adequadas em seu arquivo de chave privada.
13. Por que minha conexão SSH está expirando?
14. Verifique sua conexão de rede, certifique-se de que o servidor Gitea esteja funcionando e que a porta SSH esteja aberta e acessível.
15. Como faço para testar minha conexão SSH com o servidor?
16. Use o comando ssh -T your_username@your_domain para testar a conexão.

Etapas finais para proteger a conexão SSH

Concluindo, estabelecer uma conexão SSH confiável com um servidor Gitea requer configuração cuidadosa de chaves SSH, configurações de proxy Nginx e práticas de segurança rigorosas. Seguindo as etapas descritas, incluindo geração e gerenciamento de chaves SSH, definição de permissões apropriadas e configuração correta do Nginx, os usuários podem garantir uma configuração segura e funcional. Testar conexões com ferramentas como Paramiko e girar chaves regularmente aumenta ainda mais a segurança e a confiabilidade. Abordar esses elementos de forma abrangente ajuda a resolver problemas de conexão e a manter um ambiente de desenvolvimento seguro.