ServBay에서 Pinggy로 로컬 웹사이트 및 서비스 외부 공개하기

Pinggy는 매우 간단하게 사용할 수 있는 내트워크 터널링(내부망 관통) 도구로, 리버스 프록시 기술을 활용해 ServBay 환경 등 로컬에서 실행 중인 웹 서비스를 안전하게 공개 인터넷에 노출할 수 있도록 합니다. 이 가이드는 ServBay 환경에서 Pinggy를 활용해 개발자가 로컬 웹 서비스를 외부에서 접근 가능하도록 하는 전체 과정을 설명합니다. 원격 데모, 팀 협업, Webhook 요청 처리 등 다양한 상황에 사용할 수 있습니다.

기술 원리

Pinggy의 핵심 원리는 안전한 SSH 터널을 구축하는 것입니다. 로컬(방화벽/NAT 뒤에 있을 수 있음)에서 서비스 중인 포트를 SSH 연결을 통해 Pinggy의 공개 서버로 포워딩합니다. 외부 사용자가 Pinggy에서 할당된 URL에 접속하면, 요청이 이 터널을 통해 로컬 서비스로 안전하게 전달됩니다.

즉, ServBay 환경에서는 로컬 웹사이트(https://myproject.servbay.demo 등)을 Pinggy를 통해 복잡한 포트포워딩이나 방화벽 설정 없이 쉽게 외부로 노출할 수 있습니다.

환경 준비

Pinggy는 로컬에 별도의 클라이언트 프로그램 설치 없이 사용할 수 있습니다. 준비물은 아래와 같습니다.

ServBay 설치 및 실행: ServBay 환경이 올바르게 설치 및 실행 중이어야 하며, 외부 노출을 원하는 웹사이트 또는 서비스가 정상 동작해야 합니다.
운영 중인 ServBay 사이트: ServBay에서 하나 이상의 로컬 웹사이트가 구성되고 실행되어 있어야 합니다. 이들 사이트는 ServBay 내장 Caddy 또는 Nginx 서버를 통해 보통 80(HTTP), 443(HTTPS) 포트에서 대기합니다.
SSH 지원 터미널: macOS 기본 터미널 또는 기타 SSH 지원 터미널 프로그램을 사용할 수 있습니다.
기초 SSH 명령 사용법: 터미널에서 SSH 명령을 실행할 수 있으면 됩니다.

터널 구성 실습

핵심 명령어

Pinggy로 터널을 만드는 과정은 아주 간단합니다. 터미널에서 아래와 같이 SSH 명령 한 줄만 실행하면 됩니다. 아래 예시는 ServBay에서 로컬 443 포트로 접근 가능한 servbay.new 사이트를 외부로 노출하는 명령입니다.

bash

ssh -p 443 -R0:localhost:443 -o StrictHostKeyChecking=no -o ServerAliveInterval=30 -t [email protected] x:localServerTls:servbay.new "u:host:servbay.new"

중요 안내: 위 명령에서 XXXXXXXXXXX 부분은 Pinggy 웹사이트에서 발급받은 본인의 고유 사용자명(문자열)으로 교체해야 합니다. servbay.new 역시 실제 ServBay에 구성된, 외부에 노출하고 싶은 로컬 사이트의 도메인명(예: myproject.servbay.demo)으로 바꿔야 합니다.

명령어의 주요 파라미터는 아래와 같은 의미를 가집니다.

파라미터 구성	기능 설명
`-p 443`	Pinggy 서버로의 SSH 연결 포트를 443(HTTPS 기본 포트)으로 지정합니다. 방화벽 통과 성공률을 높입니다.
`-R0:localhost:443`	원격 포트 포워딩의 핵심. `0`은 Pinggy 서버가 임의의 공용 포트를 자동 할당함을 의미합니다. `localhost:443`은 로컬 컴퓨터 443 포트(HTTPS)를 외부 연결에 연결시킵니다. ServBay의 Caddy/Nginx가 이 포트에서 HTTPS 요청을 처리합니다.
`-o StrictHostKeyChecking=no`	SSH 호스트 키 검증을 비활성화합니다. 테스트 및 최초 연결에 편리하지만, 장기적 운영이나 실 서비스 환경에서는 키 검증을 권장합니다.
`-o ServerAliveInterval=30`	30초마다 keep-alive 신호를 보내, 장시간 미사용시 SSH 연결 종료를 방지합니다.
`-t [email protected]`	Pinggy 사용자명과 서버 주소. `XXXXXXXXXXX`에 본인의 Pinggy 계정명을 입력합니다.
`x:localServerTls:servbay.new`	Pinggy에 로컬 서비스가 TLS(HTTPS)를 사용한다고 알리고, 해당 도메인(`servbay.new`)이 실제 로컬 사이트로 설정되어 있음을 알려주는 커스텀 파라미터(여기도 본인 사이트 도메인으로 교체)
`"u:host:servbay.new"`	요청의 HTTP `Host` 헤더를 강제로 `servbay.new`로 지정합니다(여기도 본인 사이트 도메인으로 교체). 여러 사이트(가상호스트)를 운영 중이라면 필수로, ServBay 웹서버가 정확히 어떤 사이트에 응답할지 지정합니다.

명령 실행 후 터미널에는 외부에서 자신의 로컬 서비스를 접근할 수 있는 공용 URL 주소가 출력됩니다. 보통 HTTP, HTTPS 각각 하나씩 발급됩니다.

http://rnirh-172-188-50-148.a.free.pinggy.link
https://rnirh-172-188-50-148.a.free.pinggy.link

서비스 검증

터널이 정상적으로 연결됐는지 아래 방법으로 외부 접근 테스트를 할 수 있습니다.

curl로 확인(추천):curl 명령에 -I 옵션(HTTP 헤더만 확인)을 주어 외부 URL을 테스트합니다. 예시는 Pinggy에서 실제 발급받은 주소로 대체해주세요.

bash

curl -I https://rnirh-172-188-50-148.a.free.pinggy.link

정상이라면 아래와 비슷한 HTTP 헤더 결과가 출력됩니다. 로컬 웹서버(Nginx/Caddy 등)에서 반환된 응답인지 확인할 수 있습니다.

HTTP/1.1 200 OK
Connection: close
Access-Control-Allow-Credentials: true
Access-Control-Allow-Headers: Content-Type, Authorization
Access-Control-Allow-Methods: GET, POST, PUT, DELETE, OPTIONS
Access-Control-Allow-Origin: *
Cache-Control: max-age=0, must-revalidate, no-cache, no-store, private
Connection: keep-alive
Content-Type: text/html; charset=UTF-8
Date: Tue, 18 Feb 2025 11:51:48 GMT # (날짜는 다를 수 있음)
Expires: Sun, 02 Jan 1990 00:00:00 GMT
Pragma: no-cache
Server: nginx # 또는 caddy, ServBay 설정에 따름
Vary: Accept-Encoding
X-Frame-Options: SAMEORIGIN
X-Powered-By: PHP/8.4.3 # 또는 다른 서버 기술 정보

HTTP/1.1 200 OK 상태코드와 올바른 Server 헤더가 보이면, 정상적으로 로컬 ServBay 웹서버로부터 응답받은 것입니다.

브라우저로 접속: 어떤 기기(외부 네트워크 포함)에서든 Pinggy에서 발급받은 HTTPS URL에 직접 접속해서, ServBay에서 보던 화면과 동일하게 보이는지 확인하세요.
기대 효과:
- 외부 사용자가 Pinggy에서 발급한 URL로 내 ServBay 웹사이트 또는 서비스에 접근 가능해야 합니다.
- 설정한 로컬 사이트가 HTTPS(ServBay가 기본으로 자체 서명된 인증서를 발급)에 대응한다면, Pinggy가 자동으로 무료 공개 CA 인증서(브라우저 신뢰 가능)를 제공하므로 별도 인증서 설정 없이 외부 HTTPS 접속도 지원합니다.
- 응답 속도와 연결 안정성은 로컬 네트워크 상태, Pinggy 서버와의 연결 품질, 그리고 Pinggy 서비스 상태에 따라 달라질 수 있습니다.

고급 활용 팁

다른 포트/서비스 노출: 로컬 서비스가 웹이 아니거나, 80/443 외의 포트(예: 8000에서 작동하는 Python/Node.js 앱 등)를 외부로 열고 싶으면 -R 옵션만 수정하면 됩니다.
bash
```
ssh -p 443 -R0:localhost:8000 -o StrictHostKeyChecking=no -o ServerAliveInterval=30 -t [email protected]
```
1
웹이 아니거나 Host 헤더 처리가 필요 없다면 x:localServerTls와 u:host 파라미터는 생략해도 됩니다.
커스텀 도메인(Pinggy Pro): Pinggy 프로(Pinggy Pro) 구독자는 서비스에서 할당된 임시 하위도메인 대신 본인의 고유 도메인으로 연결할 수 있습니다. 보다 전문적인 외부 접근 용도로 활용 가능하며, 자세한 설정은 Pinggy 공식 문서를 참고하세요.
터널 자동 복구(autossh 사용): SSH 연결이 네트워크 이슈 등으로 끊길 수 있습니다. 장시간 터널 유지가 필요하다면 autossh 툴을 추천합니다. 이 도구는 SSH 연결 상태를 감시하다 끊기면 자동으로 재연결을 시도합니다. macOS에서는 Homebrew로 설치한 뒤 아래와 같이 사용하세요.
bash
```
autossh -M 0 -t "ssh -p 443 -R0:localhost:443 -o StrictHostKeyChecking=no -o ServerAliveInterval=30 -t [email protected] x:localServerTls:servbay.new \"u:host:servbay.new\""
```
1
-M 0 옵션은 autossh가 SSH의 keep-alive 기능만 활용해 별도 모니터링 포트를 쓰지 않도록 설정하는 것입니다.
토큰 없는 명령: Pinggy는 명령어 내에 사용자명/토큰을 포함하지 않아도 되는 기능(웹사이트에서 일회성 키 발급)도 제공합니다. 다른 사람과 명령어를 공유해야 할 때, 토큰 노출 걱정 없이 안전하게 사용할 수 있습니다.

대표 사용 사례

원격 데모: 로컬 ServBay 환경에서 개발 중인 웹사이트/앱을 외부(고객, 팀원)에게 즉시 데모. 별도의 스테이징/실서비스 배포 불필요.
Webhook 디버깅: 외부 서비스(결제 게이트웨이, GitHub 등)에서 전송하는 Webhook 요청을 바로 로컬에서 수신·디버깅.
기기간 테스트: 동일 네트워크가 아닌 모바일, 태블릿 등 다양한 기기에서 로컬 웹사이트의 반응성 및 호환성 빠르게 테스트.
팀 협업: 팀원간 각자의 로컬 ServBay 서비스에 편리하게 접근하고, 테스트 및 리뷰 협업.

문제 해결 가이드

증상	해결 방법
SSH 연결 지연/실패	네트워크 연결상태 확인 후 `a.pinggy.io`가 정상 접근 가능한지, 로컬 방화벽이 443 포트(출방) 차단하지 않는지, 사용자명이 올바른지 검토하세요.
Pinggy URL 접속 불가 또는 502 Bad Gateway 오류	ServBay에서 해당 로컬 웹사이트/서비스가 정상 동작 중이며, `localhost:443` 등 명령에 지정한 포트에 서버가 대기 중인지 점검. Caddy/Nginx 등 웹서버 설정도 확인하세요.
Pinggy URL에서 404 Not Found 또는 ServBay 기본 페이지 출력	ServBay에 여러 사이트(가상호스트)가 등록된 경우, SSH 명령의 `x:localServerTls`, `u:host` 파라미터가 노출하려는 사이트 도메인(예: `myproject.servbay.demo`)과 일치하는지 꼭 점검하세요.
간헐적 연결 해제	네트워크 불안정 또는 SSH 타임아웃 때문일 수 있습니다. `ServerAliveInterval` 값을 높이거나, "고급 활용 팁"의 `autossh` 활용으로 자동 복구를 설정해보세요.
HTTPS 접속 인증서 오류	무료 사용자는 대부분 Pinggy가 공인 CA 인증서를 자동 제공(브라우저 경고 없음). 단, ServBay에서 자체 서명 인증서를 쓸 경우 브라우저에서 경고가 뜰 수 있습니다. 노출하는 서비스가 실제로 HTTPS(443) 포트에서 동작하는지 재확인!

솔루션 요약

Pinggy를 이용하면 ServBay 사용자는 매우 쉽고 빠르게 안전한 외부 접근 터널을 만들고, 개발 중인 로컬 사이트/서비스를 외부에 임시 공개할 수 있습니다. 이 방식의 단점과 비교 우위 또한 명확합니다.

클라이언트 설치 불필요: 설정 및 사용이 훨씬 간편합니다.
원클릭 터널: SSH 한 줄로 바로 터널링 적용.
HTTPS 자동 지원: 무료 공개 CA 인증서 제공, 추가 인증서 관리 필요 없음.
HTTP/TCP 터널 지원: 다양한 서비스 유형에 대응.
ServBay와 뛰어난 호환성: 올바른 Host 헤더 지정만으로 여러 사이트 동시 노출 용이.
토큰 없는 명령 옵션: 명령 공유 시 보안성이 한층 강화됨.

복잡한 설치나 설정 파일이 필요한 기존 내트워크 터널링 도구와 달리, Pinggy는 ServBay 개발자에게 빠른 테스트와 임시 서비스 공유에 적합한 초경량·고효율 방안을 제공합니다. 장기 운용, 커스텀 도메인 등 비즈니스 목적으로는 Pinggy 유료 플랜을 고려해볼 수 있습니다. ServBay의 강력한 로컬 개발 환경과 Pinggy의 손쉬운 외부 접근 기능을 결합하면, 개발 및 협업 속도를 크게 향상시킬 수 있습니다.

ServBay에서 Pinggy로 로컬 웹사이트 및 서비스 외부 공개하기 ​

기술 원리 ​

환경 준비 ​

터널 구성 실습 ​

핵심 명령어 ​

서비스 검증 ​

고급 활용 팁 ​

대표 사용 사례 ​

문제 해결 가이드 ​

솔루션 요약 ​