** 서비스 호스팅 시 최소지연으로 국내 서버에 직접 띄워 쓸 수 있는 오픈소스 Cloudflare Tunnel 대안입니다. SSL 인증서 자동발급, 각종 보안 기능, SSO·접근 제어·감사 기능도 지원합니다.
GitHub: https://github.com/lawnect/meerkat
Cloudflare Tunnel을 쓰면서 국내 서버 호스팅 -> 국내 서버 접속인데도 LA나 홍콩을 경유해 지연이 300ms 이상 추가되는 경우를 겪었습니다.
이 문제를 해결하기 위해 공개 진입점을 국내 서버에 직접 두고 사용할 수 있도록 만들었습니다. 사설 서버의 Connector가 rathole을 통해 공개 서버의 Outlet으로 연결되므로, 사설 앱의 인바운드 포트를 열 필요가 없습니다(CF 터널과 동일, 따라서 아웃렛 vm 인스턴스 하나는 필요합니다).
Oracle Cloud Ampere 1 OCPU, RAM 4GB 환경에서 (내부테스트 포함) 약 한 달간 운영했을 때 Outlet 처리시간은 평균 0.28ms, p95 0.82ms였습니다. (네트워크와 앱 응답시간을 포함한 전체 지연이 아니라 Outlet 내부 처리시간입니다.)
사내 서비스 운영을 위한 기능
기업 환경의 접근 통제와 기록, 운영 편의도 고려했습니다.
- TLS 인증서 자동 발급·갱신 (Caddy 이용)
- 특정 주소나 경로에 OIDC SSO 또는 별도 Bearer 토큰을 요구하는 Access 정책
- 관리자 페이지 접속 IP 제한 등 보안 기능
- 관리 작업 감사 기록, 접속·실패 기록과 Telegram 알림
유사 프로젝트와의 차이
- Cloudflare Tunnel: 이용법 또는 구성은 유사합니다. 일부 국내 통신망에서 Cloudflare 접속이 LA·홍콩 등 해외를 경유할 수 있는 반면, Meerkat은 국내에 Outlet을 직접 두어 해당 우회 경로를 거치지 않도록 구성할 수 있습니다.
- Pangolin: 유사하지만, Meerkat은 Go 백엔드와 Svelte 관리 화면으로 가벼운 구성을 지향하며 HTTP 서비스 공개에 초점을 맞췄습니다. 라이선스는 Pangolin Community Edition의 AGPL-3.0과 달리 Meerkat 자체 코드에 MIT를 적용했습니다. (참고로 포함된 rathole과 Caddy는 각각 Apache-2.0 라이선스입니다)
설치하기
먼저 작업 중인 컴퓨터에서 저장소를 내려받고 공개 서버(이하 outlet)에 설정 파일을 복사합니다. user@SERVER는 실제 SSH 접속 주소로 바꿔 주세요.
git clone https://github.com/lawnect/meerkat.git cd meerkat ssh -t user@SERVER \ 'sudo install -d -o "$(id -u)" -g "$(id -g)" -m 700 /opt/meerkat-outlet' scp deploy/compose.outlet.yaml \ user@SERVER:/opt/meerkat-outlet/이어서 outlet에서 초기 설정을 만들고 실행합니다.
docker run --rm --user "$(id -u):$(id -g)" \ --entrypoint /usr/local/bin/outlet-init \ -v /opt/meerkat-outlet:/out \ ghcr.io/lawnect/meerkat:latest -dir /out cat > /opt/meerkat-outlet/compose.env <<EOF MEERKAT_DEPLOY_DIR=/opt/meerkat-outlet MEERKAT_UID=$(id -u) MEERKAT_GID=$(id -g) MEERKAT_BIND_ADDRESS=0.0.0.0 MEERKAT_IMAGE=ghcr.io/lawnect/meerkat:latest EOF docker compose --env-file /opt/meerkat-outlet/compose.env \ -f /opt/meerkat-outlet/compose.outlet.yaml up -d관리 화면은 설정 전에는 공개 포트로 열리지 않습니다. 작업 컴퓨터에서 SSH 포트 포워딩을 한 뒤 https://localhost:18443에 접속해 초기 설정을 진행합니다.
ssh -N -L 18443:127.0.0.1:18443 user@SERVER서버의 /opt/meerkat-outlet/configs/admin.token에 있는 설정 코드로 관리자를 만들고, 관리 화면에서 사용할 도메인을 등록합니다. 초기 관리 화면은 사설 CA 인증서를 사용하므로 인증서 지문을 확인하거나 해당 CA를 신뢰해야 합니다.
(다만, 보안상 SSO 구성을 추천드립니다)
간단한 사용 예시
사설 서버의 Docker 네트워크에서 실행 중인 웹 앱 app:80을 app.example.com으로 공개하려면:
- app.example.com의 DNS A 레코드를 Outlet 서버로 지정합니다.
- 관리 화면에서 터널을 만들고, 표시되는 Connector 설치 명령을 사설 서버에서 실행합니다.
- Connector와 앱이 통신할 수 있도록 같은 Docker 네트워크에 연결합니다.
- 관리 화면에서 서비스 대상으로 app:80, 공개 주소로 app.example.com을 등록합니다.
- 필요한 경우 해당 주소에 SSO나 토큰 인증을 요구하는 Access 정책을 추가합니다.
이후 외부에서 https://app.example.com으로 앱에 접속할 수 있습니다. (이때 Connector 설치 코드에는 비밀 토큰이 들어 있으므로 주의가 필요합니다)
자세한 설치 및 운영 방법: 한국어 가이드
현재 한계
공개 서버를 직접 운영해야 하므로 서버 관리, 업데이트와 백업도 직접 챙겨야 합니다. 현재 Outlet 자체는 단일 인스턴스이고, 대규모 네트워크 공격 방어를 Cloudflare처럼 대신해 주는 도구는 아닙니다.
비슷한 네트워크 문제를 겪으신 분들이나 직접 운영하는 터널이 필요하셨던 분들의 의견을 듣고 싶습니다. 사용해 보시고 개선할 점이나 놓친 부분이 있다면 편하게 알려 주세요!