مواد پر جائیں
Localtonet Localtonet ڈیش بورڈ

یہ صفحہ ابھی اردو میں دستیاب نہیں ہے۔ اسے انگریزی میں دکھایا جا رہا ہے۔

Turn a device into a proxy server

اس صفحے پر مدد
اس صفحے پر 10 سیکشنز
  1. Before you start
  2. Proxy types
  3. Create the proxy
  4. Open the Proxy Server page
  5. Fill in the form
  6. Start the proxy
  7. The endpoint and credentials you get
  8. Test a proxy from a terminal
  9. URL Pattern
  10. Settings
  11. Proxy Authentication
  12. Upstream Setting
  13. Access Control
  14. VPN Access
  15. Android device actions
  16. Troubleshooting
  17. 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 typeUDPMinimum Localtonet app versionWhat you connect with
HTTPNo, TCP onlyNot statedAddress, port, username and password.
SOCKS5SupportedNot statedAddress, port, username and password.
SHADOWSOCKSSupportedMobile v9.5, Desktop v7.4An ss:// link that holds the method (chacha20-ietf-poly1305), the password, the address and the port.
VLESS + WSSupportedMobile v9.9, Desktop v7.6A vless:// import link or QR code.
VLESS + REALITYSupportedMobile v9.9, Desktop v7.6A vless:// import link or QR code, with a public key, a short ID and an SNI / server name.

Create the proxy #

  1. Open the Proxy Server page #

    Open My Tunnels › Proxy Server and expand Create Proxy Tunnel.

  2. Fill in the form #

    FieldWhat to enter
    Proxy typeHTTP, SOCKS5, SHADOWSOCKS, VLESS + WS or VLESS + REALITY.
    Device tokenThe token of the device that becomes the exit.
    USB deviceShown only when the token belongs to a USB device host. Select the modem to use. See USB devices.
    Server regionThe server your proxy users connect to.
    URL typeRandom subdomain or Custom subdomain. A custom subdomain needs Balance.
    SubdomainShown for Custom subdomain: the name you want.
    Domainlocaltonetproxy.com, or one of your own domains.

    Select Create tunnel.

  3. 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, the vless:// 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:

Copied proxy
<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 #

HTTP proxy
curl -x http://<USERNAME>:<PASSWORD>@<HOST>:<PORT> https://example.com
SOCKS5 proxy
curl -x socks5h://<USERNAME>:<PASSWORD>@<HOST>:<PORT> https://example.com

You 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.
VariableValue
{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.

SettingWhat it doesAvailable for
Load BalanceDistribute 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 DataView 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 AccessDownload a WireGuard or OpenVPN config that sends a whole device's traffic through this proxy. See VPN Access.HTTP, SOCKS5, Shadowsocks
Tunnel NoteSave a private note to help you identify or document this tunnel.All types
Proxy AuthenticationManage the username and password required to use this proxy. See Proxy Authentication.HTTP, SOCKS5
Speed TestRun 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 SettingForward this proxy's traffic through another proxy server. See Upstream Setting.All types
ArgumentsConfigure additional network options used by the Localtonet app for this tunnel. See Network selection.All types
Server PortChange the port clients use to connect to this tunnel.HTTP, SOCKS5, Shadowsocks
IP RestrictionControl which client IP addresses can access this tunnel. See Access control.All types
Access ControlAllow or block the destinations the proxy may reach. See Access Control.All types
Expiration Date, Speed Limits, Bandwidth Limit, Bandwidth UsageExpiry date, upload and download speed limits, a data transfer limit, and Clear to reset the recorded usage. See Limits and expiration.All types
Outbound PortChoose a fixed outbound port for the Localtonet app's server connection. See Ports.All types
Tunnel TokenFind opens the AuthToken that the Localtonet app uses for this tunnel in a new tab.All types
Tunnel IPView 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 HealthTraffic 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.

FieldWhat to enter
Use an upstream proxyTurns the upstream proxy on or off.
Paste a proxy addressOptional. Fill in fills the fields below from formats such as socks5://user:pass@host:1080 or host:port:user:pass.
TypeHTTP or SOCKS5.
Host and PortThe 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 PasswordOptional. Leave both empty if the upstream proxy does not require authentication.
Pass options to the upstream and SeparatorUnder 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.com or 127.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.

  1. Open the proxy's Settings and find VPN Access.
  2. Select WireGuard or OpenVPN to download a configuration straight away, or select Manage to open the VPN Access window.
  3. In the window, under Add a device, enter a Device name, choose the Type and select Create. Create one configuration for each device.
  4. Import the configuration:
    • WireGuard: install the official WireGuard app. On a phone, tap + and scan the QR code. On a computer, import the downloaded .conf file. Then turn the tunnel on.
    • OpenVPN: install OpenVPN Connect (or OpenVPN / Tunnelblick), import the downloaded .ovpn file and enter the username and password shown when asked.

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:

TabWhat it offersRequirement
Airplane ModeAuto 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 IPLinks that change the device's IP when opened. Copy a link, delete it or add one with + Create New.None stated
Restart DeviceRestart links, and Auto Restart Mode with Battery Lower Than, Scheduled Hour (Hour) and Token Is Disconnected (Minute).Only for ROOTED/Owner Devices
TCP/IP FingerprintChoose the OS Type the device's TCP/IP fingerprint should show.Only for ROOTED Devices; Localtonet Android app v8.2 and above
SMS ManageLinks 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.

سپورٹ