feat: Добавлен скрипт установки, документация для сервера и Docker, обновлен README.
This commit is contained in:
178
docs/DOCKER.md
Normal file
178
docs/DOCKER.md
Normal file
@@ -0,0 +1,178 @@
|
||||
# 🐳 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)
|
||||
Reference in New Issue
Block a user