> For the complete documentation index, see [llms.txt](https://help.goorm.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.goorm.io/ko/goormide/workspace/features/url-port.md).

# URL/Port

### 도메인

도메인은 웹 애플리케이션 혹은 GUI 애플리케이션을 브라우저에서 확인할 수 있도록 도와줍니다. 구름IDE는 컨테이너별로 독립된 도메인을 제공합니다. 따라서 별도의 도메인을 구입하여 설정할 필요가 없습니다.

### 애플리케이션 실행하기

명령어 혹은 터미널에서 작성한 애플리케이션을 실행합니다. 애플리케이션이 정상적으로 실행되었는지 터미널 패널을 통해 확인하고, 애플리케이션이 실행된 포트 번호를 확인하세요.

애플리케이션의 포트 번호는 도메인을 등록하는 데 필요합니다.

### 도메인 등록하기

워크스페이스의 상단 메뉴에서 `[컨테이너]` → `[실행 URL과 포트]` 버튼을 클릭하여 도메인 설정창을 엽니다. 여기에서 새 도메인을 등록하거나 등록된 도메인 목록을 확인할 수 있습니다.&#x20;

새 도메인을 등록하기 위해 원하는 URL과 포트 번호를 입력창에 입력하고 `등록` 버튼을 클릭합니다. 일부 소프트웨어 스택에서는 기본 포트에 대한 도메인이 미리 등록되어 있습니다.

같은 포트 번호로 여러 도메인을 등록할 수는 없습니다.

### 커스텀  도메인 등록하기

`mydomain.run.goorm.app`과 같이 구름IDE에서 제공하는 도메인이 아닌 개인의 도메인도 등록하여 사용할 수 있습니다. 커스텀 도메인 등록은 컨테이너 설정 페이지에서 할 수 있습니다.

#### 도메인 등록하기

컨테이너 설정 페이지에서 URL/Port 테이블의 우측 상단에 있는 `추가` 버튼을 클릭하고 `Custom domain`을 선택합니다. 그리고 등록할 도메인을 `www`부터 입력하고, `crt` 파일과 `key` 파일을 압축하여 업로드합니다. 비밀번호가 설정된 인증서의 경우 비밀번호를 파일에 저장하여 함께 업로드해야 합니다.

<figure><img src="/files/y300fwMPjEx61hpbn4mJ" alt=""><figcaption></figcaption></figure>

#### 도메인 연결 설정하기

도메인 관리 서비스의 페이지로 이동하여 도메인의 CNAME을 설정합니다. 컨테이너의 지역 설정에 따라 다른 CNAME을 설정해야 합니다.

* 서울: domain.run.goorm.io
* 오레곤: domain.run-us-west2.goorm.io
* 프랑크푸르트: domain.run-eu-central1.goorm.io
* 뭄바이: domain.run-ap-south1.goorm.io

<figure><img src="/files/MOV0C3rH8ejy9k0jsZL4" alt="" width="375"><figcaption></figcaption></figure>

### 도메인 접속하기

등록한 도메인을 통해 브라우저에서 접속합니다. 그러면 작성한 애플리케이션에 대한 결과물이 브라우저에 나타날 것입니다. HMR(Hot Module Replacement)이 적용되어 있을 경우 브라우저를 새로고침하지 않아도 작성한 코드가 실시간으로 브라우저에 반영됩니다.

`404 에러`페이지가 나타난다면 브라우저에서 도메인을 올바르게 입력했는지 확인하세요.

`Connection Refused` 페이지가 나타난다면 애플리케이션이 정상적으로 실행 중인지, 도메인을 등록할 때 입력한 포트 번호가 올바른지 살펴보세요.
