오늘은 Windows 11에서 ngrok을 설치하고 사용하는 방법에 대해 자세히 안내해 드리겠습니다. ngrok은 로컬 서버를 외부에서 접근할 수 있게 해주는 유용한 터널링 도구입니다. 특히 개발 중인 웹사이트나 API를 간편하게 테스트할 때 매우 유용합니다.
ngrok이란 무엇인가요?
ngrok은 개발자가 로컬 환경에서 개발한 웹 애플리케이션을 인터넷을 통해 쉽게 공개할 수 있도록 지원하는 무료 터널링 도구입니다. 예를 들어, 로컬에서 HTTP 서버를 구동 중이라면 이를 외부에서 접근 가능하게 만들어 줍니다. 특히 ngrok은 개발자, 디자이너, 그리고 테스터들이 프로젝트를 다른 사람들과 빠르고 간편하게 공유할 수 있도록 도와줍니다.
Windows 11에서 ngrok 설치하기
Windows 11에서 ngrok을 설치하여 사용하려면 홈페이지에서 설치파일을 내려받은 후 환경변수에 등록하여 인증하여 사용할 수 있습니다. 아래에 각 단계별로 자세하게 설명드리겠습니다.
ngrok다운로드
ngrok 홈페이지에 접속한뒤 계정이 없다면 계정을 개설하고 계정이 있다면 로그인합니다. (홈페이지 링크)
인증토큰 복사하기
ngrok에 로그인하면 구성파일 인증토큰 명령어가 나오는데 이를 복사해둡니다.
ngrok 설치파일 내려받기
Download 탭에서 'Download for Windows (64-bit)'를 클릭하여 설치파일을 내려받은 후 압축을 해제합니다.
환경변수 등록하기
윈도우 시작메뉴의 '시스템 환경 변수 편집'을 검색하여 실행합니다.
시스템 속성창이 나타나면 '환경 변수(N)...'를 클릭합니다.
시스템 변수(S) 섹션에 Path변수를 선택한뒤 '편집(I)...'를 클릭합니다.
- 새로 만들기(N)를 클릭합니다.
- ngrok 실행 파일의 압축을 해제한 폴더 경로를 입력합니다. (사진 예:C드라이브 ngrok폴더에 ngrok.exe 가 있을 경우)
- 확인을 눌러 변경사항을 저장합니다.
인증토큰 추가하기
명령프롬포트 창(Win + R > cmd 입력)을 실행한 뒤 앞서 복사해 두었던 인증토큰 명령어를 붙여 넣습니다.
ngrok 실행하기
이제 ngrok을 사용하여 로컬 서버를 외부에 노출시킬 수 있습니다. 예를 들어, 로컬에서 8080 포트를 열어두고 있다면 아래와 같이 명령어를 실행해 주세요.
ngrok http 8080
실행이 완료되면 터미널에 표시되는 Forwarding URL을 복사하여 브라우저에 입력하면 외부에서도 로컬 서버에 접근할 수 있게 됩니다.
ngrok 활용 사례
- 웹 개발 시 테스트: 클라이언트에게 개발 중인 웹사이트를 실시간으로 보여줄 때 유용합니다.
- Webhook 테스트: 외부 API 서비스가 로컬 서버로 데이터를 전송해야 하는 경우 매우 유용하게 사용할 수 있습니다.
- 모바일 앱 백엔드 연결 테스트: 로컬 서버에서 실행 중인 API와 모바일 앱을 연결하여 실제로 동작하는지 테스트할 수 있습니다.