vpn-proxy/docs/SERVER.md

🌍 Установка на Сервер (Linux VPS)

Эта инструкция для установки прокси на удалённый сервер. После установки вы сможете подключаться к нему с любого устройства.

---

📖 Зачем это нужно?

• 🌐 Один прокси для всех устройств — компьютер, телефон, планшет
• 🔒 Работает 24/7 — не нужно держать компьютер включённым
• 📡 Полная поддержка UDP — голосовые звонки и игры работают отлично
• 🏠 Доступ из любого места — дома, на работе, в поездке

---

🔧 Требования к серверу

• ОС: Ubuntu 20.04+, Debian 11+, или любой современный Linux
• Ресурсы: Минимум 512 MB RAM, 1 CPU
• Порты: 3456 (веб-интерфейс), 8080 (прокси)
• Доступ: SSH подключение

💡 Подойдёт любой VPS за $3-5/месяц от DigitalOcean, Vultr, Hetzner и др.

---

🚀 Установка

Шаг 1: Подключитесь к серверу

Откройте терминал (PowerShell на Windows, Terminal на Mac/Linux):

ssh root@ваш_сервер_ip

Введите пароль когда попросят.

💡 Совет: Если вы на Windows и нет ssh команды, используйте PuTTY или Windows Terminal.

---

Шаг 2: Установите Docker

Если Docker ещё не установлен:

# Автоматическая установка Docker
curl -fsSL https://get.docker.com | sh

# Проверка что Docker работает
docker --version

---

Шаг 3: Загрузите проект

Вариант A: Через Git

git clone https://github.com/your-repo/vpn-proxy.git
cd vpn-proxy

Вариант B: Загрузка файлов вручную

Если git недоступен, скачайте ZIP архив и распакуйте на сервере.

---

Шаг 4: Запустите контейнер

⚠️ Важно: Используйте docker-compose.server.yml — он настроен для серверов!

docker compose -f docker-compose.server.yml up -d

Это запустит контейнер с network_mode: host, что решает проблемы с UDP.

---

Шаг 5: Откройте порты в файрволе

Для UFW (Ubuntu/Debian):

ufw allow 3456/tcp   # Веб-интерфейс
ufw allow 8080/tcp   # Прокси TCP
ufw allow 8080/udp   # Прокси UDP (для голоса/игр)
ufw reload

Для firewalld (CentOS/RHEL):

firewall-cmd --permanent --add-port=3456/tcp
firewall-cmd --permanent --add-port=8080/tcp
firewall-cmd --permanent --add-port=8080/udp
firewall-cmd --reload

Для iptables:

iptables -A INPUT -p tcp --dport 3456 -j ACCEPT
iptables -A INPUT -p tcp --dport 8080 -j ACCEPT
iptables -A INPUT -p udp --dport 8080 -j ACCEPT

---

Шаг 6: Настройте VPN через веб-интерфейс

1. Откройте в браузере: http://ваш_сервер_ip:3456
2. Вставьте VLESS-ссылку или URL подписки
3. Нажмите "Применить"

---

✅ Проверка работы

На сервере:

# Проверить что контейнер запущен
docker ps

# Посмотреть логи
docker logs --tail 20 sing-proxy

С вашего компьютера:

# Проверить прокси
curl -x http://ваш_сервер_ip:8080 https://ipinfo.io/ip

Должен показать IP VPN-сервера (не IP вашего VPS).

---

🖥️ Подключение с Windows

Настройка в manage.ps1

При настройке Discord (пункт [2]) вы можете указать адрес удалённого прокси:

Введите адрес прокси (IP:порт): ваш_сервер_ip:8080

Настройка в браузере/приложениях

• Адрес: ваш_сервер_ip
• Порт: 8080
• Тип: HTTP или SOCKS5

---

📋 Управление

Действие	Команда
Посмотреть статус	docker ps
Логи	docker logs --tail 50 sing-proxy
Остановить	docker compose -f docker-compose.server.yml stop
Запустить	docker compose -f docker-compose.server.yml start
Перезапустить	docker compose -f docker-compose.server.yml restart
Удалить	docker compose -f docker-compose.server.yml down

---

🔐 Рекомендации по безопасности

1. Смените стандартные порты

Отредактируйте docker-compose.server.yml:

environment:
  - PORT=54321        # Вместо 3456
  - PROXY_PORT=12345  # Вместо 8080

2. Ограничьте доступ к веб-интерфейсу

Если веб-интерфейс нужен только для первоначальной настройки:

# Закрыть веб-порт после настройки
ufw delete allow 3456/tcp

3. Используйте SSH туннель

Для безопасного доступа к веб-интерфейсу:

ssh -L 3456:localhost:3456 root@ваш_сервер_ip

Затем откройте http://localhost:3456 в браузере.

---

🔄 Обновление

cd vpn-proxy

# Получить обновления
git pull

# Пересобрать контейнер
docker compose -f docker-compose.server.yml down
docker compose -f docker-compose.server.yml build --no-cache
docker compose -f docker-compose.server.yml up -d

---

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

Порт 3456 не открывается

Причина: Файрвол блокирует подключения.

Решение: Проверьте настройки файрвола, см. Шаг 5.

"Permission denied" при запуске Docker

Решение:

# Добавить пользователя в группу docker
sudo usermod -aG docker $USER

# Перезайти
exit
ssh root@ваш_сервер_ip

Контейнер постоянно перезапускается

# Посмотреть логи ошибок
docker logs sing-proxy

Обычно проблема в неверной VLESS-ссылке.

---

📐 Изменение портов

По умолчанию:

• 3456 — веб-интерфейс
• 8080 — прокси

Для изменения создайте файл .env в папке проекта:

PORT=54321
PROXY_PORT=12345

И перезапустите:

docker compose -f docker-compose.server.yml up -d

---

← Вернуться к основной инструкции