К содержимому

Сервис не запускается в Ubuntu: как найти причину и исправить

Сервис в Ubuntu не стартует, когда systemd не может выполнить команду из юнита, перейти в рабочий каталог или открыть стандартный вывод. Сначала смотрят systemctl status имя.service и journalctl -u имя.service -n 50, в выводе ищут код status= и первую строку с ошибкой.

Ошибка Сервер 4 мин чтения

01Ошибка в самом юните: опечатка в ExecStart или WorkingDirectory

systemd запускает ровно ту команду, что записана в ExecStart. Если путь к бинарнику или скрипту неверный, сервис падает с status=203/EXEC. Проверьте путь вручную: ls -l /usr/local/bin/myapp и запустите ту же команду от пользователя из User=. Если в WorkingDirectory указан несуществующий каталог, systemd выдаёт status=200/CHDIR. Создайте каталог или исправьте путь в юните, затем выполните sudo systemctl daemon-reload и sudo systemctl restart имя.service.

ini
[Unit]
Description=My App
After=network.target

[Service]
Type=simple
User=deploy
WorkingDirectory=/var/www/example.com
ExecStart=/usr/bin/php /var/www/example.com/bin/app.php
Restart=on-failure

[Install]
WantedBy=multi-user.target

02Нет прав на файлы или каталог

Код status=203/EXEC появляется и тогда, когда файл существует, но у пользователя из User= нет права на выполнение. Проверьте владельца и права: ls -l /usr/local/bin/myapp. Владельцем должен быть тот же пользователь, что указан в User= юнита, каталоги обычно имеют права 755, файлы 644, а исполняемые файлы 755. Не меняйте владельца всего каталога сайта на www-data: пользователь веб-сервера получит право записи во все файлы. Достаточно выдать права на конкретный файл или каталог, куда сервис действительно пишет.

bash
ls -l /usr/local/bin/myapp
sudo chown deploy:deploy /usr/local/bin/myapp
sudo chmod 755 /usr/local/bin/myapp
sudo systemctl restart имя.service

03Сервис падает сразу после старта: смотрите journalctl

Если systemctl status показывает Active: failed и status=1/FAILURE, сам процесс завершился с ошибкой. Причина видна в журнале: sudo journalctl -u имя.service -n 50 --no-pager. Ищите последнюю строку с текстом ошибки от приложения, а не от systemd. Частая причина: сервис не дождался базы данных или сети. В юните добавьте After=network.target mysql.service и Requires=mysql.service, затем перезагрузите конфигурацию.

bash
sudo systemctl status имя.service
sudo journalctl -u имя.service -n 50 --no-pager
sudo systemctl daemon-reload
sudo systemctl restart имя.service

04Код 209/STDOUT: systemd не может открыть стандартный вывод

status=209/STDOUT означает, что systemd не смог открыть файл или сокет, куда сервис пишет вывод. Это бывает при неверном StandardOutput= или StandardError= в юните, например при указании на несуществующий каталог. Проверьте путь из этих директив и права на каталог. Если перенаправление не нужно, уберите строки StandardOutput= и StandardError= из юнита: по умолчанию вывод попадает в journald.

bash
sudo systemctl cat имя.service | grep -E 'StandardOutput|StandardError'
ls -ld /var/log/myapp
sudo systemctl daemon-reload
sudo systemctl restart имя.service

05Не хватает памяти: процесс убит OOM killer

Сервис стартует и сразу падает, а в systemctl status видно status=9/KILL или signal=KILL. Это работа OOM killer: ядро убило процесс из-за нехватки памяти. Проверьте free -h и журнал ядра: sudo journalctl -k | grep -i "out of memory". На VPS без swap создайте swap-файл. На ext4 подойдёт fallocate, на Btrfs используйте btrfs filesystem mkswapfile. После включения проверьте swapon --show.

bash
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
swapon --show
free -h

06Юнит не включён в автозапуск

Сервис работает после systemctl start, но пропадает после перезагрузки. Проверьте состояние: systemctl is-enabled имя.service. Ответ disabled означает, что автозапуск не включён. Включите его командой sudo systemctl enable имя.service. Если юнит создан вручную в /etc/systemd/system, сначала выполните sudo systemctl daemon-reload, иначе systemd не увидит новый файл.

bash
systemctl is-enabled имя.service
sudo systemctl daemon-reload
sudo systemctl enable имя.service
sudo systemctl start имя.service

07Как убедиться, что сервис запущен

После исправления выполните sudo systemctl restart имя.service и проверьте статус: systemctl is-active имя.service должен вернуть active. Затем посмотрите systemctl status имя.service: в строке Active: не должно быть failed. Перезагрузите сервер и повторите проверку, чтобы убедиться, что автозапуск работает. Если сервис слушает порт, проверьте его через ss -tlnp | grep имя.

bash
sudo systemctl restart имя.service
systemctl is-active имя.service
systemctl status имя.service
sudo reboot
systemctl is-active имя.service

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

  • Сразу менять владельца всего каталога сайта на www-data командой chown -R.

    Пользователь веб-сервера получит право записи во все файлы сайта. Владельцем должен быть пользователь из User= юнита, а права выставляйте точечно: 755 для каталогов и 644 для файлов.

  • Считать status=200/CHDIR ошибкой прав на файлы.

    Код 200/CHDIR означает, что systemd не может перейти в каталог из WorkingDirectory. Проверьте, что каталог существует и доступен пользователю из User=.

  • Путать status=209/STDOUT с ошибкой прав на сокет или конфиг.

    209/STDOUT означает ошибку открытия стандартного вывода. Проверьте пути в StandardOutput= и StandardError= или уберите эти директивы.

  • Применять sudo sysctl --system без файла с настройками swap.

    Сначала запишите vm.swappiness=10 и vm.vfs_cache_pressure=50 в /etc/sysctl.d/99-swap.conf, затем выполните sudo sysctl --system.

Deploykin

Как это делается в Deploykin

В Deploykin VPS любого хостинга подключается из панели или через MCP. Уже работающий сервер можно взять под управление: панель просканирует сайты, SSL, cron и демоны и ничего не сломает в конфигах.

7 дней бесплатно на тарифе Про, без привязки карты.

Вопросы и ответы

Как посмотреть, почему сервис не запускается в Ubuntu?

Выполните systemctl status имя.service и sudo journalctl -u имя.service -n 50 --no-pager. В выводе ищите код status= и последнюю строку с ошибкой от самого приложения.

Что означает status=203/EXEC?

systemd не смог выполнить файл из ExecStart: путь неверный, файла нет или у пользователя из User= нет права на выполнение. Проверьте путь и права командой ls -l.

Почему сервис работает после start, но не после перезагрузки?

Юнит не включён в автозапуск. Проверьте systemctl is-enabled имя.service и выполните sudo systemctl enable имя.service.

Сервис падает с signal=KILL, что делать?

Скорее всего, процесс убил OOM killer из-за нехватки памяти. Проверьте free -h и sudo journalctl -k | grep -i "out of memory", при необходимости добавьте swap.

Ещё по теме

Настройка VPS сервера на Ubuntu 24.04: все материалы темы

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.