# QuatrVPN на iPhone и iPad

**Используйте sing-box (SFI)** — полный профиль Q5 (Trojan + AnyTLS + TUIC). Старые конфиги Q4 не работают.

## Способ 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. Импортируйте конфиг

> **sing-box 1.12+** (актуальный SFI из App Store): [client.json](configs/vpn2/client.json) — полный Q5 (Trojan + AnyTLS + TUIC)  
> **sing-box 1.11.x** (ошибки DNS / `tls.fragment` / `anytls`): [client-ios.json](configs/vpn2/client-ios.json) — Trojan + TUIC

1. Выберите сервер в [index.json](configs/index.json), скачайте нужный файл (пример: vpn2) и передайте на iPhone:
   - AirDrop с Mac
   - iCloud Drive
   - Telegram / почта → «Открыть в sing-box»
2. Откройте файл → **Import**.
3. Профиль появится в списке.

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

### 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. Скопируйте `trojan://...` из [share-links.txt](configs/vpn2/share-links.txt).
2. v2rayTUN → **+** → **Import from clipboard** (или «Из буфера обмена»).
3. Профиль **QuatrVPN** появится в списке.

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

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

> v2rayTUN поддерживает только Trojan. Для полного Q5 — [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. Скопируйте `trojan://...` из [share-links.txt](configs/vpn2/share-links.txt).
2. Откройте приложение → **+** → **Добавить из буфера**.
| Приложение | Trojan | TUIC | AnyTLS |
|------------|--------|------|--------|
| sing-box (SFI) | ✅ | ✅ | ✅ |
| Streisand | ✅ | ✅ | ❌ |
| Shadowrocket | ✅ | ✅ | ❌ |

---

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

SFI → **Dashboard** → **Outbound** → `quatr-auto`, `quatr-trojan`, `quatr-anytls` или `quatr-tuic`.

---

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

| Симптом | Решение |
|---------|---------|
| `dns.servers[0].type: unknown field "type"` | sing-box < 1.12 — **client-ios.json** или обновите SFI |
| `tls.fragment: unknown field "type"` | sing-box < 1.12 — **client-ios.json** или обновите SFI до 1.12+ |
| `unknown outbound type: anytls` | sing-box < 1.12 — **client-ios.json** (без AnyTLS) или обновите SFI до 1.12+ |
| «Failed to start VPN» | Переимпортируйте Q5 `client.json` / `client-ios.json` (не старый Q4) |
| Старый Q4 конфиг | Скачайте новый — REALITY/Hysteria2 сняты |
| VPN отключается через 10 мин | При sideload IPA — перевыпустите подпись AltStore |
| Медленно | Переключите на `quatr-tuic` |

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