Добавлены новые документы и инструкции по настройке, использованию и тестированию SSL сертификатов Let's Encrypt с использованием API reg.ru. Обновлены зависимости в requirements.txt для поддержки новых функций. Включены подробные шаги по автоматизации, созданию и продлению сертификатов, а также интеграции с Nginx Proxy Manager.

2025-10-28 13:01:05 +03:00
parent 70c9932554
commit ed4531fa64
40 changed files with 4027 additions and 15 deletions
--- a/docs/ru/PROJECT_STRUCTURE.md
+++ b/docs/ru/PROJECT_STRUCTURE.md
@@ -0,0 +1,258 @@
+# 📁 Структура проекта configure_nginx_manager
+
+## Основные скрипты
+
+### Python (Рекомендуется)
+- **letsencrypt_regru_api.py** (1,411 строк)
+  - Полнофункциональный Python скрипт
+  - Прямая работа с API reg.ru
+  - Интеграция с Nginx Proxy Manager
+  - Автоматическая проверка и обновление сертификатов
+  - Генерация тестовых самоподписанных сертификатов
+  - Поддержка wildcard доменов
+
+### Bash
+- **letsencrypt_regru_dns.sh**
+  - Bash скрипт с certbot-dns-regru плагином
+  - Простота использования
+  - Минимальные зависимости
+
+### PowerShell
+- **letsencrypt_regru.ps1**
+  - Windows версия
+  - Аналогична Bash скрипту
+
+### Тестирование
+- **test_certificate.sh**
+  - Быстрое создание тестовых сертификатов через OpenSSL
+  - Автономная работа без Python
+  - Поддержка wildcard доменов
+
+## Автоматизация
+
+### Makefile
+- **Makefile** (415 строк)
+  - `make install` - Полная установка и настройка
+  - `make uninstall` - Чистое удаление
+  - `make status` - Проверка состояния
+  - `make test-cert` - Создание тестового сертификата
+  - `make obtain` - Получение Let's Encrypt сертификата
+  - `make renew` - Обновление сертификата
+  - `make logs` - Просмотр логов
+  - `make check-config` - Валидация конфигурации
+
+## Конфигурация
+
+### config.json.example
+Пример конфигурации со всеми параметрами:
+- Учетные данные reg.ru API
+- Настройки домена и email
+- Параметры обновления (renewal_days)
+- Настройки Nginx Proxy Manager
+- Пути к директориям и логам
+
+## Документация
+
+### README.md (1,420+ строк)
+Основная документация:
+- Введение и возможности
+- Быстрый старт
+- Установка через Makefile
+- Создание тестовых сертификатов
+- Требования и установка зависимостей
+- Настройка и использование
+- Интеграция с NPM
+- Автоматическая проверка и обновление
+- Автоматизация через cron/systemd
+- Устранение неполадок
+
+### TESTING_GUIDE.md (370+ строк)
+Руководство по тестированию:
+- Зачем нужны тестовые сертификаты
+- Обход лимитов Let's Encrypt (5 в неделю)
+- Быстрый старт с тестовыми сертификатами
+- Сравнение методов создания
+- Использование в разработке
+- Автоматизация тестирования
+- Переход с тестовых на production
+- Частые вопросы
+- Примеры для CI/CD и Docker
+
+### GITEA_SYNC.md
+Синхронизация Gitea → GitHub:
+- 4 метода синхронизации (Git Hooks, GitHub Actions, Gitea Mirror, Double Remote)
+- Пошаговые инструкции установки
+- Настройка SSH и токенов
+- Webhook интеграция
+- Устранение проблем
+- Сравнение методов
+
+### CHEATSHEET.md
+Быстрая шпаргалка:
+- Основные команды
+- Workflow разработки
+- Сценарии использования
+- Частые ошибки и решения
+- Проверка и отладка
+
+### PROJECT_STRUCTURE.md (этот файл)
+- Описание всех файлов проекта
+- Краткая характеристика каждого компонента
+
+### CHANGELOG.md
+История изменений:
+- Версии и обновления
+- Новые возможности
+- Исправления
+- Roadmap
+
+## Интеграция с Git
+
+### .github/workflows/sync-from-gitea.yml
+GitHub Actions для синхронизации:
+- Автоматическая проверка каждый час
+- Webhook триггер от Gitea
+- Ручной запуск
+- Merge изменений из Gitea
+- Push в GitHub
+
+### gitea-hooks/
+Git hooks для Gitea сервера:
+
+**post-receive**
+- Автоматический push в GitHub после commit
+- Мгновенная синхронизация (< 1 секунды)
+- Логирование операций
+- Синхронизация тегов
+- Поддержка SSH и HTTPS
+
+**README.md**
+- Инструкции по установке hook
+- Настройка аутентификации
+- Устранение проблем
+
+## Вспомогательные файлы
+
+### Markdown документы
+- **Add Let's Encrypt Certificate для провайдера reg.ru.md**
+  - Первоначальные инструкции
+  
+- **Создание и продление SSL сертификата.md**
+  - Дополнительная информация о процессе
+
+## Возможности
+
+### ✅ Основные
+- [x] Создание Let's Encrypt сертификатов через reg.ru DNS API
+- [x] Wildcard сертификаты (*.domain.com)
+- [x] Автоматическое обновление сертификатов
+- [x] DNS-01 валидация
+- [x] Интеграция с Nginx Proxy Manager
+- [x] Автоматическая загрузка/обновление в NPM
+
+### ✅ Продвинутые
+- [x] Автоматическая проверка срока действия
+- [x] Настраиваемый порог обновления (renewal_days)
+- [x] Systemd service + timer
+- [x] Cron автоматизация
+- [x] Подробное логирование
+- [x] Валидация конфигурации
+
+### 🆕 Тестирование
+- [x] Генерация самоподписанных тестовых сертификатов
+- [x] Обход лимитов Let's Encrypt (5/неделю)
+- [x] Мгновенное создание без DNS
+- [x] Интеграция тестовых сертификатов с NPM
+- [x] Полная совместимость структуры с Let's Encrypt
+
+### 🔄 Синхронизация репозиториев
+- [x] Автоматическая синхронизация Gitea → GitHub
+- [x] Git Hooks (мгновенная синхронизация)
+- [x] GitHub Actions (проверка каждый час)
+- [x] Webhook интеграция
+- [x] SSH и HTTPS аутентификация
+
+## Установка
+
+### Быстрая установка
+```bash
+sudo make install
+sudo nano /etc/letsencrypt/regru_config.json
+sudo make test-cert  # Для тестирования
+sudo make obtain     # Для production
+```
+
+### Структура после установки
+```
+/opt/letsencrypt-regru/
+├── letsencrypt_regru_api.py
+
+/etc/letsencrypt/
+├── regru_config.json
+└── live/
+    └── example.com/
+        ├── privkey.pem
+        ├── cert.pem
+        ├── fullchain.pem
+        └── chain.pem
+
+/etc/systemd/system/
+├── letsencrypt-regru.service
+└── letsencrypt-regru.timer
+
+/var/log/letsencrypt/
+└── letsencrypt_regru.log
+```
+
+## Использование
+
+### Тестирование (без лимитов)
+```bash
+sudo make test-cert              # Создать тестовый сертификат
+sudo make status                 # Проверить статус
+```
+
+### Production
+```bash
+sudo make obtain                 # Получить Let's Encrypt сертификат
+sudo make renew                  # Обновить сертификат
+sudo make run                    # Автоматический режим
+```
+
+### Мониторинг
+```bash
+sudo make logs                   # Просмотр логов
+sudo make status                 # Статус служб
+sudo make check-config           # Проверка конфигурации
+```
+
+## Технологии
+
+- **Python 3.6+** - Основной язык
+- **Certbot** - Let's Encrypt клиент
+- **requests** - HTTP запросы к API
+- **cryptography** - Генерация тестовых сертификатов
+- **systemd** - Автоматизация запуска
+- **cron** - Альтернативная автоматизация
+- **Make** - Управление установкой
+- **OpenSSL** - Альтернативная генерация сертификатов
+
+## Лицензия
+
+Open Source - свободное использование
+
+## Автор
+
+Фофанов Дмитрий @ 2025
+
+## Поддержка
+
+См. документацию:
+- [README.md](README.md) - Основное руководство
+- [TESTING_GUIDE.md](TESTING_GUIDE.md) - Руководство по тестированию
+
+---
+
+**Версия**: 2.1  
+**Дата**: 27 октября 2025  
+**Статус**: ✅ Production Ready