209 lines
6.5 KiB
Markdown
209 lines
6.5 KiB
Markdown
# 🐳 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 управления (внутренний) | — |
|
||
|
||
### 🔧 Изменение порта прокси
|
||
|
||
Если порт `8080` уже занят, можно запустить на другом порту (например, `8082`):
|
||
|
||
**Способ 1: Через переменную окружения (Mac/Linux)**
|
||
|
||
```bash
|
||
PROXY_PORT=8082 docker compose up -d
|
||
```
|
||
|
||
**Способ 2: Через переменную окружения (Windows PowerShell)**
|
||
|
||
```powershell
|
||
$env:PROXY_PORT=8082; docker compose up -d
|
||
```
|
||
|
||
**Способ 3: Через .env файл (универсальный)**
|
||
|
||
Создайте файл `.env` в корне проекта:
|
||
|
||
```
|
||
PROXY_PORT=8082
|
||
```
|
||
|
||
Затем запустите:
|
||
|
||
```bash
|
||
docker compose up -d
|
||
```
|
||
|
||
> 💡 URL подключения изменится на `http://127.0.0.1:8082` и `socks5://127.0.0.1:8082`
|
||
|
||
---
|
||
|
||
## 📋 Управление контейнером
|
||
|
||
| Действие | Команда |
|
||
| ----------------- | ---------------------------------- |
|
||
| Посмотреть статус | `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)
|