proxer server

proxer server는 공개 HTTP/WebSocket 리스너와 터널 제어 엔드포인트를 하나의 포트에서 시작합니다.

---

사용법

proxer server --listen 0.0.0.0:8080 --domain your-server.example.com --token dev-token

---

옵션

• --listen <address> — 리슨 주소입니다. 기본값은 0.0.0.0:8080입니다.
• --domain <domain> — 루트 및 서브도메인 경로를 추출할 공개 루트 도메인입니다.
• --token <token> — 터널 클라이언트와 공유하는 토큰입니다. 생략하면 토큰이 없는 클라이언트와만 일치합니다.
• --trusted-proxy <proxy> — 신뢰할 reverse proxy preset, IP, CIDR입니다. 여러 값을 지정하려면 flag를 반복합니다.

신뢰 프록시 preset:

• loopback — loopback 주소
• private — 사설 IPv4 대역과 unique-local IPv6 대역

---

환경변수

• PROXER_LISTEN — --listen 기본값
• PROXER_DOMAIN — --domain 기본값
• PROXER_TOKEN — --token 기본값
• PROXER_TRUSTED_PROXIES — comma-separated 신뢰 프록시 값

CLI flag가 환경변수보다 우선합니다.

---

내부 엔드포인트

서버는 다음 고정 경로를 예약합니다.

/__proxer__/control
/__proxer__/health/live
/__proxer__/health/ready

제어 경로는 설정할 수 없습니다.

---

참고

공개 서버에서 직접 실행하거나 원래 Host 헤더를 보존하는 reverse proxy 뒤에서 실행하세요. 알 수 없는 호스트는 404를 반환합니다.