Install 우분투 서버에 IntelliJ 설치 및 윈도우에서 원격 실행하기 (JetBrains Gateway)

이노힐

0건 3회
2026-08-01 19:09:29

우분투 서버에 IntelliJ IDEA 설치하고 윈도우에서 원격 접속/실행하는 완벽 가이드

안녕하세요! Innoheal Online입니다.

개발 환경을 구성할 때 강력한 성능의 우분투(Ubuntu) 서버에 실제 빌드와 인덱싱 환경을 몰아주고, 윈도우(Windows) PC에서는 로컬처럼 깔끔하게 IDE 화면만 띄워 작업하고 싶었던 적 많으셨죠? 서버의 풍부한 자원을 활용하면서도 쾌적한 UI 환경을 누리는 것은 많은 개발자의 이상적인 작업 방식입니다.

이번 포스팅에서는 우분투 서버에 IntelliJ IDEA를 설치하고, JetBrains Gateway를 통해 윈도우 PC에서 원격으로 접속하여 실행하는 방법을 완벽하게 정리해 드립니다. 설치 및 연결 과정에서 자주 마주치는 대표적인 에러 2가지의 명확한 해결책도 함께 담았으니 차근차근 따라 해 보세요!

1. 우분투 서버에 Snap으로 IntelliJ IDEA 설치하기

우분투 환경에서 애플리케이션을 가장 손쉽게 관리할 수 있는 방법은 Snap 패키지 관리자를 활용하는 것입니다.

Snap 및 IntelliJ IDEA Ultimate 설치 명령어

먼저 우분투 서버 패키지 목록을 갱신하고 Snap을 설치합니다.

sudo apt update
sudo apt install -y snapd

Snap 설치가 완료되면 다음 명령어로 IntelliJ IDEA Ultimate를 설치합니다.

sudo snap install intellij-idea-ultimate --classic

💡 트러블슈팅: snapd.socket 접속 오류 대처법

Snap 설치 명령어를 입력했을 때 아래와 같은 에러 메시지가 출력되며 진행되지 않는 경우가 있습니다.

error: cannot communicate with server: Post "http://localhost/v2/snaps/intellij-idea-ultimate": dial unix /run/snapd.socket: connect: no such file or directory

원인 및 해결 방법:

이 에러는 Snap 데몬 서비스(snapd)가 제대로 실행되지 않았거나 소켓이 활성화되지 않아 발생합니다. 아래 명령어로 서비스를 즉시 시작하고 부팅 시 자동 실행되도록 설정하면 해결됩니다.

# snapd 서비스 활성화 및 시작
sudo systemctl enable --now snapd

# 소켓 상태 확인
sudo systemctl status snapd.socket

위 명령어를 실행한 후 다시 sudo snap install intellij-idea-ultimate --classic을 입력하시면 정상적으로 설치가 진행됩니다.

2. JetBrains Gateway로 윈도우에서 원격 접속 및 실행하기

우분투 서버에 IDE 설치 준비가 끝났다면, 이제 윈도우 PC에서 접속할 차례입니다. 가장 추천하는 방식은 JetBrains 공식 Remote Development 기술인 JetBrains Gateway를 활용하는 것입니다.

JetBrains Gateway 동작 원리

우분투 서버: 빌드, 인덱싱, 소스코드 처리 등 Heavy한 작업 전담
윈도우 PC: 화면 출력 및 키보드/마우스 입력용 가벼운 클라이언트(Client) 역할

윈도우 PC 설정 및 접속 순서

JetBrains Gateway 실행: 윈도우 PC에 JetBrains Gateway를 설치하여 실행합니다. (이미 윈도우용 IntelliJ가 설치되어 있다면 Welcome 화면의 Remote Development 메뉴를 이용하셔도 됩니다.)
SSH 연결 설정: New Connection (SSH) 옵션을 선택하고, 우분투 서버의 IP 주소, SSH 포트(기본 22), 사용자 이름 및 인증 정보(비밀번호 또는 SSH Key)를 입력합니다.
IDE 및 프로젝트 선택: 성공적으로 연결되면 우분투 서버에 설치된 IntelliJ IDEA Ultimate 버전과 작업할 프로젝트 경로를 지정합니다.
원격 개발 시작: 접속이 완료되면 윈도우 화면에 IDE 인터페이스가 실행되며 로컬 환경과 동일하게 개발을 진행할 수 있습니다.

💡 트러블슈팅: Gateway 설치 중 curl 오류(exit code 6) 대처법

JetBrains Gateway가 우분투 서버로 IntelliJ 압축 파일을 다운로드하는 도중 아래와 같은 오류가 발생할 수 있습니다.

Downloading IDE...
curl: (6) Could not resolve host: download.jetbrains.com (exit code 6)

서버에서 직접 확인을 위해 아래 명령어를 입력해도 동일한 에러가 발생합니다.

$ curl -I https://download.jetbrains.com
curl: (6) Could not resolve host: download.jetbrains.com

원인 및 해결 방법:

curl exit code 6은 DNS 이름 해석 실패(Could not resolve host)를 의미합니다. 우분투 서버가 도메인 이름(download.jetbrains.com)을 IP 주소로 변환하지 못하는 상태입니다.

방법 1: 우분투 서버 DNS 네임서버 설정 수정 (가장 확실한 방법)

