Добавлена поддержка тестового сертификата через команду --staging. Улучшено логирование процесса получения сертификата и добавлены новые команды для тестирования в документации.

This commit is contained in:
Dmitriy Fofanov
2025-10-30 09:47:23 +03:00
parent 664995334e
commit c5bcd7e8b7
3 changed files with 409 additions and 111 deletions

View File

@@ -119,6 +119,14 @@ letsencrypt-regru --auto
#### 🧪 Команды диагностики и тестирования
```bash
# Получить тестовый сертификат Let's Encrypt (staging)
# - Полностью идентичный процесс с production
# - БЕЗ лимитов на количество запросов (неограниченно!)
# - Идеально для тестирования автоматизации и DNS
# - Браузеры не доверяют (staging CA)
# - НЕ загружается в Nginx Proxy Manager
letsencrypt-regru --staging
# Проверить доступ к API reg.ru
# - Тестирует подключение к API
# - Показывает текущий IP адрес
@@ -138,6 +146,7 @@ letsencrypt-regru --help
# Включить подробный вывод (verbose mode)
letsencrypt-regru --obtain -v
letsencrypt-regru --check -v
letsencrypt-regru --staging -v
```
#### ⚙️ Служебные команды (внутреннее использование)
@@ -1686,6 +1695,53 @@ letsencrypt-regru --auto
---
### Команда `--staging`
**Назначение**: Получает тестовый сертификат из staging окружения Let's Encrypt.
**Что делает:**
1. Запускает полный процесс получения сертификата Let's Encrypt
2. Использует staging CA (Certificate Authority) вместо production
3. Создает TXT запись через API reg.ru (как и в production)
4. Ожидает распространения DNS (60 секунд)
5. Let's Encrypt staging проверяет DNS запись
6. Получает сертификат от staging CA
7. НЕ загружает сертификат в Nginx Proxy Manager
**Пример использования:**
```bash
letsencrypt-regru --staging
letsencrypt-regru --staging -v # с подробным выводом
```
**Преимущества:**
- ✅ **НЕТ ЛИМИТОВ** - неограниченное количество запросов (в отличие от production)
- ✅ **Полная идентичность** - процесс на 100% идентичен production
- ✅ **Реальный DNS** - тестирует весь процесс DNS-валидации
- ✅ **Безопасное тестирование** - не расходует лимиты production (5/неделя)
- ✅ **Быстрая отладка** - можно запускать сколько угодно раз
**⚠️ Ограничения:**
- Браузеры не доверяют staging CA (покажут предупреждение)
- Сертификат нельзя использовать на production сайтах
- Подходит только для тестирования автоматизации
**Когда использовать:**
- ✅ Первая настройка системы
- ✅ Тестирование DNS интеграции
- ✅ Отладка автоматизации
- ✅ Проверка работы hooks
- ✅ Разработка и staging окружения
**Переход на production:**
После успешного тестирования просто запустите:
```bash
sudo letsencrypt-regru --obtain
```
Staging сертификат будет заменен на production.
---
### Команда `--test-cert`
**Назначение**: Создает тестовый самоподписанный сертификат.
@@ -1703,14 +1759,28 @@ letsencrypt-regru --test-cert
**Преимущества:**
- ✅ Не требует интернет соединения
- ✅ Мгновенное создание
- ✅ Нет лимитов Let's Encrypt (5 сертификатов/неделя)
- ✅ Идеально для разработки и тестирования
- ✅ Мгновенное создание (1-2 секунды)
- ✅ Не требует API reg.ru
- ✅ Не требует DNS
- ✅ Идеально для локальной разработки
**⚠️ Внимание:**
- Браузеры покажут предупреждение "сертификат не доверенный"
- Не тестирует DNS и автоматизацию
- Не использовать в production!
**Сравнение: --staging vs --test-cert**
| Параметр | --staging | --test-cert |
|----------|-----------|-------------|
| Интернет | ✅ Требуется | ❌ Не требуется |
| API reg.ru | ✅ Требуется | ❌ Не требуется |
| DNS проверка | ✅ Полная | ❌ Нет |
| Лимиты | ✅ Нет | ✅ Нет |
| Время создания | ~2-3 минуты | ~1-2 секунды |
| Тестирует автоматизацию | ✅ Да | ❌ Нет |
| Использование | Тест перед production | Локальная разработка |
---
### Команда `--test-api`