Docker

OCI 이미지는 Docker Hub의 tinyrack/proxer와 GHCR의 ghcr.io/tinyrack-net/proxer로 게시됩니다.

이미지 버전을 확인합니다.

docker run --rm tinyrack/proxer --version

---

서버 실행

docker run --rm -p 8080:8080 tinyrack/proxer \
  server \
  --listen 0.0.0.0:8080 \
  --domain proxy.example.com \
  --token dev-token

서버는 볼륨이 필요하지 않습니다. 터널 등록 정보는 메모리에 있고, 클라이언트가 재연결하면 다시 만들어집니다.

---

Docker Compose

services:
  proxer:
    image: ghcr.io/tinyrack-net/proxer:latest
    command:
      - server
      - --listen
      - 0.0.0.0:8080
      - --domain
      - proxy.example.com
    environment:
      PROXER_TOKEN: dev-token
      PROXER_TRUSTED_PROXIES: loopback,private
    ports:
      - "8080:8080"
    healthcheck:
      test: ["CMD", "proxer", "--version"]
      interval: 30s
      timeout: 5s
      retries: 3

---

Kubernetes 헬스 체크

플랫폼에서 HTTP 경로를 probe할 수 있다면 고정 헬스 엔드포인트를 사용합니다.

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

제어 엔드포인트도 고정입니다.

/__proxer__/control

---

환경변수

서버는 PROXER_ 환경변수로 설정할 수 있습니다.

docker run --rm -p 8080:8080 \
  -e PROXER_DOMAIN=proxy.example.com \
  -e PROXER_TOKEN=dev-token \
  -e PROXER_TRUSTED_PROXIES=loopback,private \
  ghcr.io/tinyrack-net/proxer server

컨테이너가 직접 제어하는 reverse proxy에서 트래픽을 받는다면 --trusted-proxy 또는 PROXER_TRUSTED_PROXIES를 설정하세요.