우분투 서버의 DNS 설정에 구글 공용 DNS(8.8.8.8, 8.8.4.4) 또는 Cloudflare DNS(1.1.1.1)를 추가해야 합니다.
1. /etc/resolv.conf 파일 확인 및 수정:
  Bash
```
sudo nano /etc/resolv.conf
```
2. 아래 내용을 상단에 추가 후 저장합니다.
  Plaintext
```
nameserver 8.8.8.8
nameserver 1.1.1.1
```
3. 수정 후 테스트 명령어로 동작을 확인합니다.
  Bash
```
curl -I https://download.jetbrains.com
```
  HTTP/2 200 또는 HTTP/1.1 200 OK 응답이 나오면 정상 복구된 것입니다.
방법 2: netplan 설정 변경 (Ubuntu 18.04 LTS 이상 지속 적용 시)

/etc/resolv.conf 재부팅 후 초기화를 방지하려면 Netplan 설정을 통해 영구 적용합니다.
YAML
```
# /etc/netplan/01-netcfg.yaml 예시
network:
  version: 2
  ethernets:
    eth0:
      nameservers:
        addresses: [8.8.8.8, 1.1.1.1]
```
설정 후 sudo netplan apply를 실행합니다.
방법 3: 폐쇄망/오프라인 환경일 경우 (수동 설치)

서버가 외부 인터넷에 연결할 수 없는 환경이라면, 윈도우 PC에서 JetBrains 공식 홈페이지를 통해 Linux용 IntelliJ IDEA Ultimate (.tar.gz) 압축 파일을 직접 다운로드한 뒤, FTP/SFTP로 우분투 서버에 전송합니다. 이후 JetBrains Gateway 연결 화면에서 'Upload installer' 또는 수동 경로 지정을 선택하여 설치할 수 있습니다.

💡 트러블슈팅: sudo: unable to resolve host innohealonline.com: Temporary failure in name resolution

sudo 명령어를 실행할 때 발생하는 unable to resolve host 메시지는 현재 시스템의 호스트 네임(innohealonline.com)이 /etc/hosts 파일에 등록되어 있지 않아서 발생하는 일시적인 경고입니다. 인터넷 연결(DNS) 문제와는 별개이며, sudo 명령어 자체는 정상적으로 실행됩니다.

DNS 문제를 해결하기 위해 가장 먼저 /etc/hosts 파일에 호스트 네임을 등록한 뒤, DNS 설정을 이어서 진행해야 합니다. 아래 순서대로 터미널에 입력해 주세요.

1단계: 호스트 네임 등록 (sudo 경고 해결)

아래 명령어를 실행하여 호스트 파일 편집기를 엽니다. (경고 메시지가 떠도 무시하고 진행됩니다.)
```
sudo nano /etc/hosts
```
파일 맨 아래 줄에 아래 내용을 그대로 추가합니다.
```
127.0.0.1       innohealonline.com
```
Ctrl + O 누른 뒤 Enter로 저장하고, Ctrl + X로 편집기를 종료합니다.

이제 sudo를 입력해도 호스트 네임 관련 경고 메시지가 사라집니다.

2단계: DNS 설정 이어서 진행하기

호스트 파일 수정이 끝났다면, 이전 단계에서 중단되었던 명령어를 다시 실행합니다.

심볼릭 링크 재연결

sudo rm -rf /etc/resolv.conf
sudo ln -sf /run/systemd/resolve/resolv.conf /etc/resolv.conf

시스템 DNS 설정 수정
```
sudo nano /etc/systemd/resolved.conf
```
파일 내부 [Resolve] 항목 아래 DNS=8.8.8.8 1.1.1.1 주석 제거 후 추가 및 저장합니다.

서비스 재시작

sudo systemctl restart systemd-resolved

3. 요약 및 결론

📌 3줄 요약

우분투 서버 설정: Snap 패키지 관리자를 사용해 IntelliJ IDEA Ultimate를 원클릭으로 손쉽게 설치합니다.
윈도우 PC 연결: JetBrains Gateway를 사용해 SSH 기반으로 접속하면 서버 자원을 활용하는 쾌적한 원격 개발 환경이 완성됩니다.
오류 해결: snapd.socket 오류는 서비스 활성화(systemctl)로, curl exit code 6 DNS 오류는 네임서버(8.8.8.8) 등록으로 바로 해결할 수 있습니다.

원격 개발 환경을 구축해두면 로컬 PC의 발열과 소음, 메모리 부족 걱정 없이 우분투 서버의 강력한 성능을 100% 활용할 수 있습니다. 이번 가이드를 통해 한층 더 쾌적한 개발 환경을 만들어 보세요!

과정 중 추가로 궁금한 점이나 막히는 부분이 있다면 언제든 댓글로 남겨주세요. 😊

🔍 SEO 메타 데이터

메타 디스크립션: 우분투 서버에 IntelliJ IDEA를 설치하고 윈도우 PC에서 JetBrains Gateway로 원격 접속하는 방법 가이드. snapd.socket 및 curl exit code 6 DNS 오류 해결법 포함.
추천 태그: #IntelliJ #우분투 #JetBrainsGateway #원격개발 #RemoteDevelopment #Snap #개발환경구축

등록된 댓글이 없습니다.

인기검색어

Intellij IDEA