IT/Git
[Git] Bitbucket에서 Git 클론하는 방법 (Windows & Linux)
jangddu
2025. 7. 10. 18:29
🧾 준비 사항
✅ Bitbucket 계정
✅ Git 설치 완료
✅ 클론할 저장소(퍼블릭 or 프라이빗)
✅ 터미널 (Git Bash, PowerShell, 리눅스 Shell 등)
🪟 Windows에서 Bitbucket 클론하기
1️⃣ Git 설치
아직 설치하지 않았다면 Git 공식 사이트에서 설치:
🔗 https://git-scm.com
설치 완료 후 확인:
git --version
2️⃣ 클론 주소 복사
- Bitbucket 저장소 접속
- 우측 상단 [Clone] 버튼 클릭
- HTTPS 또는 SSH 중 하나 선택하여 주소 복사
예시:
- HTTPS:
https://username@bitbucket.org/teamname/project.git - SSH:
git@bitbucket.org:teamname/project.git
3️⃣ Git Bash 또는 PowerShell에서 클론
✅ HTTPS 방식
git clone https://username@bitbucket.org/teamname/project.git
🔐 프라이빗 저장소라면 →
➡ ID 입력 후
➡ 비밀번호 대신 App Password (토큰) 입력
➡ App Password는 아래에서 생성 가능
👉 Bitbucket App Password 만들기
✅ SSH 방식
1. SSH 키가 없다면 먼저 생성:
ssh-keygen -t ed25519 -C "you@example.com"
2. 공개키 등록:
- cat ~/.ssh/id_ed25519.pub로 키 확인
- Bitbucket → Personal Settings → SSH Keys → Add key
3. 클론 실행:
git clone git@bitbucket.org:teamname/project.git
✅ 한 번 등록하면 이후엔 비밀번호 없이 클론 가능!
🐧 Linux에서 Bitbucket 클론하기
1️⃣ Git 설치
# Debian/Ubuntu
sudo apt update
sudo apt install git -y
# RedHat/CentOS
sudo yum install git -y
설치 확인:
git --version
2️⃣ 클론 주소 복사 (동일)
Bitbucket 저장소 → Clone → 주소 복사
- HTTPS or SSH 선택
3️⃣ 터미널에서 클론 실행
✅ HTTPS 방식
git clone https://username@bitbucket.org/teamname/project.git
🔐 프라이빗 저장소인 경우 → App Password(토큰)을 비밀번호 대신 입력해야 함
✅ SSH 방식
1. SSH 키 생성:
ssh-keygen -t ed25519 -C "you@example.com"
2. 공개키 등록:
cat ~/.ssh/id_ed25519.pub
➡ 복사하여 Bitbucket SSH 설정에 붙여넣기
3. 클론:
git clone git@bitbucket.org:teamname/project.git
🔍 클론 후 확인할 명령어들
cd project/ # 클론한 디렉토리로 이동
git status # 변경 사항 확인
git remote -v # 원격 저장소 정보 보기
💡 토큰(App Password) 관련 주의사항
- HTTPS 방식은 더 이상 일반 비밀번호를 허용하지 않음
- 반드시 App Password를 생성해서 사용해야 함
- 생성 경로:
- Bitbucket → Personal Settings → Access Management → App Passwords
✅ 마무리 요약
항목 | HTTPS 방식 | SSH 방식 |
인증 방식 | 사용자명 + App Password 입력 | 공개키 등록 |
보안성 | 보통 | 높음 (추천) |
로그인 필요 | 매번 입력하거나 저장 가능 | 최초 한 번 키 등록 이후 자동 인증 |