GozarTahrim

1 Pick the right file

The Releases page lists several APK files. You only need one of them.

2 Install the app

The app is not distributed through Google Play, so Android asks for permission once.

1. Open the APK file

   When the download finishes, tap it in your notification shade or in the Downloads folder.

2. Allow the installation

   Android shows an “Install unknown apps” prompt. Tap Settings, enable the permission for your browser or file manager, then go back and continue.

3. If Play Protect warns you

   Tap Install anyway. This warning appears for every app installed outside Google Play.

4. Open the app

   The GozarTahrim icon is now on your home screen.

3 Your first connection

GozarTahrim does not provide servers. You supply your own config or subscription link.

Option A: add a subscription link

If you bought a service, you were most likely given a long link that imports a whole set of servers at once and keeps them up to date automatically.

1. Open the drawer

   Tap the ☰ icon at the top and choose Subscription group.

2. Create a subscription

   Tap +, give it any name you like, paste your subscription link into the URL field, and save.

3. Fetch the servers

   Go back to the main screen and choose Update subscription from the three-dot menu. Your server list appears.

Option B: add a single config

If you only have one config link (starting with vless://, vmess://, trojan:// or ss://):

• Copy the link, tap + in the app and choose Import from clipboard.
• Or, if you have a QR code, choose Scan QR code.

Connecting

1. Select a server

   Tap a server in the list to select it.

2. Tap the round button at the bottom

   Android asks to set up a VPN connection the first time — accept it. When the button turns green, you are connected.

3. Measure server speed

   Tap the bottom bar to test the current server's latency. To test every server, use the test option in the three-dot menu — a lower number is better.

4 GozarTahrim's own features

These are what set GozarTahrim apart from stock v2rayNG.

GozarTahrim Fragment

On many censored networks, the filtering system reads your server's domain name out of the first packets of a connection and drops the connection right there. This feature splits that packet into dozens of small random chunks, so the system cannot reassemble the hostname and recognise it.

Where: Settings → GozarTahrim Fragment

If the defaults do not work, raise the chunk count (try 100) or set the delay to somewhere between 2 and 5. Disconnect and reconnect after each change.

Alt IP Finder

When your server sits behind Cloudflare and has become slow or blocked, this tool finds other IP addresses that still reach the same server. It is exclusive to GozarTahrim and has its own full guide below.

→ Read the complete Alt IP Finder guide

Auto-connect to the best server

Instead of testing servers by hand every time, the app can do it for you and stay on the fastest one.

Where: enabled per group — Edit subscription → Auto-connect to the best server in this group

The check interval (default 30 minutes) and how many servers are tested each round (default 5) are configurable under Settings → GozarTahrim extras.

In-app message box

Important announcements — for example when a new way around the filtering is found — and posts from the project's Telegram channel are shown inside the app itself, without you having to open Telegram.

Where: the small button next to the connect button, or ☰ → Messages

5 Complete guide: Alt IP Finder

GozarTahrim's most powerful tool — usually what saves you when every server you have has become slow.

What problem does it solve?

Many servers sit behind Cloudflare's network. Cloudflare has millions of IP addresses that all reach your server — but only some of them are fast and unblocked from your country. The IP written in your config may be blocked or congested while thousands of others on the same network work perfectly.

This tool finds the working ones and swaps in the address without touching anything else in your config.

Step by step

1. Connect to any working server

   Even a slow one is fine. It is only needed for this search.

2. Select the server you want to improve

   On the main screen, tap the VLESS server you care about. The tool operates on that exact server.

3. Open the tool

   ☰ → Alt IP Finder

   The name of your selected server is shown at the top — check it is the one you meant before starting.

4. Choose a country

   Starred (★) countries are pinned at the top of the list. Picking a country close to you usually gives the lowest latency. If the results are poor, try Germany or Turkey.

5. Start the search

   Tap start. A progress bar shows how many candidates have been tested. Depending on your settings this takes anywhere from a few seconds to a couple of minutes.

6. Save the results

   Working IPs are listed with their latency in milliseconds. Saving creates a new subscription group containing all of them.

7. Use the new group

   Back on the main screen there is a new group named something like Home IPs, with one ready-to-use server per working IP. Pick the lowest latency and connect.

How to read the results

Each generated server follows a fixed naming pattern, for example HomeCL [104.21.5.9]:

The latency shown for each IP comes from a real connection: the app opens a TCP connection and then performs a full TLS handshake against your server's original domain name. So the addresses you see did not merely respond to a ping — they actually completed a handshake for your specific setup.

Advanced settings

Sample size and concurrency can be changed on the tool's own screen; the rest live under Settings → GozarTahrim extras.

The FOFA query itself is editable on the tool's screen, so if you know FOFA's syntax you can write your own search.

Practical tips

If nothing is found

• Make sure you were actually connected while searching.
• Raise the sample size (try 100) and run it again.
• Increase the per-test timeout — on a slow link, 5 seconds may not be enough.
• Try a different country.
• If your server is not behind Cloudflare at all, this tool cannot help; use GozarTahrim Fragment instead.

6 Troubleshooting

Try these before concluding that something is broken.

I connect but no website loads

The most common case — your server is blocked or down. In order:

1) Pick a different server from the list. 2) Update your subscription so fresh servers arrive. 3) Turn on GozarTahrim Fragment. 4) If your server is behind Cloudflare, use the Alt IP Finder.

It never connects and drops immediately

Usually a wrong config or an expired subscription. First confirm with your provider that the service is active. If it is, remove the subscription and add it again.

Sometimes the network kills the connection at the moment it starts; in that case turn on GozarTahrim Fragment.

It is very slow

Test all servers from the three-dot menu and pick the one with the lowest latency. If you enabled fragmentation with a very high chunk count, lower it — more chunks means better evasion but less speed. Auto-connect to the best server also helps you stay on the fastest one.

Alt IP Finder says “unsupported”

The tool only works on VLESS servers. Select one of those and try again. If it says no server is selected, tap a server on the main list first. See the full guide here.

My phone says the app was not installed

If an older GozarTahrim or v2rayNG with a different signature is installed, uninstall it first. Also make sure the file downloaded completely — a truncated download produces this exact error. If it still fails, try universal.apk.

The connection drops after a while

Usually Android's battery optimisation. In your phone's battery settings, set GozarTahrim to Unrestricted so the system does not kill it in the background.

Does GozarTahrim provide free servers?

No. GozarTahrim is only the client application; it does not provide any servers. You supply your own config or subscription.

Is any of my data sent anywhere?

Your servers, configs and traffic stay on your device and are never sent to us. To deliver announcements and count active users, the app sends only an anonymous random identifier that is not tied to your identity. The source code is open and you can verify this yourself.