iPad Client Configuration

Install the Code APP from the iOS App Store. Launch the application and navigate to the remote server configuration panel. Establishing a connection requires routing traffic through a TCP tunnel directed at the server's SSH port (22).

Deploying the Tunneling Service

Service Installation

Run the primary installation script:

curl -L https://www.cpolar.com/static/downloads/install-release-cpolar.sh | sudo bash

For networks outside the region, utilize the shortened URL:

curl -sL https://git.io/cpolar | sudo bash

Verify the deployment:

cpolar version

Link the client to your account using the authentication token from the dashboard:

cpolar authtoken <YOUR_TOKEN>

Execute a quick HTTP tunnel test:

cpolar http 8080

Stop the test using Ctrl+C. Register the daemon with the system init and launch it:

sudo systemctl enable cpolar
sudo systemctl start cpolar

Check the operational status:

sudo systemctl status cpolar

An active state indicates the service is running properly.

Establishing the SSH Tunnel

Access the web management interface via http://localhost:9200. Navigate to "Tunnel Management" and select "Create Tunnel". Apply the following settings:

• Tunnel Name: A unique identifier
• Protocol: TCP
• Local Address: 22
• Domain Type: Random temporary TCP port
• Region: China Top

Click "Create". Once generated, go to "Status" -> "Online Tunnel List" and copy the public address and port provided.

Connecting from the iPad

Open the Code APP and create a new remote server entry. Fill in the connection parameters:

• Protocol: SSH
• Address: The generated TCP hostname (e.g., 6.tcp.cpolar.top)
• Port: The allocated public port (e.g., 14503)
• Username: Your server login name
• Password: Your server password

Click "Connect". Upon successful authentication, the remote file system will be visible. Long-press a desired directory and choose "Set as Workspace Folder". The VS Code editor will load the environment.

To confirm synchronization, make a change on the host machine, then execute a script in the iPad terminal. For instance, run a Python file:

python3 main.py

Correct execution output verifies the remote setup is functional.

Allocating a Static TCP Endpoint

Random TCP tunnels change addresses every 24 hours. For a persistent connection, a fixed TCP address is required (requires a subscription upgrade).

In the web dashboard, go to "Reservations" and find "Reserve TCP Address". Configure the following:

• Region: China VIP
• Description: A custom label for reference

Click "Reserve". The system will generate a permanent public address and port number. Update the Code APP connection profile with these static details to avoid reconfiguration.