# QuatrVPN на macOS

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

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

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

1. Скачайте **SFM** (sing-box for macOS):  
   https://github.com/SagerNet/sing-box/releases  
   Файл: **`SFM-*-universal.dmg`**
2. Перетащите приложение в **Programs** / **Applications**.

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

1. SFM → **Profiles** → **Import**.
2. Выберите `client-macos.json`.

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

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

1. Выберите профиль QuatrVPN.
2. Нажмите **Start**.
3. macOS запросит разрешение на VPN (Network Extension) — разрешите.

При первом запуске может понадобиться:  
**System Settings → Privacy & Security → Full Disk Access** → добавьте SFM.

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

```bash
curl -4 ifconfig.me
```

IP должен совпадать с IP VPN-сервера.

---

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

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

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

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

Требуется macOS 13.0+. Если приложение уже установлено — обновите до последней версии.

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

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

1. Скопируйте `vless://...` из `share-links.txt` или личного кабинета.
2. v2rayTUN → **+** → **Import from clipboard**.

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

1. Выберите `client-macos.json`.
2. Откройте файл → «Открыть в v2rayTUN» или импортируйте через **+** → **Import from file**.

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

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

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

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

```bash
curl -4 ifconfig.me
```

IP должен совпадать с IP VPN-сервера. Удалите **старые профили** из 3x-ui — оставьте только актуальный конфиг QuatrVPN.

---

## Способ 3: CLI (для продвинутых)

```bash
brew install sing-box
sudo sing-box run -c /path/to/client-macos.json
```

---

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

SFM → **Dashboard** → **Outbound**:

| Outbound | Назначение |
|----------|------------|
| `quatr-auto` | Автовыбор |
| `quatr-reality` | TCP, маскировка |
| `quatr-hysteria2` | UDP, резерв |

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