# QuatrVPN на iPhone и iPad

**Рекомендуем sing-box (SFI)** — полный профиль Q4, оба транспорта (REALITY + Hysteria2). **v2rayTUN** подойдёт, если уже пользовались им со старым конфигом из 3x-ui.

## Способ 1: sing-box (рекомендуется)

### 1. Установите SFI

**App Store** (если доступен в регионе):  
https://apps.apple.com/app/sing-box/id6476628951

**Или вручную (IPA):**

1. Скачайте `SFI-*-universal.ipa` с https://github.com/SagerNet/sing-box/releases
2. Установите через AltStore, Sideloadly или аналог.

### 2. Импортируйте конфиг

1. Передайте `client-ios.json` на iPhone:
   - AirDrop с Mac
   - iCloud Drive
   - Telegram / почта → «Открыть в sing-box»
2. Откройте файл → **Import**.
3. Профиль появится в списке.

**Из ссылки:** скопируйте `vless://...` → SFI → Import from clipboard.

### 3. Подключитесь

1. Выберите профиль QuatrVPN.
2. Включите VPN.
3. iOS запросит разрешение на VPN-конфигурацию — нажмите **Разрешить**, при необходимости введите пароль / Face ID.

### 4. Проверка

Safari → https://ifconfig.me — IP должен быть IP сервера QuatrVPN.

---

## Способ 2: v2rayTUN (если уже использовали раньше)

Если раньше подключались через **v2rayTUN** к старому VLESS из 3x-ui — **это же приложение подходит и для QuatrVPN**. Менять клиент не обязательно, но **приоритет — sing-box** (см. выше).

### 1. Установите v2rayTUN

**App Store:** https://apps.apple.com/app/v2raytun/id6476628951

Если приложение уже установлено — обновите до последней версии.

### 2. Импортируйте новый конфиг

**Из ссылки (как раньше):**

1. Скопируйте `vless://...` из `share-links.txt` или личного кабинета.
2. v2rayTUN → **+** → **Import from clipboard** (или «Из буфера обмена»).
3. Профиль **QuatrVPN** появится в списке.

**Из файла:**

1. Передайте `client-ios.json` на iPhone (AirDrop, iCloud, Telegram).
2. Откройте файл → «Открыть в v2rayTUN» или импортируйте через **+** → **Import from file**.

> v2rayTUN поддерживает **VLESS + REALITY** — основной транспорт QuatrVPN. Резерв **Hysteria2** во всех версиях может не работать; для полного профиля Q4 используйте [sing-box](#способ-1-sing-box-рекомендуется).

### 3. Подключитесь

1. Выберите профиль QuatrVPN.
2. Включите подключение.
3. Разрешите добавление VPN-конфигурации (Face ID / пароль).

### 4. Проверка

Safari → https://ifconfig.me — IP должен быть IP сервера QuatrVPN.

Удалите **старые профили** из 3x-ui (порты `17669` / `16969`) — оставьте только актуальный конфиг QuatrVPN.

---

## Способ 3: Streisand / Shadowrocket

Платные приложения из App Store, удобны для импорта по ссылке.

1. Скопируйте `vless://...` из личного кабинета.
2. Откройте приложение → **+** → **Добавить из буфера**.
3. Для резерва добавьте `hysteria2://...` отдельной нодой.

| Приложение | REALITY | Hysteria2 |
|------------|---------|-----------|
| Streisand | ✅ | ✅ |
| Shadowrocket | ✅ | ✅ |

---

## Переключение транспорта

SFI → **Dashboard** → **Outbound** → выберите `quatr-auto`, `quatr-reality` или `quatr-hysteria2`.

---

## Частые проблемы

| Симптом | Решение |
|---------|---------|
| «Failed to start VPN» | Переимпортируйте `client-ios.json` или `vless://...` (не macOS/android версию) |
| v2rayTUN: старый профиль не работает | Удалите конфиг из 3x-ui, импортируйте новую ссылку QuatrVPN |
| VPN отключается через 10 мин | При sideload IPA — перевыпустите подпись AltStore |
| Медленно | Переключите на `quatr-hysteria2` |

[← Все устройства](README.md) · [Устранение неполадок](troubleshooting.md)