Skip to content

Standard Tutorial: Activate Your Cross-Platform Network Node in 3 Simple Steps

Have you ever encountered this issue: you have purchased a VPS instance and set up the server configurations, but you get stuck during the final client setup?

Many remote connection clients present users with an overwhelming list of configuration parameters: encryption types, protocol headers, custom routing scripts... One typo in a single textbox triggers a confusing connection error.

Today, we'll keep things simple. In just 3 steps, this guide will show you how to configure and activate your cross-platform secure network node using Easy Connect SSH.


Prerequisites

Before we start, you only need to gather your basic SSH server credentials (these are typically provided when you buy a VPS or are assigned a development box):

  • Server IP Address (or domain name)
  • SSH Port Number (default is 22)
  • Username (e.g., root or your personal user ID)
  • Authentication Credential (your SSH password, or recommended private key file)

Step-by-Step Configuration

Step 1: Get Config Format ──► Step 2: Download Client ──► Step 3: Import & Enable TUN
   (Check Wiki Template)          (From App Store)             (One-Click VPN Mode)

Step 1: Visit Our Official Wiki for the Configuration Template

First, go to our documentation page: Easy Connect SSH Client Usage Guide. Here, you can review pre-configured JSON formats for different routing scenarios.

If you need advanced routing rules (e.g., directing only staging subnet traffic 10.0.0.0/8 through the secure gateway, while letting normal web browsing and local network printers run directly), copy the appropriate routing rules block.

Step 2: Install Easy Connect SSH from the App Store

On your Mac computer (both Intel-based and Apple Silicon models are supported) or your iPhone/iPad, open the official App Store, search for Easy Connect SSH, and download the app.

Security Tip: Always download the app through the official App Store channel to ensure the sandbox boundaries and cryptography code are untouched and signed by Apple.

Step 3: Fill in Parameters and Enable TUN Mode

Launch Easy Connect SSH. You will see a clean, ad-free profile interface:

  1. Create a Profile: Click the "+" button in the top right corner.
  2. Enter Server Credentials:
    • Profile Name: Enter a descriptive name (e.g., "Staging Server").
    • Address & Port: Enter your server's IP address and SSH port.
    • Username & Auth: Input your username and select password authentication, or click "Import Private Key" to upload your .pem or .id_rsa file.
  3. Enable TUN Mode: Toggle the TUN Mode switch to active. This automatically provisions a virtual user-space network card, routing all specified TCP/UDP/ICMP IP traffic through the SSH connection.
  4. Save and Connect: Click Save, return to the home screen, and toggle the connection switch. The OS will request network interface permissions. Click "Allow" and enter your device password to confirm.

Key Benefits: Silent Background Performance

Once connected, Easy Connect SSH runs quietly in the background, providing outstanding reliability:

  • Seamless Connection Recovery: When closing your MacBook lid, moving locations, or switching from Wi-Fi to cellular data, the client automatically restores the secure tunnel in under 2 seconds without prompts.
  • Minimal Energy Footprint: Since the app uses Apple's native NetworkExtension framework, it runs without draining your mobile device's battery or using CPU cycles.

Your secure, compliant, and lightweight tunnel is now active. For advanced diagnostics or script-based management, feel free to inspect our CLI Reference Guide.

Released under the MIT License. Terms | Privacy