Установка скиллов и плагинов OpenClaw осуществляется на ваш страх и риск. Все файлы были получены из открытых источников и предоставляются «как есть». Мы не гарантируем их корректную работу, безопасность или совместимость с вашей системой. Перед установкой настоятельно рекомендуется ознакомиться с содержимым кода и убедиться, что вы понимаете, какие изменения будут внесены в вашу систему.
Linux & service basics: логи, systemd/PM2, права доступа, Nginx reverse proxy и базовые проверки DNS.
Назначение
Этот материал описывает практический подход к диагностике проблем Linux-сервисов. Основной акцент — на анализе логов, работе с systemd/PM2, проверке прав доступа к файлам, корректности конфигурации Nginx и базовой проверке DNS. :
Когда использовать
Подход применяется, когда серверное приложение не запускается, недоступно по сети или работает некорректно. Это может быть ошибка конфигурации, проблемы с зависимостями, правами или сетевым маршрутом. :
Типичные триггеры
- «Покажи, почему сервис падает, используя логи, и предложи команды для исправления»
- «Перезапусти приложение корректно и проверь, что оно слушает нужный порт»
- «Исправь права доступа к директории, чтобы сервис мог читать и писать»
- «Настрой Nginx reverse proxy и проверь DNS и TLS»
- «Создай systemd-сервис и сделай его устойчивым к перезагрузкам»
Входные данные
Для диагностики требуется минимальный набор информации:
- Тип сервиса (systemd unit или процесс PM2)
- Вывод
systemctl statusили аналогичный статус - Свежие логи (
journalctlили файлы логов) - Дополнительно: конфигурация Nginx, домен, порт приложения
Рабочий процесс
- Подтвердить контекст и ограничения
Определить имя сервиса и допустимость изменений. - Собрать доказательства
Получить статус сервиса и последние записи логов. - Классифицировать проблему
Определить тип сбоя: ошибка конфигурации, отсутствующая зависимость, отказ в доступе, конфликт портов, недоступный upstream или ошибка DNS. : - Предложить минимальное исправление
Сформулировать конкретные шаги и способ проверки результата. - Проверить сетевой путь (для веб-сервисов)
Приложение слушает → Nginx проксирует → DNS резолвится → TLS (при необходимости). - Подготовить план перезапуска
Обновление конфигурации, перезапуск/перечитывание и проверка health-check.
Формат результата
Рекомендуемый формат отчёта диагностики:
- Симптом: что именно не работает
- Доказательства: логи и вывод команд
- Наиболее вероятная причина: интерпретация проблемы
- План исправления: минимальные шаги
- Команды: только при явном разрешении
- Проверка: как убедиться, что всё работает
- Откат: как вернуть всё назад при необходимости
Ожидаемый результат
Успешная диагностика означает, что сервис корректно запускается, слушает нужный порт и доступен через ожидаемый сетевой путь (включая reverse proxy и DNS). :
Когда стоит остановиться и уточнить
- Отсутствуют логи или вывод статуса
- Требуются привилегированные действия без подтверждения
- Настройка TLS/сертификатов не ясна
Файл из источника