VS Code로 서버 편하게 쓰기 (Remote-SSH)

VS Code의 Remote-SSH 확장을 쓰면 서버에 코드를 올렸다 내렸다 할 필요 없이, 로컬 편집기에서 작업하듯 서버 안의 파일을 바로 열고 편집하고 터미널까지 쓸 수 있습니다. Linux(SSH) 서버를 쓰신다면 강력 추천합니다.

1. 확장 설치

1. VS Code를 엽니다.
2. 왼쪽 사이드바의 확장 아이콘을 클릭합니다.
3. Remote - SSH 를 검색해서 설치합니다. (Microsoft 제공, ms-vscode-remote.remote-ssh)

2. 서버 등록하기

1. F1 또는 Ctrl+Shift+P (macOS는 Cmd+Shift+P) 로 명령 팔레트를 엽니다.
2. Remote-SSH: Add New SSH Host 를 선택합니다.
3. 아래 형식으로 입력합니다. (계정명, IP주소는 마이페이지 접속 정보로 교체)

ssh 계정명@IP주소

4. SSH 설정 파일을 저장할 위치를 물어보면 기본값(사용자 홈 디렉터리의 ~/.ssh/config)을 선택합니다.

3. 접속하기

1. 다시 명령 팔레트를 열고 Remote-SSH: Connect to Host 를 선택합니다.
2. 방금 등록한 서버를 클릭합니다.
3. 새 창이 뜨면서 서버에 연결을 시도합니다. 비밀번호를 입력하면 됩니다.
4. 연결되면 왼쪽 하단에 서버 정보가 표시됩니다. "폴더 열기"로 원하는 디렉터리를 열면, 이제 로컬 파일처럼 서버 안의 파일을 바로 편집할 수 있습니다.
5. Ctrl+` 로 터미널을 열면 서버 터미널에 바로 접속됩니다.

매번 비밀번호 입력이 귀찮다면

SSH 접속 가이드의 "SSH 키로 비밀번호 없이 접속하기" 를 먼저 설정해두면, VS Code에서도 비밀번호 없이 바로 연결됩니다.

팁

• 여러 서버를 등록해두면 왼쪽 사이드바의 Remote Explorer에서 서버를 바꿔가며 빠르게 전환할 수 있습니다.
• Remote-SSH로 연결된 상태에서 설치한 확장(Python, ESLint 등)은 서버 쪽에 별도로 설치되며, 로컬 환경에는 영향을 주지 않습니다.
• 연결이 느리다면 ~/.ssh/config 에 다음 옵션을 추가해보세요.

Host *
    ServerAliveInterval 60
    Compression yes