Добавить INSTALL.md

2026-04-11 20:30:40 +03:00
parent f4c9cf9238
commit 2b779d7ece
1 changed files with 86 additions and 0 deletions
@@ -0,0 +1,86 @@
+🚀 Быстрый старт
+ Установка Docker (если не установлен)
+# Для Ubuntu/Debian
+curl -fsSL https://get.docker.com -o get-docker.sh
+sudo sh get-docker.sh
+sudo usermod -aG docker $USER && newgrp docker
+
+2️⃣ Создание рабочей директории
+
+mkdir -p ~/wg-easy && cd ~/wg-easy
+
+🔐 Генерация хеша пароля
+docker run --rm ghcr.io/wg-easy/wg-easy password-hash ваш_надёжный_пароль
+Скопируйте полученный хеш и подставьте в параметр PASSWORD_HASH.
+
+3️⃣ Запуск контейнера
+docker run -d \
+  --name=wg-easy \
+  -e WG_HOST=ВАШ_ПУБЛИЧНЫЙ_IP \
+  -e PASSWORD_HASH='$(docker run --rm ghcr.io/wg-easy/wg-easy password-hash ВАШ_ПАРОЛЬ)' \
+  -e WG_DEFAULT_DNS=8.8.8.8,8.8.4.4 \
+  -v ~/wg-easy//etc/wireguard \
+  -p 51820:51820/udp \
+  -p 51821:51821/tcp \
+  --cap-add=NET_ADMIN \
+  --cap-add=SYS_MODULE \
+  --sysctl="net.ipv4.conf.all.src_valid_mark=1" \
+  --sysctl="net.ipv4.ip_forward=1" \
+  --restart unless-stopped \
+  ghcr.io/wg-easy/wg-easy
+  ⚠️ Важно: Замените ВАШ_ПУБЛИЧНЫЙ_IP на реальный внешний IP вашего сервера.
+
+  🎛️ Управление контейнером
+# 📊 Проверка статуса
+docker ps | grep wg-easy
+
+# 📋 Просмотр логов
+docker logs wg-easy
+docker logs -f wg-easy  # в реальном времени
+
+# 🔄 Перезапуск
+docker restart wg-easy
+
+# ⏹️ Остановка
+docker stop wg-easy
+
+# ▶️ Запуск
+docker start wg-easy
+
+# 🗑️ Удаление контейнера (данные в volume сохранятся)
+docker rm -f wg-easy
+
+# 🔄 Обновление образа
+docker pull ghcr.io/wg-easy/wg-easy
+docker stop wg-easy && docker rm wg-easy
+# Затем повторите команду запуска из раздела "Быстрый старт"
+
+📁 Расположение данных
+~/wg-easy/data/
+├── wg0.conf          # Конфигурация сервера WireGuard
+└── clients/          # Конфигурации клиентов (.conf файлы)
+
+📱 Подключение клиентов
+Через веб-интерфейс
+Откройте в браузере: http://ВАШ_IP:51821
+Введите пароль, указанный при установке
+Нажмите + New Client
+Выберите способ получения конфига:
+📥 Download — скачать файл .conf
+📷 QR Code — отсканировать камерой телефона
+Импорт в клиент WireGuard
+Платформа
+Инструкция
+Android
+Установите приложение WireGuard → «+» → «Импорт из файла/QR»
+iOS
+Установите WireGuard → «+» → «Сканировать QR» или «Импортировать»
+Windows
+Скачать клиент → «Import tunnel(s) from file»
+macOS/Linux
+Установите wireguard-tools, скопируйте .conf в ~/.wireguard/, запустите wg-quick up wg0
+
+🔄 Сброс пароля
+Сгенерируйте новый хеш:
+docker run --rm ghcr.io/wg-easy/wg-easy password-hash новый_пароль
+Пересоздайте контейнер с новым PASSWORD_HASH