Sourcetree(https://www.sourcetreeapp.com) 설치 후 계정 연결과 비밀번호 인증 오류

Sourcetree 맥·윈도우 최신판과 받을 파일

Sourcetree는 맥판과 윈도우판이 따로 개발됩니다. 그래서 판 번호가 서로 다릅니다.

두 판 모두 무료입니다. 공식 누리집 첫 화면에는 맥판 다운로드 버튼과 'Also available for Windows' 링크가 함께 있습니다. 한국어 페이지(/ko/)도 있습니다.

윈도우판은 3.4.25부터 Git 2.51.0과 Git LFS 3.7.0을 내장했습니다. 3.4.8부터는 .NET Framework 4.8 기반입니다.

윈도우판 최신 3.4.32에서는 OAuth 갱신 토큰 회전 지원과 윈도우 자격 증명 관리자에 저장된 큰 토큰 처리가 추가됐고, 같은 이름의 폴더를 가진 저장소 두 개를 동시에 열지 못하던 문제가 고쳐졌습니다. 맥판 4.2.19에서는 Mercurial 연결에 TLS 1.2 이상을 강제하도록 바뀌었습니다.

Sourcetree 설치 순서와 첫 설정

공식 설치 안내의 순서입니다.

1. Sourcetree 누리집에서 다운로드 버튼을 누릅니다.
2. 윈도우는 EXE, 맥은 ZIP을 풀어 나온 앱을 실행합니다.
3. 아틀라시안 고객 계약에 동의하고 Continue 를 누릅니다.
4. 아틀라시안 계정으로 로그인합니다. 계정이 없으면 Go to My Atlassian 에서 만듭니다.
5. 원격 호스팅 서비스를 쓰려면 기본 옵션 그대로 계정 정보를 넣습니다.
6. 저장소를 바로 복제할 준비가 안 됐으면 Skip Setup 을 누릅니다.

• 계정 — 아틀라시안 계정 (설치 안내 기준)
• SSH 키 단계에서 막힘 — HTTPS 선택 후 계속
• 복제 준비 전 — Skip Setup
• 새로 시작 — 로컬 저장소 만들기
• 이미 있는 저장소 — 로컬 저장소 추가
• 원격 저장소 — 계정 연결 후 복제

설치 안내는 저장소를 쓰는 방법을 세 갈래로 나눕니다. 처음 시작하면 컴퓨터에 새 저장소를 만들고, 이미 있는 저장소는 추가해서 보고, 원격 저장소는 계정을 연결한 뒤 내 컴퓨터로 복제합니다.

Sourcetree 원격 계정 연결 — HTTPS와 SSH

원격 저장소를 쓰려면 호스팅 서비스 계정을 Sourcetree에 연결합니다.

1. 더보기(•••)를 누르고 Accounts 를 고릅니다.
2. Accounts 탭에서 Add 를 누릅니다.
3. Host 를 고르고 호스팅 정보를 넣습니다.
4. Auth Type 은 기본값 그대로 두고 Connect Account 를 눌러 자격 증명을 넣습니다.
5. HTTPS와 SSH 가운데 연결 방식을 고릅니다.

• HTTPS — 자격 증명(앱 비밀번호·토큰)으로 연결
• SSH — SSH 키를 먼저 만들어 등록해야 함
• SSH 키 단계에서 막힐 때 — HTTPS로 바꿔 계속 (공식 안내)
• SSH 안내 — 공식 문서 'Set up an SSH key'
• 계정 수 — 여러 개 추가 가능
• 윈도우 SSH 에이전트 — 외부 ssh-agent 쓰면 AutoStartSSHAgent 끄기 (3.4.32)

윈도우판 3.4.32 릴리스 노트에는 OpenSSH를 쓰면서 외부 ssh-agent 를 쓸 수 있도록 AutoStartSSHAgent 를 끌 수 있게 고쳤다는 항목이 있습니다. 3.4.24에서는 SSH-Agent.exe 가 CPU를 많이 쓰던 문제가 고쳐졌습니다.

Sourcetree 비밀번호 인증 오류 — 앱 비밀번호·API 토큰

원격 연결에서 가장 많이 막히는 지점입니다. 계정 비밀번호를 그대로 넣으면 인증이 실패합니다.

• 윈도우 3.4.15 — Bitbucket 비밀번호 인증 폐지 → 앱 비밀번호 사용
• 윈도우 3.4.24 — API 토큰 인증 지원 추가
• 맥 4.2.13 — Bitbucket API 토큰 지원 (Git·REST API)
• 윈도우 3.4.32 — OAuth 갱신 토큰 회전 지원
• 계정 비밀번호 — 인증에 쓰지 않음
• 넣을 것 — 호스팅 서비스에서 발급한 앱 비밀번호·토큰

윈도우판 3.4.15 릴리스 노트에는 'Bitbucket 기본 인증이 비밀번호로 실패한다'는 문제가 '비밀번호는 이제 폐지됐으니 앱 비밀번호를 쓰라'는 설명과 함께 올라 있습니다. 같은 판에서 Bitbucket Server 계정을 추가할 때 앱 비밀번호를 묻던 문제도 고쳐졌습니다.

그 뒤 윈도우판 3.4.24(2025년 7월)와 맥판 4.2.13에서 API 토큰 인증이 들어갔습니다. 인증이 실패하면 계정 비밀번호 대신 호스팅 서비스 설정에서 발급한 토큰을 넣습니다.

Sourcetree 기업용 설치와 이전 판 받기

회사에서 여러 컴퓨터에 깔 때는 Windows Enterprise판을 씁니다.

• 설치 파일 — MSI (SourcetreeEnterpriseSetup_3.4.32.msi 등)
• 설치 폴더 — 지정 가능
• 조용한 설치 — 지원
• 업데이트 — 배포 시점을 회사가 중앙에서 관리
• 로그인 — 별도 가입 없이 Bitbucket Data Center 자격 증명
• 이전 판 — 다운로드 보관함 (옛 판은 지원 안 될 수 있음)

Enterprise판은 컴퓨터 관리 소프트웨어로 조직 전체 윈도우 PC에 설치·업데이트를 배포하기 위한 판입니다. 화면과 기능은 일반판과 같다고 공식 페이지가 설명합니다.

새 판에서 문제가 생기면 누리집 아래 'Download archive'에서 이전 판을 받을 수 있습니다. 맥은 1.9.8부터, 윈도우는 3.4.18 이후 판이 크기와 날짜, 릴리스 노트와 함께 올라 있습니다. 다만 보관함 페이지는 옛 판이 더 이상 지원되지 않을 수 있다며 수명 종료 정책을 보라고 안내합니다. 엔터프라이즈 MSI도 판별로 같은 보관함에 있습니다.

Sourcetree 주요 기능과 보안 업데이트

공식 누리집이 소개하는 주요 기능입니다.

• 저장소 종류 — Git, Mercurial
• 스테이징 — 파일·덩어리(hunk)·줄 단위로 스테이징·되돌리기
• 대용량 파일 — Git LFS
• 브랜치 전략 — Git-flow 기본 지원
• 고급 기능 — 대화형 리베이스, 스태시, 체리픽, 서브모듈
• 검색 — 커밋·파일 변경·브랜치 검색

윈도우판 3.4.24부터는 선택하거나 스테이징한 파일만 골라 스태시할 수 있습니다.

윈도우판 릴리스 노트에는 악성 Mercurial 저장소를 열거나 복제할 때 임의 코드가 실행될 수 있던 취약점을 고친 이력이 여러 번 올라 있습니다. 내장 압축 도구와 Git, Git LFS도 보안 문제 때문에 여러 차례 판을 올렸습니다.

원격 저장소 관리 화면에서는 연결한 계정의 원격 저장소를 검색하고 바로 복제할 수 있습니다.