Thanks to visit codestin.com
Credit goes to github.com

Skip to content

imdeniil/giis-srv-selector

Repository files navigation

GIIS Server Selector

Version Platform Python License

GUI утилита для управления stunnel конфигурацией на Windows

📦 Дополнительный пакет к проекту GIIS Signer

Скачать релизДокументацияСообщить об ошибке


📋 Описание

Простое и удобное приложение для переключения между различными серверами stunnel через графический интерфейс. Избавляет от необходимости ручного редактирования конфигурационных файлов и управления службами Windows.

Часть экосистемы GIIS: Эта утилита предназначена для использования совместно с GIIS Signer - основным инструментом для работы с ГИИС.

✨ Возможности

  • 🖥️ Простой GUI - интуитивно понятный интерфейс
  • 🔄 Быстрое переключение - смена сервера в 2 клика
  • 💾 Сохранение настроек - путь к конфигу сохраняется автоматически
  • 🔒 Безопасность - резервное копирование перед изменениями
  • 📝 Логирование - детальные логи всех операций
  • Автоматизация - перезапуск службы без участия пользователя
  • 🛡️ Проверка прав - автоматический запрос прав администратора

🚀 Быстрый старт

Установка (готовый exe)

  1. Скачайте последний релиз: GIIS_ServerSelector.exe
  2. Запустите файл (автоматический запрос прав администратора)
  3. Выберите файл конфигурации stunnel
  4. Выберите нужный сервер
  5. Нажмите "Применить изменения"

Требования

  • Windows 10/11
  • Установленная служба Stunnel
  • Права администратора

🌐 Доступные серверы

IP адрес Описание
195.209.130.9 Промышленный контур
195.209.130.45 Тестовый контур (промышленный)
195.209.130.19 Тестовый контур (новый функционал)

💻 Разработка

Запуск из исходного кода

# Клонировать репозиторий
git clone https://github.com/imdeniil/giis-srv-selector.git
cd giis-srv-selector

# Создать виртуальное окружение
uv venv

# Установить зависимости
uv sync

# Запустить приложение
.venv\Scripts\python.exe giis_srv_selector.py

Сборка exe

# Вариант 1: Использовать готовый скрипт
build.bat

# Вариант 2: Вручную
.venv\Scripts\pyinstaller.exe --onefile --windowed --name "GIIS_ServerSelector" --uac-admin giis_srv_selector.py

Результат: dist\GIIS_ServerSelector.exe

Технологический стек

  • Python 3.13+ - язык программирования
  • tkinter - GUI фреймворк (встроенный)
  • PyInstaller - компиляция в exe
  • uv - менеджер пакетов

📁 Структура проекта

giis-srv-selector/
├── giis_srv_selector.py    # Основной код приложения
├── build.bat                # Скрипт сборки
├── pyproject.toml           # Конфигурация проекта
├── docs/                    # Документация
│   ├── CHANGELOG.md         # История изменений
│   ├── CLASSES.md           # Описание классов
│   ├── FILES.md             # Файловая структура
│   ├── TECH.md              # Технический стек
│   └── TRANSIT.md           # Контекст разработки
└── README.md                # Этот файл

📝 Хранение данных

Приложение сохраняет настройки и логи в системной папке:

%APPDATA%\GIIS_ServerSelector\
├── settings.json                           # Сохраненные настройки
└── stunnel_manager_YYYY-MM-DD_HH-MM-SS.log # Логи операций

🔒 Безопасность

  • ✅ Автоматическое резервное копирование конфига перед изменениями
  • ✅ Восстановление из резервной копии при ошибках
  • ✅ Детальное логирование всех операций
  • ✅ Обязательная проверка прав администратора
  • ✅ Валидация файлов конфигурации

📚 Документация

🐛 Известные ограничения

  • Работает только на Windows
  • Требует установленную службу Stunnel
  • Список серверов жестко задан в коде

🤝 Вклад в проект

Приветствуются любые предложения и улучшения!

  1. Fork репозитория
  2. Создайте ветку для фичи (git checkout -b feature/AmazingFeature)
  3. Commit изменения (git commit -m 'Add some AmazingFeature')
  4. Push в ветку (git push origin feature/AmazingFeature)
  5. Откройте Pull Request

👤 Автор

Даниил

📄 Лицензия

Проект распространяется свободно для внутреннего использования.

⭐ Поддержка проекта

Если проект оказался полезным, поставьте звезду ⭐ на GitHub!


Версия 0.3.0 • Создано с помощью Claude Code

About

GUI утилита для управления stunnel конфигурацией на Windows

Resources

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •