Problémy s prístupom SSH na serveri Gitea s vlastným

Louise Dubois

Pondelok 20. mája 2024, 15:46:18

Riešenie problémov s prístupom SSH s Gitea
Nedávno som na svojom lokálnom počítači nastavil server Gitea pomocou kontajnera Docker. Na zabezpečenie pripojenia som nakonfiguroval aj reverzný proxy server Nginx s SSL poskytovaným spoločnosťou Certbot.
Napriek tomu, že som nasledoval návody na generovanie kľúčov SSH od Gitea a GitHub, pri pokuse o pripojenie k serveru Gitea som narazil na chyby so zamietnutím povolenia. Tento článok skúma kroky, ktoré som vykonal, a metódy riešenia problémov, ktoré som použil na vyriešenie problémov s prístupom SSH.

Príkaz Popis

ssh-keygen Generuje nový pár kľúčov SSH pre zabezpečené pripojenia.

eval "$(ssh-agent -s)" Spustí agenta SSH na pozadí na správu kľúčov SSH.

ssh-add ~/.ssh/id_rsa Pridá vygenerovaný súkromný kľúč SSH k agentovi SSH.

pbcopy < ~/.ssh/id_rsa.pub Skopíruje verejný kľúč SSH do schránky v systémoch macOS.

xclip -sel clip < ~/.ssh/id_rsa.pub Skopíruje verejný kľúč SSH do schránky na systémoch Linux pomocou xclip.

proxy_pass Smeruje požiadavku na zadaný backend server v konfigurácii Nginx.

paramiko.RSAKey.from_private_key_file Načíta súkromný kľúč RSA zo súboru pomocou Paramiko v Pythone.

paramiko.SSHClient().set_missing_host_key_policy Automaticky pridá kľúč hostiteľa servera bez výzvy používateľa.

chmod 600 ~/.ssh/config Nastaví správne povolenia pre konfiguračný súbor SSH, aby ho zabezpečil.

Príkaz	Popis
ssh-keygen	Generuje nový pár kľúčov SSH pre zabezpečené pripojenia.
eval "$(ssh-agent -s)"	Spustí agenta SSH na pozadí na správu kľúčov SSH.
ssh-add ~/.ssh/id_rsa	Pridá vygenerovaný súkromný kľúč SSH k agentovi SSH.
pbcopy < ~/.ssh/id_rsa.pub	Skopíruje verejný kľúč SSH do schránky v systémoch macOS.
xclip -sel clip < ~/.ssh/id_rsa.pub	Skopíruje verejný kľúč SSH do schránky na systémoch Linux pomocou xclip.
proxy_pass	Smeruje požiadavku na zadaný backend server v konfigurácii Nginx.
paramiko.RSAKey.from_private_key_file	Načíta súkromný kľúč RSA zo súboru pomocou Paramiko v Pythone.
paramiko.SSHClient().set_missing_host_key_policy	Automaticky pridá kľúč hostiteľa servera bez výzvy používateľa.
chmod 600 ~/.ssh/config	Nastaví správne povolenia pre konfiguračný súbor SSH, aby ho zabezpečil.

Riešenie problémov s pripojením SSH

Skripty poskytnuté v predchádzajúcich príkladoch sú navrhnuté tak, aby riešili rôzne aspekty nastavenia a riešenia problémov s autentifikáciou kľúčom SSH pre server Gitea. Prvý skript používa Bash skript na generovanie kľúča SSH , pridajte ho do agenta SSH pomocou a skopírujte verejný kľúč do schránky pomocou jedného z nich alebo xclip. Tieto kroky sú kľúčové na zabezpečenie správneho nastavenia kľúča SSH a jeho dostupnosti na použitie. Druhý skript nakonfiguruje Nginx tak, aby zvrátil požiadavky proxy na server Gitea, čím sa zabezpečí, že SSL sa správne spracuje a požiadavky sa preposielajú správne pomocou .

Skript Python v treťom príklade používa knižnicu Paramiko na testovanie pripojenia SSH. Tento skript načíta súkromný kľúč pomocou a pokúsi sa pripojiť k serveru Gitea. Ak pripojenie zlyhá, zobrazí sa chybové hlásenie, ktoré pomáha diagnostikovať problém. Štvrtý skript zahŕňa aktualizáciu konfiguračného súboru SSH, aby sa zabezpečilo, že sú správne nastavenia. Príkazy ako , , User, a sa používajú na špecifikáciu podrobností pripojenia pre server Gitea. nakoniec nastaví príslušné povolenia pre konfiguračný súbor, aby ho zabezpečil.

