iproxy - Man Page
A proxy that binds local TCP ports to be forwarded to the specified ports on a usbmux device
Examples (TL;DR)
- Bind a local TCP port and forward it to a port on the connected USB device:
iproxy local_port:device_port - Bind multiple local TCP ports and forward them to the respective ports on the connected USB device:
iproxy local_port1:device_port1 local_port2:device_port2 - Bind a local port and forward it to a specific device by UDID:
iproxy --udid device_udid local_port:device_port - Bind a local port and forward it to a network-connected device with WiFi sync enabled:
iproxy --network local_port:device_port
Synopsis
iproxy [Options] LOCAL_PORT:DEVICE_PORT [LOCAL_PORT2:DEVICE_PORT2 ...]
Description
iproxy allows binding local TCP ports so that a connection to one (or more) of the local ports will be forwarded to the specified port (or ports) on a usbmux device.
Options
- -u, --udid UDID
Target specific device by UDID. Note that if this option is not specified, iproxy will make connection attempts to the first device found.
- -n, --network
Connect to network device. The device needs to have WiFi sync enabled and needs to be paired with this computer for this to work. Please note that a device might close connections at any time to save power. This option will make iproxy try to connect to network attched devices only, unless -l is passed too (see below).
- -l, --local
Connect to USB device. This is the default if no option is passed. If used together with -n, iproxy will first attempt a connection to a device attached via USB, and if not available attempt to reach a device via network.
- -s, --source ADDR
Allows setting a source address for the listening socket. The default is 127.0.0.1 (local connections only). While not needed in normal setups, this option allows other than local connections, for example 0.0.0.0 would make the TCP proxy port(s) accessible from other computers in the network.
WARNING: Use with caution since this could expose a device over the network!
- -h, --help
Prints usage information.
- -d, --debug
Increase debug level.
Examples
- iproxy 2222:44
Bind local TCP port 2222 and forward to port 44 of the first device connected via USB.
- iproxy -u 3fac232fbdd684bdb1e3b65973922ae8b7db174a 2222:44
Bind local TCP port 2222 and forward to port 44 of the device with UDID 3fac232fbdd684bdb1e3b65973922ae8b7db174a connected via USB.
- iproxy -n -u 3fac232fbdd684bdb1e3b65973922ae8b7db174a 2222:44 8080:8080
Bind local TCP ports 2222 and 8080 and forward to ports 44 and 8080 respectively of the device with UDID 3fac232fbdd684bdb1e3b65973922ae8b7db174a connected via network.
Author
Nikias Bassen