GitHubs nuvarande SSH-felsökningsdokumentation, kontrollerad 13 september 2026, behandlar fortfarande Permission denied (publickey)som ett autentiseringsfel: GitHub avvisade SSH-anslutningen eftersom den inte accepterade en användbar offentlig nyckel för kontot och anslutningen du presenterade. Det snabbaste sättet att åtgärda det är att verifiera anslutningen i en specifik ordning istället för att omedelbart ta bort nycklar eller generera nya. GitHubs officiella felsökningssida för denierad behörighet (publickey) rekommenderar att du kontrollerar servern, SSH-användaren, nyckeln som erbjuds och om den matchande offentliga nyckeln är kopplad till ditt konto.
En bra reparation har två observerbara resultat. För det första ssh -T git@github.comidentifierar den det GitHub-konto du avsåg att använda och rapporterar lyckad autentisering. För det andra fungerar det faktiska repository-kommandot – som git fetch, git pull, git pusheller git clone– med det repository du har behörighet att komma åt. Att endast klara det första testet bevisar SSH-autentisering, inte repository-behörighet.
| Kontrollera | Hälsosamt resultat | Om det misslyckas |
|---|---|---|
| Fjärr-URL | Användningsområdengit@github.com:OWNER/REPOSITORY.git | Korrigera värden eller SSH-användaren innan du byter nycklar |
| Lokala nyckelfiler | Ett stödt offentligt/privat nyckelpar finns | Generera ett nytt nyckelpar endast om du inte har ett du tänker använda |
| SSH-agent | ssh-add -l -E sha256listar den avsedda nyckeln | Starta agenten och lägg till den privata nyckeln |
| GitHub-konto | Den matchande publika nyckeln visas under SSH- och GPG-nycklar | Lägg till den offentliga nyckeln till rätt konto; auktorisera den för SSO vid behov |
| Autentiseringstest | GitHub hälsar det förväntade användarnamnet | Använd utförlig SSH-utdata för att se vilken nyckel som faktiskt erbjuds |
| Databasoperation | Hämta, pull, push eller klona lyckas | Kontrollera åtkomst till arkiv, kontoidentitet, SSO, fjärr-URL eller nätverksbegränsningar |
Innan du trycker på tangenterna, bekräfta att du ansluter till GitHub.com och att SSH-användarnamnet bokstavligen är git. GitHub dokumenterar att SSH-anslutningar till GitHub.com måste använda gitanvändaren, inte ditt personliga GitHub-användarnamn. Ett kommando som ssh -T yourname@github.comförväntas misslyckas.
git remote -v
ssh -vT git@github.comFör en vanlig GitHub.com SSH-fjärrkontroll bör URL:en se ut så här:
git@github.com:OWNER/REPOSITORY.gitOm fjärrkontrollen är fel, korrigera den med Gits fjärrkonfiguration istället för att generera inloggningsuppgifter på nytt:
git remote set-url origin git@github.com:OWNER/REPOSITORY.gitUndvik också att köra vanliga Git-kommandon med sudoeller med förhöjda privilegier. GitHub noterar att detta kan få Git att köras under en annan användarmiljö och därför använda andra SSH-nycklar än de du konfigurerat. Målet i detta skede är enkelt: utförlig utdata ska visa ett anslutningsförsök till github.comport 22, såvida du inte avsiktligt konfigurerat HTTPS-portlösningen som beskrivs senare.
Kontrollera din lokala SSH-katalog innan du skapar något nytt. GitHubs nuvarande riktlinjer rekommenderar att du först letar efter ett befintligt nyckelpar som stöds.
ls -al ~/.ssh
Vanliga standardfilnamn för offentliga nycklar inkluderar id_ed25519.pub, id_ecdsa.puboch id_rsa.pub. GitHub stöder inte längre DSA-nycklar. Om du redan har ett nyckelpar som du tänker använda för GitHub, behåll det och fortsätt med agentkontrollen.
ssh-add -l -E sha256Ett felfritt resultat listar ett eller flera fingeravtryck. Om den avsedda nyckeln inte laddas, starta SSH-agenten enligt din miljö och lägg till den privata nyckeln:
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519
I Windows beror det exakta agent-start-kommandot på om du använder Git Bash, Windows OpenSSH, PowerShell eller en annan miljö. GitHubs officiella guide för nyckelgenerering och ssh-agent ger plattformsspecifika instruktioner. Följ avsnittet för den SSH-klient du faktiskt använder; att blanda Git för Windows SSH med Windows OpenSSH är en vanlig källa till förvirring.
Generera en endast när den tidigare kontrollen visar att du inte har en lämplig nyckel som du vill använda. GitHubs nuvarande instruktioner rekommenderar Ed25519 för en standardnyckel för programvaruversionen när den stöds:
ssh-keygen -t ed25519 -C "your_email@example.com"Använd en lösenfras om det passar dina säkerhetskrav. SSH-agenten kan cachelagra den upplåsta privata nyckeln för din session. Ladda aldrig upp eller klistra in själva den privata nyckelfilen i GitHub; filen som slutar på .pubär den publika nyckeln som är avsedd för kontoregistrering.
Att ha en lokal nyckel räcker inte. GitHub måste ha den matchande publika nyckeln associerad med kontot som ska autentiseras. Visa den publika nyckeln och kopiera sedan hela raden:
cat ~/.ssh/id_ed25519.pubI GitHub, öppna Inställningar , sedan SSH- och GPG-nycklar , välj Ny SSH-nyckel eller Lägg till SSH-nyckel , välj en autentiseringsnyckel och klistra in den publika nyckeln. Dessa etiketter matchar GitHubs nuvarande officiella dokumentation för att lägga till en SSH-nyckel .
Jämför fingeravtryck när du är osäker på vilken lokal nyckel som motsvarar posten på GitHub:
ssh-add -l -E sha256Om arkivet tillhör en organisation som använder SAML-single sign-on kanske det inte räcker att lägga till nyckeln till ditt konto. GitHub dokumenterar att en SSH-nyckel också kan kräva organisationsauktorisering. I Inställningar > SSH- och GPG-nycklar använder du Konfigurera SSO för nyckeln och auktoriserar relevant organisation när den kontrollen är tillgänglig. Se GitHubs guide för SSH-nyckel SSO-auktorisering .
Använd inte git pushsom enda test. Testa SSH direkt:
ssh -T git@github.com
Meddelandet om lyckad autentisering bör mötas av ditt GitHub-användarnamn och förklara att GitHub inte tillhandahåller shell-åtkomst. GitHub noterar också att det här testet kan avslutas med statuskod 1 även när autentiseringen lyckas, så bedöm det utifrån autentiseringsmeddelandet snarare än att förvänta dig ett normalt interaktivt shell.
Om testet fortfarande slutar på Permission denied (publickey), kör verbose-läget:
ssh -vT git@github.comLeta efter rader som Offering public key. Om loggen aldrig erbjuder den nyckel du förväntade dig är problemet lokalt nyckelval eller agentkonfiguration. Om den avsedda nyckeln erbjuds men avvisas, kontrollera om den offentliga nyckeln är kopplad till rätt GitHub-konto och om SSO-auktorisering krävs.
Om du använder arbets- och privata konton på samma dator kan lyckad SSH-autentisering fortfarande hamna på fel konto. GitHub-dokument använder IdentitiesOnly=yeseller en specifik identitetsfil för att kontrollera vilken nyckel SSH erbjuder. För en engångsdiagnostik:
ssh -v -o "IdentitiesOnly=yes" -i ~/.ssh/work_ed25519 git@github.comOm GitHub får fel användarnamn har du hittat felaktigheten. Konfigurera separata nycklar eller värdalias istället för att upprepade gånger ta bort och lägga till nycklar igen. GitHubs officiella guide för flera konton behandlar detta fall mer i detalj.
När ssh -T git@github.comdu autentiserar dig som den förväntade användaren, försök igen med den faktiska databasåtgärden:
git fetch origin
git pull
git push
Om SSH-autentiseringen lyckas men Git nu rapporterar ett arkivspecifikt behörighetsfel, sluta ändra SSH-nyckeln. Vid den tidpunkten har nyckeln redan gjort sitt jobb. Kontrollera att det autentiserade kontot har åtkomst till arkivet, att ägaren och arkivnamnet i fjärr-URL:en är korrekta och att en organisation har beviljat den erforderliga rollen. GitHubs separata felsökningssida för arkivbehörigheter förklarar fallet där nyckeln tillhör ett konto utan åtkomst.
En brandvägg eller proxy kan förhindra att en giltig SSH-konfiguration når GitHub på port 22. Testa GitHubs dokumenterade SSH-över-HTTPS-slutpunkt:
ssh -T -p 443 git@ssh.github.comVärdnamnet är ssh.github.com, inte github.com, för detta direkta port-443-test. Om det fungerar dokumenterar GitHub denna SSH-konfiguration:
Host github.com
Hostname ssh.github.com
Port 443
User gitTesta sedan igen med ssh -T git@github.com. Se GitHubs guide för SSH över port 443 . Den här lösningen gäller inte alla GitHub Enterprise-miljöer, och proxyservrar kan fortfarande störa.
| Vad du observerar | Vad det betyder | Nästa drag |
|---|---|---|
ssh-add -lvisar ingen avsedd nyckel | Klienten kan inte erbjuda rätt privat nyckel | Åtgärda agenten eller nyckelsökvägen |
Utförlig SSH visas aldrig Offering public keyför din avsedda nyckel | SSH-valet är felaktigt | Använd -i, IdentitiesOnly=yes, eller korrigera~/.ssh/config |
| Den avsedda nyckeln erbjuds men avvisas | GitHub accepterar inte den nyckeln för den försökta identiteten | Kontrollera den uppladdade offentliga nyckeln, målkontot och SSO-auktoriseringen |
| SSH hälsar fel GitHub-användarnamn | Nyckeln till ett annat konto används | Separera kontonycklar och välj explicit den avsedda identiteten |
| SSH lyckas, men arkivet avvisar push eller hämtning | Autentisering fungerar; arkivauktorisering eller URL är nu problemet | Kontrollera åtkomst till arkivet och fjärrägande |
| Port 22 kan inte ansluta alls | Nätverket kan blockera standard SSH | Testa port 443 eller använd HTTPS |
Genererar nyckel efter nyckel utan att kontrollera vad SSH erbjuder. Fler nycklar kan göra valet svårare. Använd ssh -vToch ssh-add -l -E sha256först.
Använd ditt GitHub-användarnamn före @github.com. GitHubs SSH-slutpunkt förväntar sig SSH-användaren git. Din GitHub-identitet bestäms av den offentliga nyckel som GitHub känner igen.
Laddar upp den privata nyckeln. Gör inte detta. GitHub behöver det publika .pubvärdet; den privata nyckeln finns kvar på din dator eller i godkänt nyckellager.
Förutsatt att ett lyckat SSH-test garanterar push-åtkomst. Det bevisar kontoautentisering. Arkivauktorisering är en separat kontroll.
Ignorerar SSO. Organisationsresurser kan kräva ytterligare SSH-nyckelauktorisering även om nyckeln finns i ditt personliga konto.
Använda förhöjda Git-kommandon. Att köra Git som en annan OS-användare kan ändra vilken hemkatalog, SSH-konfiguration, agent och nycklar som används.
SSH är inte obligatoriskt. GitHub stöder även HTTPS-fjärrstyrningar. Om ett låst företagsnätverk, en policy för hanterad slutpunkt eller en proxy gör SSH opraktiskt, kan det vara enklare att byta fjärrstyrningen av arkivet till HTTPS än att bekämpa nätverket. Det är en ändring av autentiseringsmetoden, inte en reparation av SSH-konfigurationen, så använd den när din miljö gör SSH oönskad snarare än som ett sätt att dölja en olöst nyckelmatchningsfel.
För SSH är den mest tillförlitliga stopppunkten evidensbaserad: den förväntade nyckeln laddas, GitHub känner igen den som det förväntade kontot, organisationen auktoriserar den vid behov och den verkliga Git-operationen lyckas. Om en av dessa kontroller misslyckas, ändra endast det lager som misslyckades. Det håller felsökningsprocessen under kontroll och undviker att fungerande nycklar byts ut i onödan.
Åtgärda Tailwind CSS-stilar som inte uppdateras i Vite React genom att kontrollera Tailwind v4-inställningar, CSS-importer, källkodsidentifiering, dynamiska klasser, HMR och inaktuella cacher.
Åtgärda Python 3:s ModuleNotFoundError för pip på Windows, macOS och Linux med ensurepip, OS-paket, virtuella miljöer och tolkkontroller.
Åtgärda GitHub SSH-behörighet nekad (publickey) genom att kontrollera värden, aktiv SSH-nyckel, GitHub-konto, SSO-auktorisering, fjärr-URL och port 22-åtkomst.
Åtgärda en Git-push som inte snabbspolar framåt på ett säkert sätt. Skydda lokalt arbete, hämta fjärrcommits, välj merge eller rebase, lös konflikter och pusha utan att förlora ändringar.
Åtgärda Nginx 502 Bad Gateway-fel med en Node.js-uppström genom att kontrollera appporten, NGINX-loggarna, proxy_pass-adressen, containernätverk, timeouts och omladdning.
Fix TypeScript's “Type 'null' is not assignable to type” error with union types, narrowing, defaults, and safe assertions under strictNullChecks.
Åtgärda felet att Prisma Client inte har genererats genom att kontrollera din generator, ditt schema, utdatasökvägen, importerna, versionerna, monorepo-konfigurationen och byggstegen vid distribution.
Åtgärda Node.js ERR_MODULE_NOT_FOUND i ESM genom att kontrollera importsökvägar, filtillägg, paketinstallation, exporter, ESM-läge och rena installationer.
Åtgärda Gits fel 'unable to get local issuer certificate' genom att identifiera förtroendebakgrunden, installera rätt CA-kedja och hålla SSL-verifieringen aktiverad.
Åtgärda MongoDB-nätverksavbrott i Mongoose genom att identifiera avbrottstypen, testa Atlas- eller TCP-anslutning, korrigera URI:n och justera tidsgränser endast när det är motiverat.
