시작하기
몇 분 안에 Proxer를 설치하고 로컬 HTTP 서비스를 노출합니다.
준비물
섹션 제목: “준비물”- HTTP/WebSocket 트래픽을 받을 수 있는 공개 서버
- 노출할 로컬 HTTP 서비스
- npm으로 설치하는 경우 Node.js 24 이상
GitHub Releases에서 Windows용 독립 실행 파일을 내려받습니다.
proxer.exe --versionbrew install tinyrack-net/tap/proxernpm은 모든 플랫폼에서 사용할 수 있는 범용 설치 방법입니다.
npm install -g @tinyrack/proxerdocker run --rm tinyrack/proxer --version처음 시작하기
섹션 제목: “처음 시작하기”처음 Proxer를 사용한다면 다음 순서로 공개 서버 하나를 띄우고 로컬 서비스 하나를 노출합니다.
-
공개 서버 시작
공개 트래픽을 받을 서버에서 Proxer를 실행합니다.
proxer server --listen 0.0.0.0:8080 --domain your-server.example.com --token dev-token이 서버는 같은 포트에서 공개 요청과 터널 제어 연결을 모두 처리합니다.
-
로컬 앱 시작
클라이언트 머신에서 HTTP 서비스를 실행합니다. 아래 예시는 Python 내장 서버를 사용합니다.
python3 -m http.server 3000 --bind 127.0.0.1 -
루트 도메인 터널 연결
--subdomain을 생략하면 루트 도메인 경로로 등록됩니다.proxer http 3000 \--server ws://your-server.example.com:8080 \--token dev-token -
루트 경로 테스트
curl -H 'Host: your-server.example.com' http://your-server.example.com:8080/ -
서브도메인 경로 사용
이름이 있는 경로가 필요하면
--subdomain을 지정합니다.proxer http 3000 \--server ws://your-server.example.com:8080 \--subdomain demo \--token dev-tokencurl -H 'Host: demo.your-server.example.com' http://your-server.example.com:8080/
다음에 볼 문서
섹션 제목: “다음에 볼 문서”터널이 동작했다면 다음 가이드를 살펴보세요.
- 동작 방식 — 제어 연결과 요청 흐름 이해하기
- 라우팅과 신뢰 프록시 — 루트 도메인, 서브도메인, reverse proxy 설정
- Docker — OCI 이미지로 공개 서버 실행하기
- proxer server — 서버 명령어 레퍼런스
- proxer http — 터널 클라이언트 명령어 레퍼런스