1. SSH 키 생성 및 GitHub 등록 (WSL2 기준)
WSL2 환경에서 작업하실 예정이므로, 윈도우 프롬프트가 아닌 **WSL2 터미널(Ubuntu 등)**에서 실행하세요.
- SSH 키 생성: 터미널에 아래 명령어를 입력합니다. (이메일은 본인의 GitHub 계정 이메일로 수정하세요) ssh-keygen -t ed25519 -C "your_email@example.com"
- 파일 저장 위치는 기본값(Enter)으로 두세요.
- Passphrase(암호)는 설정해도 되고, 귀찮다면 Enter로 넘어가도 됩니다.
- 공개 키 복사: 생성된 키 중 .pub로 끝나는 파일의 내용을 확인합니다. cat ~/.ssh/id_ed25519.pub
- 화면에 출력된 ssh-ed25519 ...로 시작하는 긴 문자열을 모두 복사하세요.
- GitHub에 등록:
- GitHub 웹사이트 접속 → Settings → SSH and GPG keys → New SSH key 클릭.
- Title은 'My WSL2' 정도로 적고, Key 부분에 복사한 내용을 붙여넣기 한 뒤 저장합니다.
------------------------------------------------------------------------------------------------------
2. 작업 폴더 설정 추천- 추천 위치: WSL2 내부 파일 시스템인 ~/ (Home) 디렉토리 아래에 폴더를 만드세요.
- 예: /home/사용자이름/projects/
- 이유: 윈도우 드라이브(C:)와 WSL2 사이의 파일 접근은 속도가 매우 느리고, 권한(Permission) 문제가 발생할 수 있습니다. WSL2 내부에 파일을 두는 것이 주피터 노트북 실행 및 Git 속도 면에서 훨씬 유리합니다.
- 추천 위치: WSL2 내부 파일 시스템인 ~/ (Home) 디렉토리 아래에 폴더를 만드세요.
- 현재 user/ 폴더를 말씀하셨는데, 윈도우 사용자 폴더(/mnt/c/Users/...)를 말씀하시는 것이라면 권장하지 않습니다.
-----------------------------------------------------------------------------------------------------------
3. VS Code와 GitHub 저장소 연결
이제 VS Code에서 실제 작업을 시작하는 단계입니다.
-
-
- VS Code에서 WSL 접속: VS Code 왼쪽 하단의 파란색 >< 아이콘을 클릭하고 **'Connect to WSL'**을 선택합니다.
- 저장소 클론(Clone):
- 상단 메뉴 Terminal > New Terminal을 엽니다.
- 위에서 추천한 폴더로 이동한 뒤, GitHub의 SSH 주소를 사용하여 클론합니다. git clone git@github.com:계정명/저장소명.git
- 폴더 열기: File > Open Folder에서 방금 클론한 폴더를 선택해 엽니다.
1. 윈도우 탐색기에서 WSL2 폴더 찾는 법- 방법 1 (직접 입력): 탐색기 주소창에 \\wsl$ 라고 입력하고 Enter를 누르세요. 설치된 배포판(예: Ubuntu) 폴더가 보일 겁니다. 그 안으로 들어가면 home > simchan2 경로를 찾을 수 있습니다.
- 방법 2 (터미널에서 열기): 지금 터미널 화면(/home/simchan2)에서 아래 명령어를 입력해 보세요.이 명령어를 치면 현재 리눅스 디렉토리가 윈도우 탐색기 창으로 바로 열립니다. (매우 편리합니다!)
-
Bash
explorer.exe . - 방법 3 (네트워크 위치): 탐색기 왼쪽 사이드바 맨 아래를 보시면 **'Linux'**라는 고래 아이콘 모양의 항목이 있습니다. 그걸 클릭해서 들어가셔도 됩니다.
2. 작업 폴더 구조 추천- 개발용 통합 폴더 생성:
-
Bash
mkdir ~/projects cd ~/projects - GitHub 저장소별 폴더: 나중에 git clone을 하면 ~/projects/내저장소명 식으로 깔끔하게 정리됩니다.
- /home/simchan2 바로 아래에 파일을 다 두면 나중에 관리가 어려울 수 있으니, 별도의 프로젝트 폴더를 만드는 것을 추천합니다.
- 윈도우와 리눅스는 서로 다른 세상 같지만, 의외로 탐색기에서 아주 쉽게 접근할 수 있습니다.
1. 계정 설정(Account Settings)으로 이동하기- GitHub 화면 오른쪽 맨 위를 보시면 용진님의 **프로필 사진(작은 원)**이 보일 거예요. 그걸 클릭하세요.
- 나오는 메뉴 중에서 아래쪽에 있는 Settings를 클릭하세요. (톱니바퀴 모양 아이콘이 있습니다.)
- 그러면 왼쪽 사이드바 메뉴가 바뀔 겁니다. 거기서 'Access' 섹션 안에 있는 SSH and GPG keys를 찾으실 수 있습니다.
2. 요약 경로
3. SSH 키 등록하기 (복습)- 초록색 버튼인 New SSH key를 누릅니다.
- Title: 'WSL2-Laptop' 처럼 본인이 알아보기 쉬운 이름을 적습니다.
- Key: 아까 WSL2 터미널에서 cat ~/.ssh/id_ed25519.pub 명령어로 확인한 그 긴 문자열을 통째로 복사해서 붙여넣습니다.
- Add SSH key 버튼을 누르면 끝입니다!
- 그 메뉴에 들어가셨다면, 이전에 안내해 드린 단계를 이어서 진행하시면 됩니다.
- GitHub 우측 상단 프로필 클릭 → Settings → 왼쪽 메뉴의 SSH and GPG keys
-
'서버 셋팅' 카테고리의 다른 글
| 네트워크 기본 개념 과 SSH 활용 방법 (0) | 2025.04.25 |
|---|---|
| Docker란 무엇인가요? (1) | 2025.04.23 |
| Nginx vs Apache: 무엇을 선택해야 할까? (1) | 2025.04.23 |
| git commit 했는데 편집기가 열렸을 때 어떻하지? (0) | 2025.04.20 |
| Git Pull 안 될 때 강제로 해결하는 방법 (0) | 2025.04.20 |