✅ SourceTree + GitLab CE 환경 설정
1. SSH 키 생성 및 등록
- 로컬에서 키 생성
```plain text ssh-keygen -t ed25519 -C “you@example.com”
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
1. → ~/.ssh/id_ed25519 (개인키), id_ed25519.pub (공개키)
2. 공개키 등록
- GitLab CE → **User Settings → SSH Keys** → id_ed25519.pub 내용 붙여넣기
---
### **2. SSH Config 작성 (포트 9022 대응)**
~/.ssh/config 파일 생성/수정:
```plain text
Host git.xx.com
HostName git.xx.com
User git
Port 9022
IdentityFile ~/.ssh/id_ed25519
→ 이렇게 해두면 git@git.xx.com:group/repo.git 주소만 써도 자동으로 9022로 접속됨.
3. 연결 테스트
```plain text ssh -T git@git.xx.com
1
2
3
4
5
6
7
8
9
10
11
→ 성공 시:
```plain text
Welcome to GitLab, @username!
4. Git Clone & SourceTree 등록
- Clone (SSH 주소 사용)
plain text git clone git@git.xx.com:username/bitapi.git
- SourceTree → Add Working Copy → 로컬 경로 지정
- 이제 Push/Pull/Fetch 모두 SSH로 동작
5. SourceTree에서 주의할 점
Accounts → GitLab CE 계정 등록은 건너뛴다
(PAT 기반 API 연동 불가)
- 대신 Working Copy만 관리 → 브랜치/커밋/푸시 모두 가능
- Merge Request, 이슈, 아바타 같은 API 기반 기능은 표시 안 됨
6. 추가 팁
- 키 암호(passphrase)를 설정했을 경우 → ssh-agent 실행 + ssh-add ~/.ssh/id_ed25519 등록
- 여러 GitLab CE 서버를 쓰는 경우 → ~/.ssh/config에 Host 블록 여러 개 작성
- SourceTree에서 원격 URL은 반드시 SSH 주소로 (https:// 말고 git@…:)
📌 최종 요약
- GitLab CE + SourceTree 최신 버전 = 계정(Account) 등록 불가
- SSH 키 등록 + SSH Config + Working Copy 추가 방식으로 사용
- Git 기능(Push/Pull/Branch)은 정상 동작
- GitLab API 기능(MR/이슈/프로필)은 불가
This post is licensed under CC BY 4.0 by the author.