# 🐳 Docker — Веб-интерфейс для управления VPN

> **Это продвинутый способ** установки с красивым веб-интерфейсом. Для большинства пользователей рекомендуется использовать [основной способ через PowerShell](../README.md).

---

## 📖 Что это даёт?

- 🌐 **Веб-интерфейс** — управление через браузер на http://localhost:3456
- 📡 **Подписки** — автоматическое получение списка серверов
- 🔄 **Переключение серверов** — в один клик
- 💾 **Сохранение настроек** — URL и выбранный сервер сохраняются



---

## 🔧 Требования

### Docker Desktop

1. Скачайте: https://www.docker.com/products/docker-desktop/
2. Установите и запустите
3. Убедитесь, что иконка 🐳 есть в трее (панель задач)

> 💡 На Windows может потребоваться WSL2. Docker Desktop предложит его установить автоматически.

---

## 🚀 Установка

### Шаг 1: Откройте терминал

Откройте PowerShell или Командную строку и перейдите в папку проекта:

```powershell
cd путь\к\папке\vpn-proxy
```

### Шаг 2: Соберите контейнер

```powershell
docker compose build
```

Это создаст образ со всеми необходимыми компонентами. Выполняется один раз.

### Шаг 3: Запустите

```powershell
docker compose up -d
```

Флаг `-d` запускает контейнер в фоновом режиме.

### Шаг 4: Откройте веб-интерфейс

Перейдите в браузере: **http://localhost:3456**

---

## 🌐 Использование веб-интерфейса

### Режим подписки

1. Вставьте URL подписки в поле "Подписка"
2. Нажмите **"Загрузить серверы"**
3. Выберите сервер из списка
4. Нажмите **"Применить"**

### Режим VLESS

1. Перейдите на вкладку "VLESS Ключ"
2. Вставьте VLESS-ссылку (`vless://...`)
3. Нажмите **"Применить"**

> 💡 Настройки сохраняются в папке `data/` и восстанавливаются при перезапуске.

---

## 🌐 Порты

| Порт | Назначение | URL |
|------|------------|-----|
| `3456` | Веб-интерфейс | http://localhost:3456 |
| `8080` | HTTP/SOCKS5 прокси | `127.0.0.1:8080` |
| `9090` | API управления (внутренний) | — |

---

## 📋 Управление контейнером

| Действие | Команда |
|----------|---------|
| Посмотреть статус | `docker ps` |
| Посмотреть логи | `docker logs --tail 50 sing-proxy` |
| Остановить | `docker compose stop` |
| Запустить снова | `docker compose start` |
| Перезапустить | `docker compose restart` |
| Полностью удалить | `docker compose down` |
| Пересобрать | `docker compose up -d --build` |

---

## 🔄 Обновление

Если вы обновили код из репозитория:

```powershell
# Остановить текущий контейнер
docker compose down

# Пересобрать с новыми изменениями
docker compose build --no-cache

# Запустить заново
docker compose up -d
```

> 💡 Подписка и настройки сохраняются в папке `data/` и не потеряются.

---

## ⚙️ Настройка приложений

### Для VS Code

```json
{
  "http.proxy": "http://127.0.0.1:8080",
  "http.proxyStrictSSL": true
}
```

### Для браузера

- **Адрес**: `127.0.0.1`
- **Порт**: `8080`
- **Тип**: HTTP или SOCKS5

---

## ❓ Проблемы и решения

### Страница localhost:3456 не открывается

**Причина:** Контейнер не запущен.

```powershell
# Проверьте статус
docker ps

# Если контейнера нет — запустите
docker compose up -d
```

### "Connection refused"

**Причина:** VPN-ссылка не применена.

1. Откройте http://localhost:3456
2. Примените VLESS-ссылку или загрузите подписку

### Медленное подключение

Попробуйте другой сервер в веб-интерфейсе — некоторые серверы могут быть перегружены.

---

## ⚠️ Ограничения Docker на Windows

- **UDP для Discord:** Docker на Windows/macOS имеет проблемы с UDP ASSOCIATE для SOCKS5. Для Discord рекомендуется использовать [нативную установку](../README.md).

- **Для полной поддержки UDP** используйте [установку на Linux сервер](SERVER.md) с `network_mode: host`.

---

[← Вернуться к основной инструкции](../README.md)