Nastavenie overovania kľúčom SSH pre Gitea

Použitie skriptu Bash na konfiguráciu frontendu

# 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

Konfigurácia Nginx Reverse Proxy pre Gitea

Pomocou konfiguračného súboru 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;
    }
}

Diagnostika problémov s pripojením SSH

Použitie skriptu Python na testovanie pripojenia 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')

Aktualizácia konfigurácie SSH pre Gitea

Pomocou konfiguračného súboru 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

Pokročilá správa kľúčov SSH pre Gitea

Ďalším dôležitým aspektom správy kľúčov SSH pre server Gitea je správna manipulácia a rotácia kľúčov. Pravidelné otáčanie kľúčov SSH môže zvýšiť bezpečnosť znížením rizika zneužitia kľúča na neurčito. Nový pár kľúčov môžete vytvoriť pomocou a aktualizujte nastavenia Gitea tak, aby odrážali nový kľúč. Tento postup je rozhodujúci pre udržanie bezpečného prístupu k vášmu serveru v priebehu času. Okrem toho je dôležité zabezpečiť, aby boli vaše kľúče SSH bezpečne uložené a neboli vystavené neoprávneným používateľom. Používajte nástroje ako bezpečne spravovať kľúče v pamäti a vyhnúť sa ponechaniu súkromných kľúčov na disku v nechránenom stave.

Implementácia prísnych povolení na vaše kľúče SSH a konfiguračné súbory je ďalšou vrstvou zabezpečenia. Príkazy ako a obmedziť prístup k týmto súborom, čo sťažuje prístup neoprávnených používateľov. Okrem toho môžete použiť viacfaktorové overenie (MFA) na pridanie ďalšej vrstvy zabezpečenia k používaniu kľúča SSH. Nástroje ako Google Authenticator alebo hardvérové tokeny je možné integrovať do vášho nastavenia SSH, aby si vyžadovali druhú formu overenia, vďaka čomu je neoprávnený prístup ešte náročnejší.

Prečo sa mi zobrazuje chyba „Povolenie odmietnuté“?
Uistite sa, že vaše kľúče SSH sú správne pridané do agenta SSH a že verejný kľúč je pridaný k autorizovaným kľúčom vášho servera Gitea.
Ako vygenerujem nový pár kľúčov SSH?
Použite príkaz na vygenerovanie nového páru kľúčov SSH.
Ako pridám svoj kľúč SSH do ssh-agenta?
Použite príkaz na spustenie agenta a pridať svoj kľúč.
Ako môžem skopírovať svoj verejný kľúč SSH do schránky?
Použite na macOS alebo v systéme Linux.
Čo mám robiť, ak je môj kľúč SSH ohrozený?
Vygenerujte nový pár kľúčov SSH a aktualizujte kľúče na serveri Gitea a všetkých ostatných službách, kde bol kľúč použitý.
Ako môžem nastaviť správne povolenia pre súbory kľúčov SSH?
Použite príkaz na nastavenie správnych oprávnení pre váš súbor súkromných kľúčov.
Prečo vyprší časový limit môjho pripojenia SSH?
Skontrolujte svoje sieťové pripojenie, uistite sa, že server Gitea beží a či je port SSH otvorený a prístupný.
Ako otestujem svoje pripojenie SSH k serveru?
Použite príkaz na testovanie spojenia.

Na záver, vytvorenie spoľahlivého pripojenia SSH k serveru Gitea si vyžaduje starostlivú konfiguráciu kľúčov SSH, nastavenia proxy servera Nginx a prísne bezpečnostné postupy. Dodržiavaním uvedených krokov vrátane generovania a správy kľúčov SSH, nastavenia príslušných povolení a správnej konfigurácie Nginx môžu používatelia zaistiť bezpečné a funkčné nastavenie. Testovanie spojení s nástrojmi ako Paramiko a pravidelné otáčanie kľúčov ďalej zvyšuje bezpečnosť a spoľahlivosť. Riešenie týchto prvkov komplexne pomáha pri riešení problémov s pripojením a udržiavaní bezpečného vývojového prostredia.

Problémy s prístupom SSH na serveri Gitea s vlastným hosťovaním