Skip to content

Remote Console

martin-ger edited this page Mar 4, 2026 · 2 revisions

Remote Console

The router provides a network-accessible CLI via TCP, allowing remote configuration without physical serial access.

Features

  • TCP Connection: Connect via port 2323 (configurable)
  • Password Protected: Uses the same password as the web interface
  • Full CLI Access: All serial console commands available remotely
  • Single Session: Only one remote session at a time
  • Idle Timeout: Automatic disconnect after inactivity (default: 5 minutes)
  • Disabled by Default: Must be explicitly enabled for security

Security Warning

The remote console currently uses plain TCP (unencrypted). Only use on trusted networks or via WireGuard-VPN. Do not expose port 2323 to the internet.

Enabling Remote Console

First, set a web password (recommended):

set_router_password mypassword

Then enable the remote console:

remote_console enable

Connecting

From any computer on the network:

nc 192.168.4.1 2323

Or using telnet:

telnet 192.168.4.1 2323

You'll be prompted for the password. After authentication, you get full CLI access.

Console Commands

remote_console status              # Show remote console status
remote_console enable              # Enable remote console
remote_console disable             # Disable remote console
remote_console port <port>         # Set TCP port (default: 2323)
remote_console bind <ap,sta,vpn>  # Set interface binding (comma-separated)
remote_console timeout <seconds>   # Set idle timeout (0 = no timeout)
remote_console kick                # Disconnect current session

Configuration Options

Setting Default Description
Port 2323 TCP port for connections
Bind AP only Which interface(s) to listen on (AP, STA, VPN)
Timeout 300 sec Idle timeout before disconnect
Enabled No Service must be explicitly enabled

Usage Tips

  • Use quit or exit to disconnect gracefully
  • Press Ctrl+C to cancel current input
  • Press Ctrl+D to disconnect
  • The session shows ^C when Ctrl+C is pressed
  • All command output appears on the remote console

Clone this wiki locally