🧩 Инструкция по настройке SSH для Git и Gitea в Windows
📘 1. Проверка установленного OpenSSH
Windows 10+ уже включает OpenSSH. Открой PowerShell и выполни:
ssh -V
Если появится версия (например, OpenSSH_for_Windows_8.1p1), значит всё готово. Если команда не найдена — установи компонент:
Add-WindowsCapability -Online -Name OpenSSH.Client~~~~0.0.1.0
🔑 2. Генерация пары SSH-ключей
В PowerShell:
ssh-keygen -t ed25519 -C "your_email@example.com"
Рекомендации:
Нажми Enter, чтобы сохранить ключи в стандартное место:
C:\Users\<Имя_пользователя>\.ssh\id_ed25519
Введи (по желанию) пароль для защиты ключа.
📁 3. Проверка наличия файлов
После генерации должны быть файлы:
C:\Users\<Имя>\.ssh\id_ed25519
C:\Users\<Имя>\.ssh\id_ed25519.pub
🧭 4. Добавление ключа в SSH-агент
Запусти агент:
Start-Service ssh-agent
Set-Service -Name ssh-agent -StartupType Automatic
ssh-add "$env:USERPROFILE\.ssh\id_ed25519"
🧱 5. Добавление публичного ключа в Gitea
Открой Gitea: https://git.bolapansoft.com
Перейди: Профиль → Settings → SSH / GPG Keys → Add Key
Вставь содержимое файла:
Открой в любом текстовом редакторе файл C:\Users<Имя>.ssh\id_ed25519.pub, скопируй его содержимое и вставь в поле Add Key.
Альтернативно, скопировать содержание файла в буфер обмено можно командой PowerShell:
Get-Content "$env:USERPROFILE\.ssh\id_ed25519.pub"
⚙️ 6. Настройка Git для использования OpenSSH
Убедись, что Git использует системный SSH:
git config --global core.sshCommand "C:/Windows/System32/OpenSSH/ssh.exe"
Проверка:
git config --global --get core.sshCommand
🧾 7. Настройка файла .ssh\config
Создай (если нет) файл:
C:\Users\<Имя>\.ssh\config
Добавь запись:
Host git.bolapansoft.com
HostName git.bolapansoft.com
User git
IdentityFile C:\Users\<Имя>\.ssh\id_ed25519
IdentitiesOnly yes
🧩 8. Проверка подключения
ssh -T git@git.bolapansoft.com
Если всё корректно:
Hi <username>! You've successfully authenticated, but Gitea does not provide shell access.
🐢 9. Настройка TortoiseGit
Открой TortoiseGit → Settings → Network
В поле SSH client укажи путь:
C:\Windows\System32\OpenSSH\ssh.exe
Убедись, что репозитории используют SSH-URL, например:
git@git.bolapansoft.com:MyProject.git