External Controller Access

Surge can be managed from a remote machine using tools like Surge Dashboard or Surge CLI. However, the function needs to be manually enabled.

[General]
external-controller-access = apassword@127.0.0.1:8888

This parameter is made up of three parts: password, listen address, and port number. No part can be omitted.

When using this function on Surge iOS, listening on 127.0.0.1 allows only USB connections. Listening on 0.0.0.0 also allows connections from the local Wi-Fi network. Connections from cellular networks are always restricted for security reasons.