Перейти к основному содержимому
Версия: 2.0

Настройка SSL-сертификатов для агента Solar TI Feeds

При запуске агента Solar TI Feeds может возникнуть ошибка валидации SSL-сертификата при подключении через корпоративный прокси. В логах появляется сообщение:

tls: failed to verify certificate: x509: certificate signed by unknown authority

Шаг 1. Подготовка сертификатов
Сертификаты должны быть в текстовом формате PEM с расширениями .pem, .crt или .cer.

Шаг 2. Создание директории certs
Создайте директорию certs рядом с рабочей директорией workdir:

mkdir -p ./certs

Шаг 3. Копирование сертификатов
Поместите корневые и промежуточные сертификаты, необходимые для доверия к api.data.rt-solar.ru, в директорию ./certs.

Шаг 4. Проверка монтирования в docker-compose.yml
Убедитесь, что в файле docker-compose.yml присутствует строка монтирования:

volumes:
  - ./pkl/configs/base_pipeline.pkl:/configs/config.pkl:ro
  - ./workdir:/workdir
  - ./certs:/workdir/certs

Если строка ./certs:/workdir/certs отсутствует — добавьте её.

Шаг 5. Настройка прокси (при необходимости)
Настройки прокси для агента и для контейнера задаются отдельно.

5.1. Прокси для агента Solar TI Feeds
Переменная TIC_AGENT_PROXY относится к самому агенту и не зависит от HTTP_PROXY, HTTPS_PROXY, NO_PROXY.

environment:
  - TIC_AGENT_PROXY=socks5://user:password@proxy.domain:port

5.2. Прокси для контейнера
Переменные HTTP_PROXY, HTTPS_PROXY, NO_PROXY — это стандартные переменные окружения контейнера. Они используются HTTP(S)-клиентами внутри контейнера и не заменяют настройку TIC_AGENT_PROXY.

environment:
  - HTTP_PROXY=http://corp.local
  - HTTPS_PROXY=http://corp.local
  - NO_PROXY=localhost,127.0.0.1,.local

Если нужно задать обе группы настроек, укажите их в одном блоке environment, но с комментариями:

environment:
  # Прокси для агента Solar TI Feeds — отдельная настройка агента
  - TIC_AGENT_PROXY=socks5://user:password@proxy.domain:port

  # Прокси для контейнера / стандартных HTTP(S)-клиентов
  - HTTP_PROXY=http://corp.local
  - HTTPS_PROXY=http://corp.local
  - NO_PROXY=localhost,127.0.0.1,.local

Замените значения на свои. Если прокси не используется, соответствующие строки можно не добавлять.

Шаг 6. Перезапуск агента
Выполните команды:

docker compose down
docker compose up -d

Шаг 7. Проверка логов
Проверьте логи контейнера или файл ./workdir/logs/agent.log. Убедитесь, что ошибка x509: certificate signed by unknown authority больше не появляется.

Важно:

Отключение проверки SSL-сертификата не рекомендуется для промышленной эксплуатации. Корректный способ — добавить доверенные сертификаты в директорию certs и подключить её к контейнеру.

Рекомендация:

Если у вас остались вопросы или нужны дополнительные примеры — обратитесь в поддержку: support.tic@rt-solar.ru.