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️⃣ 클론 주소 복사

  1. Bitbucket 저장소 접속
  2. 우측 상단 [Clone] 버튼 클릭
  3. HTTPS 또는 SSH 중 하나 선택하여 주소 복사

예시:

 

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 입력 공개키 등록
보안성 보통 높음 (추천)
로그인 필요 매번 입력하거나 저장 가능 최초 한 번 키 등록 이후 자동 인증