Skip to content

Setup a Proxy

pyamsoft edited this page Nov 3, 2024 · 13 revisions

Setup a Proxy

These instructions apply to all hotspot types. For setting up a specific hotspot type, see the section below.

Hotspot Type

For Wi-Fi Direct (default) see here
For USB Tethering (RNDIS) see here

Proxy Setup Instructions

HTTP / HTTPS

You want to set up a MANUAL proxy for both HTTP and HTTPS. Your URL and Port should be provided by the TetherFi app on the Hotspot status screen when it is running.

Windows

Proxy Manual Configuration

MacOS

GUI

You should set the Proxy settings in the Network -> Details panel.

Proxy Manual Configuration

CLI

On the command line, some programs will respect the environment option http_proxy and https_proxy. You must configure your shell as follows.

$ export http_proxy="http://${TETHERFI_HOST}:${TETHERFI_PORT}"
$ export https_proxy="https://${TETHERFI_HOST}:${TETHERFI_PORT}"
$ export HTTP_PROXY="http://${TETHERFI_HOST}:${TETHERFI_PORT}"
$ export HTTPS_PROXY="https://${TETHERFI_HOST}:${TETHERFI_PORT}"  

So for a setup with a proxy URL of 192.168.49.1 and a port of 8228 your exact command is

$ export http_proxy="http://192.168.49.1:8228"
$ export https_proxy="https://192.168.49.1:8228"
$ export HTTP_PROXY="http://192.168.49.1:8228"
$ export HTTPS_PROXY="https://192.168.49.1:8228"

A CLI program may not respect these global options though and may provide its own method for configuring proxy connections.

Linux

GUI

Depending on your desktop environment, your options may visually appear different. Configuration though is the same.

Proxy Manual Configuration

CLI

On the command line, some programs will respect the environment option http_proxy and https_proxy. You must configure your shell as follows.

$ export http_proxy="http://${TETHERFI_HOST}:${TETHERFI_PORT}"
$ export https_proxy="https://${TETHERFI_HOST}:${TETHERFI_PORT}"
$ export HTTP_PROXY="http://${TETHERFI_HOST}:${TETHERFI_PORT}"
$ export HTTPS_PROXY="https://${TETHERFI_HOST}:${TETHERFI_PORT}"  

So for a setup with a proxy URL of 192.168.49.1 and a port of 8228 your exact command is

$ export http_proxy="http://192.168.49.1:8228"
$ export https_proxy="https://192.168.49.1:8228"
$ export HTTP_PROXY="http://192.168.49.1:8228"
$ export HTTPS_PROXY="https://192.168.49.1:8228"

A CLI program may not respect these global options though and may provide its own method for configuring proxy connections.

Android

You first need to connect to the Wi-Fi network, and then in to Manage Network and edit the Proxy Settings to Manual.

Android Proxy Settings

SOCKS / SOCKS4 / SOCKS5 / SOCKS4A / SOCKS5H

TetherFi versions above 50 have support for running a SOCKS proxy along side an HTTP proxy. By default, both are enabled.

SOCKS is a more technically inclined solution than a simple HTTP proxy is - and not every device supports SOCKS.
If you are investigating if your device supports SOCKS, specifically TetherFi requires a device that supports either SOCKS4a, or SOCKS5h. These specific SOCKS versions are needed because both 4a and 5h mean that DNS is resolved on the device running the SOCKS server. In many cases while you are using TetherFi, your client device will not have access to a regular DNS server, so only these specific SOCKS protocols will work.

Windows

Coming Soon

MacOS

Coming Soon

Linux

Coming Soon

Android

Sadly, SOCKS is not supported by the Android OS at the system level. Individual apps may have support for SOCKS however, and these will be configurated on an app-by-app basis.