Wannan shafin bai samu a cikin Hausa tukuna ba. Ana nuna shi da Turanci.
Turn a device into a proxy server
A wannan shafin 10 sassa
- Before you start
- Proxy types
- Create the proxy
- Open the Proxy Server page
- Fill in the form
- Start the proxy
- The endpoint and credentials you get
- Test a proxy from a terminal
- URL Pattern
- Settings
- Proxy Authentication
- Upstream Setting
- Access Control
- VPN Access
- Android device actions
- Troubleshooting
- Related pages
A Proxy Server tunnel lets you use a connected device as an HTTP, SOCKS5, Shadowsocks or VLESS proxy. You get a public endpoint, and traffic sent to it leaves through that device's internet connection.
Before you start #
- The Localtonet client is running on the device you want to use as the exit and is connected with an AuthToken. See Quick start.
- You do not need to install proxy software. The Localtonet client is the proxy.
- For Shadowsocks and VLESS the client must be new enough. The minimum versions are in the table below.
To run many devices as proxies and control them from one place, see Proxy Manager. To put several devices behind one endpoint, see Rotating Proxy.
Proxy types #
| Proxy type | UDP | Minimum Localtonet app version | What you connect with |
|---|---|---|---|
| HTTP | No, TCP only | Not stated | Address, port, username and password. |
| SOCKS5 | Supported | Not stated | Address, port, username and password. |
| SHADOWSOCKS | Supported | Mobile v9.5, Desktop v7.4 | An ss:// link that holds the method (chacha20-ietf-poly1305), the password, the address and the port. |
| VLESS + WS | Supported | Mobile v9.9, Desktop v7.6 | A vless:// import link or QR code. |
| VLESS + REALITY | Supported | Mobile v9.9, Desktop v7.6 | A vless:// import link or QR code, with a public key, a short ID and an SNI / server name. |
Create the proxy #
-
Open the Proxy Server page #
Open My Tunnels › Proxy Server and expand Create Proxy Tunnel.
-
Fill in the form #
Field What to enter Proxy type HTTP, SOCKS5, SHADOWSOCKS, VLESS + WS or VLESS + REALITY. Device token The token of the device that becomes the exit. USB device Shown only when the token belongs to a USB device host. Select the modem to use. See USB devices. Server region The server your proxy users connect to. URL type Random subdomain or Custom subdomain. A custom subdomain needs Balance. Subdomain Shown for Custom subdomain: the name you want. Domain localtonetproxy.com, or one of your own domains.Select Create tunnel.
-
Start the proxy #
The proxy appears under Your tunnels. Select Start. The Connection column shows whether the device is connected.
The endpoint and credentials you get #
Each proxy has its own row in the list:
- Server Domain shows the proxy address. Its copy button previews and copies the whole connection: the address with the credentials for HTTP and SOCKS5, the
ss://link for Shadowsocks, thevless://link for VLESS. - Server Port shows the port clients connect to.
- Proxy Type shows the type. For an HTTP or SOCKS5 proxy it is a list: choose the other value to switch between HTTP and SOCKS5. A running proxy restarts with the new type.
An HTTP or SOCKS5 proxy is created with authentication turned on and a generated username and password. With the default settings it is copied as:
<HOST>:<PORT>:<USERNAME>:<PASSWORD>The same text is shown at the top of the tunnel's Settings panel, where you can copy it again.
Keep proxy credentials private. Anyone who has them can send traffic through your device.
Test a proxy from a terminal #
curl -x http://<USERNAME>:<PASSWORD>@<HOST>:<PORT> https://example.comcurl -x socks5h://<USERNAME>:<PASSWORD>@<HOST>:<PORT> https://example.comYou can also paste the proxy into the Proxy checker tool, which reports whether it is online, its response time, exit IP and UDP support.
URL Pattern #
URL Pattern, next to the page title, opens Proxy URL pattern. It sets how proxy URLs appear in your tunnel list and when copied.
- Start with a format offers Default · hostname + port (no pattern of your own,
{host}:{port}), then the ready formats Hostname + port, IP address + port, Credentials @ hostname, Credentials @ IP address, Proxy URI with hostname, Proxy URI with IP address, Protocol + hostname + credentials and Protocol + IP address + credentials, and Custom pattern, which the list shows when your pattern matches none of them. - URL pattern takes your own pattern on a single line, up to 50 characters. Leave it blank to use
{host}:{port}. - Live preview shows the result with sample data, with and without authentication.
| Variable | Value |
|---|---|
{host} | Proxy hostname |
{ip} | Server IP address |
{port} | Server port |
{proxy-type} | http or socks5 |
{username} | Proxy username |
{password} | Proxy password |
Select Save & apply. Existing and new tunnels use the format in the Proxy Server list and its copy buttons. Username and password variables are empty for tunnels without authentication, and their adjacent : and @ separators are removed automatically. If your pattern has no {username} or {password}, the copy button still adds :username:password to a proxy that requires them. Shadowsocks and VLESS keep their protocol-specific formats, and export columns use their own formats.
Settings #
Select the Settings icon of a proxy to open Tunnel settings. Which rows you see depends on the proxy type.
| Setting | What it does | Available for |
|---|---|---|
| Load Balance | Distribute traffic across devices or use a backup when a target is unavailable. See Load balancing. | All types |
| Is Reserved? | Keeps the same server port when the tunnel is restarted. | All types |
| Just Connect with Ipv4? | Use IPv4 for outgoing proxy connections. | All types |
| Legacy Connect? | Try this if the tunnel cannot connect using the normal connection method. | All types |
| Wifi Split? | Use WiFi for the Localtonet server connection and mobile data for outgoing proxy traffic. | All types, on a mobile device |
| VLESS Data | View the connection details used to configure a VLESS client. The VLESS connection window has Quick import with a QR code and Copy link, and Manual setup with the single values a VLESS app asks for. For REALITY it also has Reality SNI, where you can change the server name; saving restarts the tunnel and updates the import link. | VLESS |
| VPN Access | Download a WireGuard or OpenVPN config that sends a whole device's traffic through this proxy. See VPN Access. | HTTP, SOCKS5, Shadowsocks |
| Tunnel Note | Save a private note to help you identify or document this tunnel. | All types |
| Proxy Authentication | Manage the username and password required to use this proxy. See Proxy Authentication. | HTTP, SOCKS5 |
| Speed Test | Run a speed test through this proxy tunnel. The result shows the IP address, country and city, download and upload speed, latency and jitter. Run again repeats it. | HTTP and SOCKS5, while running |
| Upstream Setting | Forward this proxy's traffic through another proxy server. See Upstream Setting. | All types |
| Arguments | Configure additional network options used by the Localtonet app for this tunnel. See Network selection. | All types |
| Server Port | Change the port clients use to connect to this tunnel. | HTTP, SOCKS5, Shadowsocks |
| IP Restriction | Control which client IP addresses can access this tunnel. See Access control. | All types |
| Access Control | Allow or block the destinations the proxy may reach. See Access Control. | All types |
| Expiration Date, Speed Limits, Bandwidth Limit, Bandwidth Usage | Expiry date, upload and download speed limits, a data transfer limit, and Clear to reset the recorded usage. See Limits and expiration. | All types |
| Outbound Port | Choose a fixed outbound port for the Localtonet app's server connection. See Ports. | All types |
| Tunnel Token | Find opens the AuthToken that the Localtonet app uses for this tunnel in a new tab. | All types |
| Tunnel IP | View the IPv4 and IPv6 addresses clients use to reach this tunnel. IP addresses may change; use the domain address where you can. | All types |
| Bandwidth Traffic, Request Log, Activity Log, Tunnel Health | Traffic over time, recorded requests, starts, stops and setting changes, and recent health check results. See Logs and inspection. | All types |
Proxy Authentication #
Proxy Authentication › Manage opens Proxy authentication with the switch Require a username and password, the Username and the Password. Generate both fills in a new generated pair. Select Save.
Before you can turn authentication off, the proxy must have an allowed IP Restriction. Otherwise the dashboard answers "Add an allowed IP restriction to this tunnel before disabling authentication." This keeps the proxy from being open to everyone.
Shadowsocks and VLESS proxies do not have this row: their password is part of the ss:// or vless:// link.
Upstream Setting #
With an upstream proxy, the device does not connect to the destination itself; it forwards the traffic through another proxy server.
| Field | What to enter |
|---|---|
| Use an upstream proxy | Turns the upstream proxy on or off. |
| Paste a proxy address | Optional. Fill in fills the fields below from formats such as socks5://user:pass@host:1080 or host:port:user:pass. |
| Type | HTTP or SOCKS5. |
| Host and Port | The address of the upstream proxy. The port must be from 1 to 65535. Enter env as the host to use the proxy set in the device's environment variables (HTTP proxies only). The port is then not used, but still needs a number. |
| Username and Password | Optional. Leave both empty if the upstream proxy does not require authentication. |
| Pass options to the upstream and Separator | Under Session options. Clients add options such as a session id after their proxy username. Needs proxy authentication. The separator is the characters that end the proxy username, up to 10. |
Access Control #
Access Control › Manage opens Access control, a list of destinations for this proxy. Enter one or more addresses under Add destinations and select Add:
- A single address:
example.comor127.0.0.1 - Several addresses separated by commas, with wildcards for domains:
*.example.com, 127.0.0.1, 127.0.0.2 - A range:
127.0.0.1/16
The list works in one of two modes: Allow only these (the proxy can reach only the destinations in the list) or Block these (the proxy can reach everything except the destinations in the list). IP Restriction is a different list: it decides who may connect to the proxy, not where the proxy may go.
VPN Access #
VPN Access gives a phone or computer a WireGuard or OpenVPN configuration. After you import it into the official WireGuard or OpenVPN app, the device's whole traffic leaves through this proxy, without a proxy setting in each app. It is included in the proxy price, with no extra charge.
It is available for HTTP, SOCKS5 and Shadowsocks proxies, and for rotating HTTP and SOCKS5 proxies.
- Open the proxy's Settings and find VPN Access.
- Select WireGuard or OpenVPN to download a configuration straight away, or select Manage to open the VPN Access window.
- In the window, under Add a device, enter a Device name, choose the Type and select Create. Create one configuration for each device.
- Import the configuration:
- WireGuard: install the official WireGuard app. On a phone, tap + and scan the QR code. On a computer, import the downloaded
.conffile. Then turn the tunnel on. - OpenVPN: install OpenVPN Connect (or OpenVPN / Tunnelblick), import the downloaded
.ovpnfile and enter the username and password shown when asked.
- WireGuard: install the official WireGuard app. On a phone, tap + and scan the QR code. On a computer, import the downloaded
The Devices list shows each device with its Address, Last handshake and Traffic. Its actions are Download config, QR code (WireGuard), Username and password (OpenVPN), Regenerate keys and Delete device. Regenerating keys stops the current configuration from working until you import the new one. Deleting a device revokes its access immediately.
Do not share the QR code or the file. They contain the device's private key.
- If the tunnel is stopped, devices can connect but no traffic flows until the tunnel is started.
- HTTP proxies carry TCP only. Apps that need UDP (some games and calls) will not work; browsers fall back to TCP automatically.
- If the tunnel moved to another server, the device is marked Download again: download the configuration again.
The same actions are available in the API.
Android device actions #
When the proxy runs on an Android device, its row has one more icon, Android device settings. The window title shows the device's root status. It has five tabs:
| Tab | What it offers | Requirement |
|---|---|---|
| Airplane Mode | Auto Airplane Mode with Time (sec) and Delay (sec), Enable Unique IP with Number Of Unique IP Attempts and IP Uniqueness Time (minute), and Mobile Network Is Idle Check with Mobile Network Is Idle (minute). | None stated |
| Change IP | Links that change the device's IP when opened. Copy a link, delete it or add one with + Create New. | None stated |
| Restart Device | Restart links, and Auto Restart Mode with Battery Lower Than, Scheduled Hour (Hour) and Token Is Disconnected (Minute). | Only for ROOTED/Owner Devices |
| TCP/IP Fingerprint | Choose the OS Type the device's TCP/IP fingerprint should show. | Only for ROOTED Devices; Localtonet Android app v8.2 and above |
| SMS Manage | Links to the Localtonet SMS App, to the Telegram app that reads incoming SMS and to the SMS documentation. See SMS bot. | None stated |
The Change IP and restart links use localtonet.com as their host. To use a name in your own domain instead, add a record of type Android in DNS Manager. See Android records.
The same settings, for a whole fleet of devices, are on the Proxy Manager page. A proxy that runs on a USB modem shows a USB device settings icon instead; see USB devices.
Troubleshooting #
"You need to purchase balance to use this feature."
You chose Custom subdomain on an account without Balance. Use Random subdomain or add Balance. See Plans and Balance.
"Select a USB device."
The token you chose belongs to a USB device host. Pick the modem in the USB device field.
"Add an allowed IP restriction to this tunnel before disabling authentication."
An HTTP or SOCKS5 proxy cannot be left without both a password and an IP list. Add your addresses under IP Restriction first, then turn authentication off.
"This feature is not available for VLESS proxies." or "VLESS proxy ports cannot be changed."
VLESS proxies have no Proxy Authentication and a fixed port. Use VLESS Data to read their connection details.
"Enter a username and password."
Authentication is turned on but the username or the password is empty.
The proxy does not answer
Check that the proxy is started and that the Connection column shows the device as connected. For Shadowsocks and VLESS, check the Localtonet app version against the table above.