Skip to Content

Edge Tunnel

Edge Tunnel is a tunneling technology that allows the cloud AIP server to access your internal systems via your local network. This enables AIP to utilize systems that are protected by firewalls or VPNs and are otherwise inaccessible from the outside.

💻

Node.js Version Requirements

Edge Tunnel Client runs on Node.js v18.20.8 or higher. For optimal performance and stability, we strongly recommend using v20.0.0 (LTS) or higher.


Problems Solved

  • No direct access to local systems → MySQL or local development servers on your PC cannot be accessed directly from the AIP server.

  • VPN environment restrictions → Internal company systems accessible only via VPN (e.g., GlobalProtect) are isolated from external connections.

  • Firewall policies → Most environments do not allow direct connections from the external internet to internal networks for security reasons.


How It Works

Edge Tunnel provides a connection path between the AIP server and your local system through a tunnel program running on your PC.


Connection Process

  1. Request Tunnel Setup When a local system connection is needed in AIP, enable the “Use Edge Tunnel” option.

  2. Run Tunnel Program Run the Edge Tunnel program on your PC to connect to the AIP server.

  3. Connection Mediation Requests from the AIP server are relayed to your local network via the tunnel.

  4. Access Target System The tunnel program connects to the target system (MySQL, VPN server, etc.) in your local network.


Usage Examples

🏠 Local Development Environment

You can run queries directly from AIP to local databases (MySQL, PostgreSQL, etc.) running on your developer PC.

🏢 Internal Company Systems

You can use AIP to access internal databases or APIs that are only accessible via VPN.

🔒 Secure Environments

Even in environments protected by firewalls, you can use AIP features without exposing your internal network to the outside.


Installation & Usage

1. Enable Tunnel Option

Check the “Use Edge Tunnel” option in the database connection settings.

2. Install Tunnel Program

Run the provided command in your terminal to install the Edge Tunnel program.

3. Start Tunnel Connection

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

4. Confirm Connection

Check the “Tunnel Connected” status in AIP and start accessing your local systems.


Technical Features

  • TCP Forwarding: Supports various protocols by mediating connections at the network level
  • Automatic Routing: Automatically selects the optimal connection path based on the target address
  • Connection Status Monitoring: Monitors tunnel connection status in real time

Summary

Edge Tunnel is a tunneling solution that allows the cloud server to access your local network.

  • Use AIP even in secure, firewall-protected environments
  • Seamlessly connect local development and internal systems
  • Instantly usable with simple network setup

Enjoy the convenience of cloud AI services while keeping your local security intact!

Last updated on