📝 Описание проекта

Это веб-интерфейс для проекта goida-vpn-configs. Сайт автоматически парсит актуальные конфигурации (V2Ray / VLESS / Hysteria / Trojan / VMess / Reality / Shadowsocks), генерирует удобные ссылки для копирования, QR-коды и предоставляет инструкции по подключению.

✨ Ключевые особенности

• Динамические конфигурации: Данные подтягиваются напрямую из репозитория goida-vpn-configs, включая время последнего обновления.
• Двойной режим работы:
  • Динамический: Flask-приложение с API-эндпоинтами и кэшированием.
  • Статический: Генерация готового сайта для хостинга на GitHub Pages.
• Современный UI: TailwindCSS для стилизации, Alpine.js для интерактивности, поддержка темной и светлой тем.
• Интеграция с GitHub API: Автоматическое получение последних версий VPN-клиентов и статистики репозитория.
• Обход блокировок: Специальный раздел с инструкциями и конфигом для обхода SNI/CIDR белых списков.
• Видео-гайды: Встроенные видео-инструкции для упрощения настройки.
• Автоматизация: GitHub Actions каждый час запускает пересборку сайта для актуализации данных.

🏗️ Структура проекта

• main.py: Основной файл Flask-приложения. Содержит логику API для получения ссылок на ПО и статистики GitHub.
• services.py: Логика парсинга конфигураций и данных об обновлениях из внешних источников.
• build.py: Скрипт-генератор. Рендерит шаблоны в статические HTML-файлы и подготавливает JSON-файлы для API при статическом деплое.
• notes.md: Подробные технические заметки по проекту, структуре и обслуживанию.
• templates/: Jinja2 шаблоны, разделенные на модульные компоненты (hero, tabs, instructions и др.).
• static/: Стили, клиентские скрипты (statistics.js, update-download-links.js) и медиа-ресурсы.

🛠️ Технологии

• Backend: Python 3.10+, Flask, Waitress, Requests.
• Frontend: HTML5, TailwindCSS (CDN), Alpine.js (CDN), FontAwesome.
• CI/CD: GitHub Actions + Custom Python Build Script.

⚙️ Установка и запуск

Шаги установки:

1. Клонируйте репозиторий:

git clone https://github.com/AvenCores/goida-vpn-site.git
cd goida-vpn-site

2. Создайте виртуальное окружение:

python -m venv .env
# Windows:
.env\Scripts\activate
# Linux/macOS:
source .env/bin/activate

3. Установите зависимости:

pip install -r requirements.txt

Использование:

• Локальный сервер: python main.py (доступно на http://localhost:5000).
• Сборка сайта: python build.py (результат в папке dist/).

---

🚀 Автоматизация (GitHub Actions)

Проект настроен на автоматическое обновление:

1. По расписанию: Каждый час выполняется запуск build.py для обновления данных о конфигах.
2. При пуше: Любое изменение в ветке main триггерит деплой новой версии сайта в ветку gh-pages.

Для работы деплоя требуется Secret MY_TOKEN с правами доступа к репозиторию.

---

💰 Поддержать автора

• SBER: 2202 2050 1464 4675