Как GitHub узнаёт, кто пришёл
Все ходят на один адрес — [email protected], пользователь всегда git. Кто именно пришёл, GitHub решает
по ключу: ключ аккаунта — это аккаунт со всеми его репозиториями, deploy key — один репозиторий.
Поэтому разные доступы на одном компьютере — это разные ключи, а выбирает ключ ~/.ssh/config
через псевдонимы:
git@github-infra:example-user/infra-web1.git → Host github-infra → ключ infra_deploy → один репозиторий
[email protected]:example-user/notes.git → Host github.com → id_ed25519 → личный аккаунт
git@github-work:work-org/app.git → Host github-work → id_work → рабочий аккаунт
Deploy key: сервер видит один репозиторий
Сервер с git pull в /opt («Конфиги серверов в git») должен читать свой репозиторий — и только его. Ключ личного аккаунта
открыл бы все репозитории, а при взломе сервера — их все сразу («Каждый ключ и токен — на один доступ»).
Создаём ключ на сервере
sudo ssh-keygen -t ed25519 -f /root/.ssh/infra_deploy -C "deploy web1 infra-web1" -N ""Без пароля (
-N ""):git pullзапускается без человека. Это допустимо, потому что ключ открывает один репозиторий, а запись можно не давать. Ключ — у root, потому что/optпринадлежит root.Добавляем в репозиторий
sudo cat /root/.ssh/infra_deploy.pub # ssh-ed25519 AAAAC3Nza… deploy web1 infra-web1На GitHub: репозиторий, Settings, Deploy keys, Add deploy key. «Allow write access» — только если сервер будет делать
push; по правилу «на сервере толькоgit pull» не включаем.Псевдоним в ~/.ssh/config root
# /root/.ssh/config Host github-infra HostName github.com User git IdentityFile /root/.ssh/infra_deploy IdentitiesOnly yesПроверяем вход: для deploy key GitHub здоровается именем репозитория:
sudo ssh -T github-infra # Hi example-user/infra-web1! You've successfully authenticated, but GitHub does not provide shell access.Адрес репозитория — через псевдоним
cd /opt sudo git remote set-url origin git@github-infra:example-user/infra-web1.git sudo git pull
Два аккаунта на одном компьютере
Второй ключ — для рабочего аккаунта
ssh-keygen -t ed25519 -f ~/.ssh/id_work -C "work laptop-2026".pubдобавляем в рабочий аккаунт GitHub (Settings, SSH and GPG keys).Псевдоним
# ~/.ssh/config — выше блока Host * Host github-work HostName github.com User git IdentityFile ~/.ssh/id_work IdentitiesOnly yes Host github.com IdentityFile ~/.ssh/id_ed25519 IdentitiesOnly yesIdentitiesOnly yesу обоих: иначе агент предложит первый подошедший ключ, и GitHub пустит не тем аккаунтом.Рабочие репозитории — через псевдоним и со своей почтой
git clone git@github-work:work-org/app.git ~/work/appПочта для всех репозиториев в
~/work/— черезincludeIfв~/.gitconfig(«~/.gitconfig по блокам»):# ~/.gitconfig-work [user] email = [email protected]
Подпись коммитов SSH-ключом
С git 2.34 коммиты подписываются SSH-ключом, GPG не нужен. GitHub показывает у таких коммитов «Verified»:
коммит сделал владелец ключа, а не кто-то, кто вписал чужое имя в user.name.
Включаем подпись
git config --global gpg.format ssh git config --global user.signingKey ~/.ssh/id_ed25519.pub git config --global commit.gpgSign true git config --global tag.gpgSign trueuser.signingKey— путь к открытой половине: подписывает агент закрытой («ssh-agent»), пароль ключа второй раз не спросят.Ключ подписи — в GitHub
Settings, SSH and GPG keys, New SSH key, тип Signing Key. Тот же
.pub, что для входа, но отдельной записью: ключ входа подписи не проверяет.Проверка подписи у себя
Без списка доверенных ключей
git log --show-signatureпишетerror: gpg.ssh.allowedSignersFile needs to be configured and exist for ssh signature verificationиNo signature, хотя подпись есть. Список — в файле:mkdir -p ~/.config/git echo "[email protected] namespaces=\"git\" $(cat ~/.ssh/id_ed25519.pub)" \ >> ~/.config/git/allowed_signers git config --global gpg.ssh.allowedSignersFile ~/.config/git/allowed_signers
Если не работает
ERROR: The key you are authenticating with has been marked as read only.
- Причина
- Deploy key добавлен без «Allow write access», а с сервера делают
git push. - Делаем
- Так и задумано, если сервер только читает. Если сервер должен пушить — включаем запись у этого ключа в настройках репозитория.
GitHub не даёт добавить ключ: Key is already in use
- Причина
- Один ключ — один deploy key одного репозитория или ключ одного аккаунта. Повторно его не принимают.
- Делаем
- Для второго репозитория — свой ключ и свой псевдоним в
~/.ssh/config.
Push идёт под другим аккаунтом: Permission to work-org/app.git denied to example-user
- Причина
sshпредложил первый подошедший ключ — личный. GitHub узнаёт аккаунт по ключу, а не по адресу.- Делаем
- Псевдоним
github-workсIdentityFileиIdentitiesOnly yes, и адрес репозитория — через него:git remote set-url origin git@github-work:work-org/app.git.
Коммиты на GitHub подписаны чужим именем или без аватара
- Причина
- В коммите почта, которой нет в аккаунте: в рабочем репозитории осталась личная, или наоборот.
- Делаем
includeIfс другой почтой для~/work/(«~/.gitconfig по блокам»); проверка —git config user.emailв каталоге репозитория.
error: gpg failed to sign the data
- Причина
- Включена подпись (
commit.gpgSign), а формат осталсяopenpgp: git ищетgpgи ключ GPG. - Делаем
git config --global gpg.format sshиuser.signingKey— путь к.pub.
У подписанных коммитов на GitHub — «Unverified»
- Причина
- Ключ добавлен в GitHub как ключ входа (Authentication), а для подписи нужна отдельная запись Signing Key. Или почта коммита не подтверждена в аккаунте.
- Делаем
- Settings, SSH and GPG keys, New SSH key, тип Signing Key — тот же
.pub.
Как проверить
Каждый псевдоним приводит в свой аккаунт:
ssh -T [email protected]
# Hi example-user! You've successfully authenticated, but GitHub does not provide shell access.
ssh -T github-work
# Hi work-user! You've successfully authenticated, but GitHub does not provide shell access.
Последний коммит подписан:
git log --show-signature -1 --format='%h %s'
# Good "git" signature for [email protected] with ED25519 key SHA256:u7WT…
# 3e2d1c traefik: readTimeout 300s