Edge Tunnel

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

해결하는 문제

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

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

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

작동 방식

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

연결 과정

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

2. 터널 프로그램 실행 화면 좌측 하단의 Edge Tunnel 버튼을 클릭하여 나타나는 팝오버에서 명령어를 복사한 뒤, 사용자 PC의 터미널에서 실행합니다.

3. 연결 중계 및 상태 확인 터널 프로그램이 실행되면 AIP 서버와 연결을 중계하며, 팝오버에서 실시간 연결 상태(Listening…)를 확인할 수 있습니다.

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

사용 사례

🏠 로컬 개발 환경

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

🏢 회사 내부 시스템

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

🔒 보안 환경

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

설치 및 사용

1. 터널 옵션 활성화

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

2. 터널 팝오버 열기

화면 좌측 하단의 Edge Tunnel 버튼을 클릭하여 터널 설정 팝오버를 엽니다.

3. 터널 연결 시작

팝오버에 표시된 명령어를 복사하여 터미널에서 실행합니다.

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

4. 연결 확인

터널이 성공적으로 연결되면 팝오버에 Listening… 상태와 함께 현재 연결된 사용자 수가 표시됩니다. 이제 AIP에서 로컬 시스템에 접근할 수 있습니다.

기술적 특징

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

요약

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

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

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