Skip to Content

Edge Tunnel

Edge Tunnel은 원격 AI Hub 서버가 사용자의 로컬 네트워크를 통해 내부 시스템에 접근할 수 있게 해주는 터널링 기술입니다. 방화벽이나 VPN으로 보호된 환경에서 외부 접근이 불가능한 시스템들을 AI Hub에서 활용할 수 있게 됩니다.


해결하는 문제

  • 로컬 시스템 접근 불가 → 사용자 PC의 MySQL, 로컬 개발 서버 등은 AI Hub 서버에서 직접 접근할 수 없습니다.

  • VPN 환경의 제약 → GlobalProtect 등 VPN으로만 접근 가능한 회사 내부 시스템은 외부에서 연결이 차단됩니다.

  • 방화벽 정책 → 보안상 외부 인터넷에서 내부 네트워크로의 직접 연결을 허용하지 않는 환경이 대부분입니다.


작동 방식

Edge Tunnel은 사용자 PC에서 실행되는 터널 프로그램을 통해 AI Hub 서버와 로컬 시스템 간의 연결 경로를 제공합니다.


연결 과정

  1. 터널 설정 요청 AI Hub에서 로컬 시스템 연결이 필요할 때 “Use Edge Tunnel” 옵션을 활성화합니다.

  2. 터널 프로그램 실행 사용자 PC에서 Edge Tunnel 프로그램이 실행되어 AI Hub 서버와 연결을 대기합니다.

  3. 연결 중계 AI Hub 서버의 요청이 터널을 통해 사용자 로컬 네트워크로 전달됩니다.

  4. 목적지 접근 터널 프로그램이 로컬 네트워크 내의 목적 시스템(MySQL, VPN 서버 등)에 연결합니다.


사용 사례

🏠 로컬 개발 환경

개발자 PC에서 실행 중인 MySQL, PostgreSQL 등의 로컬 데이터베이스에 AI Hub에서 직접 쿼리를 실행할 수 있습니다.

🏢 회사 내부 시스템

VPN으로만 접근 가능한 사내 데이터베이스나 내부 API 서버를 AI Hub에서 활용할 수 있습니다.

🔒 보안 환경

방화벽으로 보호된 환경에서도 외부 연결을 허용하지 않으면서 AI Hub의 기능을 사용할 수 있습니다.


설치 및 사용

1. 터널 옵션 활성화

데이터베이스 연결 설정에서 “Use Edge Tunnel” 옵션을 체크합니다.

2. 터널 프로그램 설치

제공되는 명령어를 터미널에서 실행하여 Edge Tunnel 프로그램을 설치합니다.

3. 터널 연결 시작

npx -y @querypie/mcp-dev tunnel link 'your-tunnel-key'

4. 연결 확인

AI Hub에서 “터널 연결됨” 상태를 확인하고 로컬 시스템에 접근을 시작합니다.


기술적 특징

  • TCP 포워딩: 네트워크 레벨에서 연결을 중계하여 다양한 프로토콜을 지원합니다
  • 자동 라우팅: 목적지 주소에 따라 적절한 연결 경로를 자동으로 선택합니다
  • 연결 상태 관리: 터널 연결 상태를 실시간으로 모니터링하고 관리합니다

요약

Edge Tunnel은 원격 서버가 로컬 네트워크에 접근할 수 있게 해주는 터널링 솔루션입니다.

  • 방화벽으로 보호된 환경에서도 AI Hub 활용 가능
  • 로컬 개발 환경과 사내 시스템의 원활한 연동
  • 복잡한 네트워크 설정 없이 간단한 설치로 즉시 사용

로컬 보안을 유지하면서도 원격 AI 서비스의 편리함을 동시에 누릴 수 있는 핵심 기술입니다.

Last updated on