Skip to content

Latest commit

 

History

History
101 lines (67 loc) · 2.86 KB

How_to_Expose_a_Private_Web_Server_to_External_Access.md

File metadata and controls

101 lines (67 loc) · 2.86 KB

외부에서 비 공개된 내부의 웹서버에 접근하기

공개 IP가 없어서 외부에서 접속할 수 있도록 하기 위해 LocalTunnel을 이용해 로컬 API 서버를 외부 클라이언트와 테스트할 수 있도록 한다.

1. Node.js 설치

LocalTunnel은 Node.js 기반 CLI 도구라, 먼저 Node.js가 설치되어야 한다.

설치 절차

  1. Node.js 공식 사이트에 접속한다.

  2. LTS (Long Term Support) 버전을 다운로드하여 설치한다.

  3. 설치 후 터미널(cmd 또는 PowerShell)을 열고 버전 확인:

    node -v
npm -v

🔹 2. LocalTunnel 설치

전역으로 설치한다.

npm install -g localtunnel

설치가 완료되면 다음 명령으로 정상 설치를 확인한다.

lt --help

3. 로컬 서버 실행

예를 들어 API 서버가 포트 8080에서 실행 중이라고 가정한다.

python -m http.server 8080

또는

node app.js

4. LocalTunnel로 외부 노출

이제 LocalTunnel을 실행한다.

lt --port 8080

결과 예시:

your url is: https://calm-bear-42.loca.lt

이제 https://calm-bear-42.loca.lt 주소를 외부 클라이언트에게 알려주면 된다. 클라이언트는 이 URL을 통해 로컬 서버로 접근할 수 있다.

5. 고정 서브도메인(선택)

테스트 시 주소가 매번 바뀌면 불편하므로, 아래처럼 고정 서브도메인을 지정할 수 있다 (단, 가끔 중복될 수 있음).

lt --port 8080 --subdomain myapitest

→ 결과 예시: https://myapitest.loca.lt

만약 해당 이름이 이미 사용 중이면 다른 이름을 지정해야 한다.

6. 클라이언트에서 테스트

예를 들어 API 서버가 /api/hello 엔드포인트를 제공한다고 하면:

curl https://myapitest.loca.lt/api/hello

또는 Postman으로 GET https://myapitest.loca.lt/api/hello 요청을 보내면 된다.

7. 주의사항

  • LocalTunnel 서버가 종료되면 URL이 더 이상 유효하지 않다.
  • 테스트 중 방화벽이 외부 트래픽을 차단할 수 있으니, Windows 방화벽 팝업이 뜨면 허용해야 한다.
  • LocalTunnel은 HTTPS를 기본으로 제공한다.

✅ 요약

단계 명령어 설명
Node.js 설치 nodejs.org LTS 버전 설치
LocalTunnel 설치 npm install -g localtunnel 전역 설치
서버 실행 예: node app.js 로컬 서버 구동
외부 노출 lt --port 8080 터널 생성
고정 서브도메인(선택) lt --port 8080 --subdomain myapitest 고정 주소 생성