# v2RayTun

Proxy Client

## Overview:

v2RayTun is a powerful and versatile app that empowers you to configure and manage personalized proxy servers with ease.


# About Premium+

Мы наконец-то рады сообщить вам о запуске нашего уникального сервиса для VPN-сервисов — подписки Premium+.

Мы понимаем, что использование v2raytun в основном приходится на VPN-сервисы, поэтому представляем вам уникальную систему, которая позволит всем VPN-сервисам получить дополнительные функции, облегчающие взаимодействие с пользователями.

Представленные ниже функции уже работают и уже реализованы в наших приложениях на всех доступных платформах.

### <mark style="color:orange;">**Какие же преимущества вы получаете после приобретения подписки - Premium+?**</mark>

1. Возможность брендирования вашего VPN-сервиса в приложении v2raytun.&#x20;
2. Ваш ключ/подписка всегда находится вверху отдельным блоком
3. Создание собственной страницы с информацией и необходимыми ссылками, которые направляют ваших клиентов на вашу техническую поддержку и на ваш сайт.
4. Уникальная система антибана.
5. Окно с предложением обратиться в техническую поддержку VPN-сервиса, если ключ не работает по какой-либо причине.

### <mark style="color:orange;">Брендирование VPN-сервиса</mark>

При оплаченной подписке Premium+ и добавленным доменом, при импорте вашего ключа ваш ключ или подписка получает свое выделенное окно с вашим логотипом и с вашим названием.

<figure><img src="https://2902213438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHZ5CDbK0xvmrJLip522s%2Fuploads%2FhV7X16iEYCRvKAP9zPrG%2Fphoto_2024-05-01_23-21-43.jpg?alt=media&amp;token=2cbe44f3-300e-4fee-a22a-0ec1fdaa5cd9" alt="" width="375"><figcaption></figcaption></figure>

Также вы получаете личную информационную страницу

<figure><img src="https://2902213438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHZ5CDbK0xvmrJLip522s%2Fuploads%2FcAx9XTdCLi9UnXlQq7Xy%2Fphoto_2025-02-10_19-09-40.jpg?alt=media&amp;token=d50a5053-61e9-467e-a5c5-d51a2a942d7d" alt="" width="296"><figcaption></figcaption></figure>

### <mark style="color:orange;">Государственная блокировка домена (Антиблокировочная система)</mark>

Лично мы уже не раз сталкивались с таким видом блокировок, чтобы заблокировать VPN сервис они просто блокируют домены подключения ключей, в результате такого вида блокировки все ключи или подписки выданные юзерам прекращают свою работу.

Поэтому мы придумали совершенно уникальную систему замены доменов на всех ключах или подписках ваших юзеров. Вы спокойно можете взять и по щелчку пальцев заменить заблокированный домен на новый рабочий домен.

Чтобы заменить домен достаточно в управлении вашим доменом нажать "Изменить домен"

<figure><img src="https://2902213438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHZ5CDbK0xvmrJLip522s%2Fuploads%2F9Jp2BTc1FzxY9U8vrFli%2F2024-05-01%2023.54.09.jpg?alt=media&amp;token=4cddab04-20e4-43c5-8fad-e2690dff8a2c" alt="" width="192"><figcaption></figcaption></figure>

### <mark style="color:orange;">Поддержка ваших пользователей</mark>

Если по какой-либо причине у вашего пользователя возникла трудность с подключением к вашему серверу по вашему ключу ему будет выдано меню с ошибкой и кнопкой вашей технической поддержки.

<figure><img src="https://2902213438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHZ5CDbK0xvmrJLip522s%2Fuploads%2FZGiOp8MRhNTWRjil63hS%2F2024-05-02%2000.35.42.jpg?alt=media&amp;token=effa9a50-6d11-4f3d-abab-a5137535abdc" alt="" width="375"><figcaption></figcaption></figure>

### <mark style="color:orange;">Оплата подписки и добавление доменов</mark>

Все взаимодействие с Premium+ происходит через бота в телеграмм, там вы сможете оплатить подписку и зарегистрировать ваш VPN сервис.

