오늘 새로산 컴퓨터에 GitHub 를 연결 하기위해 SSH 연결을 시도하면서 배운 내용들을 정리 해보았습니다 !
TIL - Git & GitHub SSH 연결과 초기 세팅 (윈도우/Mac 공통)
🔹 Git 설치 및 기본 설정
Git 설치 확인
git --version
Git 설치하기
- 윈도우 👉 Git 다운로드 링크
- 맥 👉 Homebrew 이용
brew install git
Git 사용자 정보 설정
git config --global user.name "your-name"
git config --global user.email "your-email@example.com"
설정 확인
git config --list
🔹 GitHub 연결을 위한 SSH 키 생성
SSH란?
- SSH(Secure Shell)는 서버와 안전하게 연결하는 프로토콜.
- GitHub와 암호 없이 편리하고 안전하게 연결할 수 있음.
키 생성하기
- Mac
ssh-keygen -t ed25519 -C "your-email@example.com"
pbcopy < ~/.ssh/id_ed25519.pub
- 윈도우 (Git Bash 사용)
ssh-keygen -t ed25519 -C "your-email@example.com"
clip < ~/.ssh/id_ed25519.pub
GitHub에 SSH 키 등록하기
- GitHub 로그인 → 우측 상단 프로필 → Settings
- 왼쪽 메뉴 SSH and GPG keys → New SSH key
- 복사한 키 붙여넣고 저장
연결 테스트
ssh -T git@github.com
성공하면 다음 메시지 확인:
Hi your-username! You've successfully authenticated, but GitHub does not provide shell access.
🔹 GitHub Repository 연결하기
프로젝트 폴더 초기화
git init
원격 저장소 연결 (GitHub에서 repo 생성 후)
git remote add origin git@github.com:your-username/your-repo.git
파일 커밋 및 GitHub에 업로드
git add .
git commit -m "Initial commit"
git branch -M main
git push -u origin main
🔹 .gitignore 추천 설정
NestJS 기준 기본 설정:
node_modules
dist
.env
🔹 문제가 생겼을 때 점검사항
문제확인사항
Permission denied 오류 | SSH 키 생성, GitHub 키 등록, SSH 에이전트 키 추가 |
HTTPS로 연결된 경우 SSH로 변경 | git remote set-url origin git@github.com:your-username/your-repo.git |
🔹 SSH와 HTTPS 언제 사용하나?
구분 | 특징 | 사용상황 |
SSH | 암호 없이 빠르고 안전한 연결 | 개인 프로젝트, 개인 PC |
HTTPS | 암호/토큰 필요 | 공용 PC, 임시 환경 |
취업 준비 시 GitHub 활용도 중요! 꾸준히 사용하여 친숙하게 만들자.
'Cooperation > Github' 카테고리의 다른 글
백엔드 개발자 협업 (Convention,Githubsetting,gitignore,workflow) (0) | 2025.05.20 |
---|