Инструкция по настройке Git для GitHub на Windows
Примечание
Гайд предполагает, что имя пользователя на всех компьютерах - "student", а ваше имя - Иванов Иван.
1. Установка Git
Скачайте установщик с https://git-scm.com/download/win Установите с настройками по умолчанию.
2. Базовая настройка
Откройте Git Bash:
git config --global user.name "Иван Иванов"
git config --global user.email "ваша_почта@example.com"
Конфигурация сохраняется в: C:\Users\student\.gitconfig
3. Генерация RSA SSH-ключа
ВАЖНО: Если на компьютере уже есть SSH-ключи, переименуйте новый ключ, чтобы избежать конфликтов.
Выполните команду:
ssh-keygen -t rsa -b 4096 -C "ваша_почта@example.com"
Введите уникальное имя файла, например:
- При запросе:
Enter file in which to save the key - Введите:
C:/Users/student/.ssh/id_rsa_ivan_ivanov
Далее:
- При запросе:
Enter passphrase- введите пароль - При запросе:
Enter same passphrase again- повторите пароль
ПРИМЕЧАНИЕ: При вводе пароля символы не отображаются. Это нормально.
4. Файл SSH config
Создайте/отредактируйте файл: C:\Users\student\.ssh\config
Добавьте конфигурацию:
Host github.com
HostName github.com
User git
IdentityFile ~/.ssh/id_rsa_ivan_ivanov # не забудьте изменить
IdentitiesOnly yes
5. Добавление публичного ключа на GitHub
- Откройте файл:
C:\Users\student\.ssh\id_rsa_ivan_ivanov.pub - Скопируйте всё содержимое
- На GitHub: Settings → SSH and GPG keys → New SSH key
- Вставьте ключ, добавьте название, сохраните
6. Проверка подключения
ssh -T git@github.com
При первом подключении SSH-агент предупредит Вас о соединении с ранее неизвестным хостом. Напишите yes, чтобы доверять хосту.
Затем Вас попросят ввести пароль от SSH-ключа. Введите его.
Если всё хорошо, то должно получиться похожее сообщение:
Hi ivan! You've successfully authenticated, but GitHub does not provide shell access.
7. Работа с репозиториями
Клонирование:
На Github склонируйте ссылку на существующий репозиторий. Напишите в консоль команду в данном формате:
git clone git@github.com:username/repository.git
Создание нового репозитория:
Предварительно создайте репозиторий на своей странице Github. Затем на своем компьютере:
- Создайте папку и войдите в нее. Добавьте новый файл, например файл описания
README.md; - откройте Git Bash / Powershell / терминал VSCode для данной папки, именно для неё;
- выполните команды:
git init
git add .
git commit -m "Initial commit"
git branch -M main
git remote add origin git@github.com:username/repository.git
git push -u origin main
все новые изменения можно отправлять на Github командой git push origin ветка.
8. Проверка существующих ключей
Чтобы проверить, какие SSH-ключи уже есть в системе:
ls -la ~/.ssh/
Файловые пути
- Приватный ключ:
C:\Users\student\.ssh\id_rsa_ivan_ivanov - Публичный ключ:
C:\Users\student\.ssh\id_rsa_ivan_ivanov.pub - Конфиг SSH:
C:\Users\student\.ssh\config - Конфиг Git:
C:\Users\student\.gitconfig
Безопасность
- Используйте уникальные имена для ключей - это предотвратит перезапись существующих;
- никогда не передавайте приватные ключи третьим лицам;
- пароль обеспечивает защиту при утечке файла ключа. Обязательно используйте его;
- для смены пароля используйте команду
ssh-keygen -p -f ~/.ssh/id_rsa_ivan_ivanov
Примечания
- Если ключ с таким именем уже существует, создайте новый с другим именем;
- каждый хостинг можно настроить с отдельным ключом;
- проверьте правильность пути в файле
config