1. Перейдите в официального бота v2raytun - Premium+ ([@v2raytun\_bot](https://t.me/v2raytun_bot))
2. Выберите язык и нажмите "Купить доступ"
3. Укажите примерное реальное количество пользователей, это поможет персонализировать цену. Пожалуйста, указывайте правдивые значения.
4. Оплатите удобным вам способом.

### <mark style="color:orange;">Добавление домена</mark>

Чтобы ваш ключ при импорте его в v2raytun имел маркировку вам необходимо зарегистрировать домен верхнего уровня этого ключа. Например ваш ключ/подписка:

{% code overflow="wrap" %}

```
vless://dd4bc332fd81f0749a685d410913e675@uk.testdomain.com:27438?type=tcp&security=reality&fp=chrome&pbk=YjJAdVPWTFk7q0EYX4aoYfTTi7-6JEb5kDgAA6tfQWk&sni=google.com&flow=xtls-rprx-vision&sid=1f8469df&spx=%2F#Test
```

{% endcode %}

Домен этого ключа uk.testdomain.com, это значит, что вам необходимо добавить домен testdomain.com

После покупки подписки Premium+ у вас появится новое меню "Управление доменами", нажмите на него. В появившемся окне вы сможете увидеть, сколько свободных мест для доменов у вас осталось. По умолчанию доступно 3 места, если вам необходимо больше, свяжитесь с администрацией. Чтобы добавить домен нажмите на "Добавить домен", далее введите ваш домен верхнего уровня (например: testdomain.com).

Все добавленные вами домены вы сможете удалять и добавлять бесконечное кол-во раз.

### <mark style="color:orange;">v2RayTun на Android</mark>

С 1 Мая доступен и на системах под управлением операционной системы Android, весь функционал v2Raytun Premium+ также доступен.


# Supported headers

v2RayTun supports different headers that can be sent by subscription servers

<figure><img src="https://2902213438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHZ5CDbK0xvmrJLip522s%2Fuploads%2FZLcvA2upcvC6a614ynO8%2Fpreview.png?alt=media&amp;token=4acff515-4d33-44bf-9526-a34f174a37fd" alt="" width="294"><figcaption><p>Preview</p></figcaption></figure>

## To know:

* v2RayTun supports HTTP headers and body headers
* v2RayTun supports base64 encoded and raw body headers

## profile-title

Subscription name shown in the application

v2RayTun supports two formats:

* **Raw string**
* **Base64 Encoded string** (must starts with `base64:` prefix)

#### Examples:

```
profile-title: "MyVPN"
profile-title: "base64:8J+agCBNeVZQTg=="
```

## subscription-userinfo

Information about the subscription, how much traffic has been used, how much maximum traffic, when the subscription ends

**Supported values:**

* upload
* download
* total
* expire

#### Examples:

```
subscription-userinfo: "upload=0; download=100000; total=2000000; expire=1749954800"
subscription-userinfo: "expire=1749954800"
```

It is not necessary to pass all parameters.

## profile-update-interval

The time interval when to renew your subscription. For example, once an hour

**Important! The value is taken in hours**\
**If you passed `profile-update-interval: 1`**\
**This means that the subscription will be updated every hour.**

#### Examples:

```
profile-update-interval: "1"
profile-update-interval: "12
```

## routing

v2RayTun can automatically use always shared routing for this subscription.

#### Examples:

{% code overflow="wrap" %}

```
routing: "eyJkb21haW5TdHJhdGVneSI6IkFzSXMiLCJpZCI6IjFFQUE4OEJCLUI1RjUtNEY2OS04MkQwLTlGRjQ0OTkwODc5NCIsImJhbGFuY2VycyI6W10sImRvbWFpbk1hdGNoZXIiOiJoeWJyaWQiLCJydWxlcyI6W3siZG9tYWluIjpbInJlZ2V4cDouKlxcXFwucnUkIiwiZ2Vvc2l0ZTpjYXRlZ29yeS1ydSJdLCJpZCI6IjlDQTYyQzY5LTNEN0EtNEZFNS05RTE5LTIxODlFMkU0ODUzRSIsIm91dGJvdW5kVGFnIjoiZGlyZWN0IiwidHlwZSI6ImZpZWxkIiwiX19uYW1lX18iOiJEaXJlY3QgUnVzc2lhIiwiaXAiOlsiZ2VvaXA6cnUiXX1dLCJuYW1lIjoiRXhhbXBsZSJ9"
```

{% endcode %}

#### How to get the base64 encoded routing?

<div><figure><img src="https://2902213438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHZ5CDbK0xvmrJLip522s%2Fuploads%2FH79cahBPjFYvA2g7BTv3%2Frouting_step_1.png?alt=media&amp;token=8f850697-780f-4380-9999-340f523e1977" alt="" width="294"><figcaption><p>Step 1</p></figcaption></figure> <figure><img src="https://2902213438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHZ5CDbK0xvmrJLip522s%2Fuploads%2FDKywDA7Aiy2GlxuVS9CJ%2Frouting_step_2.png?alt=media&amp;token=cdc413d2-24cd-4e18-9a19-2e435466e776" alt="" width="294"><figcaption><p>Step 2</p></figcaption></figure> <figure><img src="https://2902213438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHZ5CDbK0xvmrJLip522s%2Fuploads%2FLaqX8LnbNChCPhrJ1Bi3%2Frouting_step_3.png?alt=media&amp;token=8d273c1e-b549-4ccc-8456-66dfbee292e9" alt="" width="294"><figcaption><p>Step 3</p></figcaption></figure></div>

The final result should be something like that: "eyJkb21haW5...."\
This value you have to pass into `routing` header

#### To know:

1. The routing passed to the subscription will be used over the routing configured in the application and Direct Service.
2. The routing should be exactly as you got from application
3. If subscriptions routing using, you'll get message in app logs about that

## announce

Announcements allow VPN services to notify a specific user or all users. You can come up with whatever you want

v2RayTun supports two formats:

* **Raw string**
* **Base64 Encoded string** (must starts with `base64:` prefix)

**v2RayTun also supports colored text for announce, you can color the text in any RGB color**\
**if you pass #RRRGGBB before the beginning of the word**

You can also customize the link that will open when you click on the announcement text.\
See [announce-url](#announce-url)

#### Examples:

```
announce: "🚀 Our servers got a #27e8d5performance boost to #e8cb27lighting speed!"
announce: "base64:8J+agCBPdXIgc2VydmVycyBnb3QgYSAjMjdlOGQ1cGVyZm9ybWFuY2UgYm9vc3QgdG8gI2U4Y2IyN2xpZ2h0aW5nIHNwZWVkIQ=="
```

## announce-url

The user can open the link you passed when they click on the announcement text

#### Examples:

```
announce-url: "https://t.me/v2raytun"
```

## update-always

Force subscription renewal every time a user logs into the app.

To know:

* If you enable this parameter, v2RayTun will ignore[ profile-update-interval](#profile-update-interval)
* The user's subscription will be updated every time they log into the app, but provided they have VPN disabled.

#### Examples:

```
update-always: "true"
```

## network-filter

An optional subscription header that controls whether configurations are shown based on the user's network type.

When set to `true`, the client filters configurations by their names:

* Configurations containing `LTE` or `Only mobile` are shown only on mobile networks
* Configurations containing `WiFi` or `Only Wifi` are shown only on Wi-Fi
* Other configurations are always shown

If the header is missing or set to `false`, no filtering is applied.

<figure><img src="https://2902213438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHZ5CDbK0xvmrJLip522s%2Fuploads%2FlWXt1B6kfIrM5TpG9DOT%2FFrame%201.jpg?alt=media&amp;token=33a3648e-2879-4f09-8f11-0f6950dad388" alt="" width="563"><figcaption></figcaption></figure>


# Device limit

v2RayTun since version 2.3.5 supports passing headers to limit the number of devices on a single subscription.

* X-HWID
* X-Device-OS
* X-Ver-OS
* X-Device-Model
* X-App-Version

This header format was first established in [Remnawave](https://remna.st/)

<figure><img src="https://2902213438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHZ5CDbK0xvmrJLip522s%2Fuploads%2F7jwyAXo5cnMuXyBlS36j%2Fimage.png?alt=media&amp;token=7bbab4c3-d6b0-42d2-9e10-b9da4f409b7a" alt=""><figcaption><p>Example</p></figcaption></figure>

## Supported panels:

* [Remnawave](https://remna.st)


# Privacy policy

This page describes privacy policy for v2RayTun Proxy client

Services provided by v2RayTun are intended for use as is.

This page is used to inform visitors regarding our policies with the collection, use, and disclosure of Personal Information if anyone decided to use our Service.

If you choose to use our Service, then you agree to the collection and use of information in relation to this policy. The Personal Information that we collect is used for providing and improving the Service. We will not use or share your information with anyone except as described in this Privacy Policy.

The terms used in this Privacy Policy have the same meanings as in our Terms and Conditions, which is accessible individual apps unless otherwise defined in this Privacy Policy.

## VPN DATA

We **DO NOT** collect or store any VPN data.\
We **DO NOT** modify the contents of your VPN data.\
We **DO NOT** share any sensitive or user-specific data with third parties.\
v2RayTun is a non-centralized VPN app with users connecting to their own custom configured servers and doesn’t provide any centrally controlled servers for now. This means you as a user connecting to your own server do have complete control and liability over your VPN data. The app itself will not in any way modify any VPN data as it leaves the device to your configured VPN server.

## DATA COLLECTION

v2RayTun only collects and shares the app's crash logs and diagnostics. Crash log data may for example be, the number of times that your app has crashed, stack traces or other information directly related to a crash. Analytics data may include; how long a user spent on a certain screen in the app. This information is collected and shared by/with Firebase Crashlytics and analytics. This helps in improving the app quality by ensuring any crashes and bugs are fixed. No individually/personally identifying information is collected/shared.

### **CHILDREN’S PRIVACY**

v2RayTun does not collect any personally identifiable information from any one be it child or adult. This thus implies that no personally identifiable information is collected from children under 13.

## Links to Other sites

This Service may contain links to other sites. If you click on a third-party link, you will be directed to that site. Note that these external sites are not operated by us. Therefore, we strongly advise you to review the Privacy Policy of these websites. We have no control over and assume no responsibility for the content, privacy policies, or practices of any third-party sites or services.

### CHANGES TO THIS PRIVACY POLICY

We may update our Privacy Policy from time to time. Thus, you are advised to review this page periodically for any changes. We will notify you of any changes by posting the new Privacy Policy on this page. These changes are effective immediately after they are posted on this page.

## Contact us

If you have any questions or suggestions about our Privacy Policy, do not hesitate to contact us.


# Terms of Services

{% embed url="<https://www.apple.com/legal/internet-services/itunes/dev/stdeula/>" %}
EULA
{% endembed %}


# Contact us

## Telegram

<https://t.me/v2raytun>

## Email

<admin@databridges.tech>


# Donate

Donate us:\
\
**Cryptobot:** [t.me/send?start=IVFZxLsuIosQ](https://t.me/send?start=IVFZxLsuIosQ)\
\
**Also you can donate in IOS App through Apple Pay**


# Deep link

You can import configuration through deep link:\
`v2raytun://import/{configuration}`

`v2raytun://import/{subscription_link}`


# Crypto link

The application supports encrypted links. Links can be encrypted using RSA-4096. Link encryption is designed to hide the subscription address from the user. After adding an encrypted subscription, the

‼️ **API will be available soon..** ‼️

Deep link:\
`v2raytun://crypt/{ENCRYPTED}`

**RSA 4096 Public key**

```
-----BEGIN PUBLIC KEY-----
MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEArK77160gyNm0olpdA+WO
f1ClV4ndeRhBDYPQYs4hUq3YDwP1dQTdxaILcdnYJS2Wpfzqo8JiAvwhatBHJ2Kq
p/KSll5JSoqYAKj+1GdSF+nOCXc3wBeGR8mD6KdSRnoAE+x6wZcydNggQluClcx3
zTGjwWnBxUWfKlcQeHxHTtO+2i6Dga2o4it5J2uXOupEo9mrBZdc1BSKvrmoycMp
iaRF4YKRhwY1jZnEjx2BKA/xFQIDiIFQIAIKKPNKoIWbnQ66lEJSOr1DuIVGYgdr
xyupIQW3rvkGirybgx0+lIOn9J7c9doBDWHknOqGG0VeGKiVFMv5klG7KTsH89qe
nXfgrGQVEknAeGOrMPgjF+Zs52eHLeaWXCr4sCRgvAoPeBfMTfavu/Y0mnufD8SN
z8OdQSVT9jphXeM2YXtnwi971fsF97bykEK5ytco4zf9hgbEjioU7/cAvz20RyxY
EFCouOZsGXkwlUq+xDEPRIyQj2OwGl5xpjDJ4uAq5Shi4EUk01wUfRzTVDQIWJXC
O7Z9K4FcKRKY3m42fWr8fZl5rQbnmrLMLnD88n7VZBRkIhfnt7XHtTCVWBwCDqsG
ceUX0Xf+ZwQ8tNYfE5ipy6RlkuZD8Ddlpk8qhstCBu82igNfRcSsJ5KT36aAhfZ+
WYqjdHmjzdjEGJqpfg1K1JMCAwEAAQ==
-----END PUBLIC KEY-----
```

‼️ Will be released in IOS 2.4.2, then Android and Windows.