Подключение первого сервера

CLI-агент — небольшая программа, которая устанавливается на ваш сервер и автоматически выполняет тесты скорости по расписанию. Результаты и метрики оборудования отображаются в личном кабинете на графиках.

Агент работает по модели «запрос—ответ»: он сам обращается к сервису, поэтому открывать входящие порты не нужно.

Требования

• Linux: Python 3 (зависимости requests и psutil устанавливаются автоматически), исходящий доступ по HTTPS.
• Windows: Windows 10/11 или Windows Server 2016+; установщик работает без прав администратора.
• Никаких входящих подключений — только исходящий HTTPS.

Шаг 1. Создайте API-ключ

1. Откройте личный кабинет → «Мониторинг серверов».
2. Нажмите «+ Добавить сервер» (или «Создать ключ» в мастере настройки).
3. Система создаст уникальный API-ключ. Скопируйте его.

Каждому серверу — свой ключ. Не используйте один ключ на нескольких серверах: статистика и лимиты считаются по ключу.

Шаг 2. Установка на Linux

Подключитесь к серверу по SSH и выполните:

bashcurl -sLo /tmp/agent.py https://openspeedtest.ru/cli/openspeedtest-agent.py && python3 /tmp/agent.py --register --api-key ВАШ_КЛЮЧ

Затем запустите агент как системную службу (работает после перезагрузки):

bashsudo python3 /tmp/agent.py --daemon

Полезные команды:

bashsudo python3 /tmp/agent.py --status   # состояние службы
sudo python3 /tmp/agent.py --stop     # остановить и удалить службу

Шаг 3. Установка на Windows

1. Скачайте установщик: /downloads/OpenSpeedTestAgent_Setup.exe.
2. Запустите его (права администратора не требуются).
3. Вставьте API-ключ и нажмите «Подключить».
4. Агент добавьте в автозапуск и свернётся в системный трей.

Проверка

В течение 1–2 минут в кабинете появится карточка сервера со статусом «Онлайн». Если данных нет, подождите первый интервал тестирования и проверьте, что сервер видит openspeedtest.ru по HTTPS.

Что умеет агент

• тесты скорости по расписанию (Download, Upload, Ping, Jitter);
• мониторинг оборудования: загрузка CPU, память, диск, время работы;
• уведомления при сбоях;
• автоматическое обновление агента.