로컬 서버를 외부에 노출 시키기(HTTP, HTTPS) - ngrok

외부에서 무언가를 테스트하는 경우 외부에서 접속하지 못해서 테스트가 힘든 경우가 있습니다.

프로그램에 따라서 손이 많이 가는 세팅을 해야 하는 경우도 있죠.

 

저 같은 경우 "ASP.NET Core"를 테스트할 때 이문제에 직면하죠 ㅎㅎㅎ

(IISExpress, Kestrel 공통)

특히 모바일과 같은 다른 플랫폼을 디버깅 하고 싶을 때 많이 발생합니다.

 

이럴 때 사용하는 2차도 메인이나 임시 URL을 생성해주는 서비스가 "ngrok"입니다.

 

로컬 서버를 외부에 노출 시키기 - iisexpress-proxy
로컬 서버를 외부에 노출 시키기 - ngrok

 

 

"ngrok"는 무료입니다.

유료 버전이 있긴 한데....제한 사항이 테스트하는 용도로는 없다싶이합니다.

 

 

1. 다운로드 및 실행

"ngrok" 사이트에 접속해서 프로그램을 다운받습니다.

참고 : ngrok - https://ngrok.com/, Docs

 

압축을 풀고 실행 파일을 실행해 봅시다.

 

"ngrok"의 설명이 나옵니다.

 

2. 사용하기

실행하면 나오는 콘솔 창에 간단한 사용 방법이 나와 있는데...

로컬서버를 외부로 노출하려는 목적이라면 이 정도 설명으로도 충분합니다 ㅎㅎㅎㅎ

 

내부에서 사용 중인(= 외부에 노출하고 싶은) 프로토콜과 포트를 지정하면 됩니다.

ngrok [프로토콜] [포트]

예> http의 5000번 포트를 노출하고 싶다 => ngrok http 5000

 

정확한 명령어를 입력하면 생성된 2차 도메인을 확인 할 수 있습니다.

'http://63f146a51b72.ngrok.io'로 생성되었다.

 

 

윈도우의 기본 콘솔은 복사할 내용을 드레그한 다음 엔터를 치면 클립보드에 복사됩니다.

 

 

 

3. 테스트하기

이제 생성된 주소로 접속해보면 서버에 접속되는 것을 확인할 수 있습니다.

 

잘 접속됩니다.

 

 

4. 'HTTPS' 적용하기

별도의 설정 없이 'HTTPS'를 포워딩하려고 하면 에러가 납니다.

어떻게 설정해야 하는지 알아봅시다.

 

4-1. 오류

HTTPS는 그냥 사용하면 다음과 같은 에러가 납니다.

ERR_NGROK_3004
ngrok gateway error The server returned an invalid or incomplete HTTP response.

 

4-2. 인증 토큰 생성 및 등록

'HTTPS'를 포워딩하려면 'ngrok'에 가입해서 인증 토큰을 받아야 합니다.

참고 : ngrok - 대시보드 > Your Authtoken

 

 

토큰을 받았으면 ngrok를 실행하고 아래와 같이 입력하여 인증토큰을 등록해 줍니다.

ngrok authtoken [발급받은 인증 토크]


예>
ngrok authtoken abCDd1213

 

 

4-3. 'HTTPS' 포워딩하기

'HTTP'와 다르게 주소형식으로 넣어야 합니다.

 

아래 명령어를 입력해 줍니다.

ngrok http https://[호스트]:[포트]

예>
ngrok http https://localhost:44414

 

정상적으로 주소가 생성되었으면 아래와 같은 화면이 나옵니다.

 

4-4. 테스트

이제 생성된 주소로 들어가 보면 'ngrok.com'을 통해 서비스되고 있다는 안내문이 나옵니다.

'Visit Site' 버튼을 눌러 들어가면 'HTTP' 때와 마찬가지로 정상적으로 접속되는걸 볼 수 있습니다.

 

 

'Your account is limited to 1 simultaneous ngrok agent' 오류

포워딩을 다시 하려고 하면 다음과 같은 에러가 날 때가 있습니다.

ERROR: Your account is limited to 1 simultaneous ngrok agent session.
ERROR: Active ngrok agent sessions in region 'jp':
ERROR: - [생성된 고유키] ([IP])
ERROR:
ERROR:
ERR_NGROK_108
ERROR:

한 번에 한 개의 에이전트만 허용한다는 에러입니다.

 

보통은 실행 중인 'ngrok.exe'를 끄면 세션도 같이 종료되는데 어떤 이유에서인지 세션이 살아 있으면 볼 수 있는 에러입니다.

 

이런 경우 'ngrok.com'에 접속해서 

Tunnels > Agents

로 들어가면 살아 있는 에이전트를 볼 수 있습니다.

 

여기서 'Stop' 버튼을 누르면 해당 에이전트가 죽으면서 연결된 세션도 같이 죽게 됩니다.

 

세션이 죽으면 오류가 사라집니다.

 

 

마무리

아주 오래전부터 하위 URL을 자동으로 생성하여 포워딩하는 방식으로 로컬 서버를 외부에 노출할 수 있을 거 같은데....

라는 생각을 했었습니다.

그런데 2차 도메인을 자동으로 생성하여 서비스하는 방법이 있었군요.

 

같은 도메인은 같은 사이트로 구분하기 때문에 제 아이디어대로 구현하면 문제가 생깁니다.

이걸 2차 도메인으로 해결하네요 ㅎㅎㅎㅎ

 

특히 모바일 디바이스에서 직접 테스트할 때 너무 좋습니다.