Сервис не запускается в Ubuntu: как найти причину и исправить
Сервис в Ubuntu не стартует, когда systemd не может выполнить команду из юнита, перейти в рабочий каталог или открыть стандартный вывод. Сначала смотрят systemctl status имя.service и journalctl -u имя.service -n 50, в выводе ищут код status= и первую строку с ошибкой.
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.
[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: пользователь веб-сервера получит право записи во все файлы. Достаточно выдать права на конкретный файл или каталог, куда сервис действительно пишет.
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, затем перезагрузите конфигурацию.
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.
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.
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 не увидит новый файл.
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 имя.
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.
Ещё по теме
- Ошибка · Сервер Ошибка nginx 404 not found: причины и исправление Почему nginx отдаёт 404 not found: проверка root и index, location, try_files, rewrite, логов и прав. Команды для Ubuntu 24.04 и nginx 1.24.
- Ошибка · Сервер Ошибка SSH: host key verification failed Почему SSH выдаёт host key verification failed, как проверить отпечаток ключа хоста, обновить known_hosts и безопасно переподключиться к серверу.
- Ошибка · Сервер Ubuntu не работает сеть после перезагрузки: причины и исправление Почему на Ubuntu 24.04 после перезагрузки не поднимается сеть: проверка netplan, networkd и DHCP, команды для восстановления интернета на VPS.
- Руководство · Сервер Настройка VPS на Ubuntu 24.04: команды systemctl и проверка Пошаговая настройка VPS на Ubuntu 24.04: пользователь deploy, часовой пояс, swap, обновления. Команды systemctl status, restart, enable и проверка.
- Руководство · Сервер Настройка VPS на Ubuntu Server 24.04 LTS Пошаговая настройка VPS на Ubuntu Server 24.04 LTS: пользователь deploy, SSH-ключ, часовой пояс, swap, обновления и проверка команд. С командами и проверкой.
- Руководство · Сервер Настройка htop на Ubuntu 24.04: пошаговое руководство Как установить и настроить htop на Ubuntu 24.04: команды запуска, горячие клавиши, настройка отображения и проверка, что утилита работает.