Поиск
Справочник

WP-CLI от пользователя сайта: sudo -u www-data wp

Файлы сайта на сервере принадлежат пользователю, от имени которого работает сайт, — на Ubuntu это www-data. Команды WP-CLI нужно запускать от него же: тогда новые и обновлённые файлы достанутся тому же владельцу и сайт сможет с ними работать. Здесь — как это сделать и что значат ответы, если запустить иначе.

≈ 6 мин чтения
Содержание 9

Что сделать прямо сейчас

  1. Подключитесь к серверу по SSH (как подключиться).
  2. Перейдите в папку сайта: cd /var/www/example.com. Вместо /var/www/example.com — папка вашего сайта.
  3. Узнайте владельца файлов сайта:
    stat -c '%U:%G' wp-config.php
    www-data:www-data

    Слева от двоеточия — владелец, справа — группа.

  4. Запустите команду WP-CLI от имени владельца:
    sudo -u www-data wp plugin list

    Вместо www-data — владелец из шага 3. WP-CLI выведет таблицу плагинов (wp plugin).

Так запускайте все команды WP-CLI для сайта: sudo -u www-data wp ….

Почему именно так

Как запуститьЧто будет
sudo -u www-data wp …файлы, которые создаст WP-CLI, принадлежат www-data — как и остальные файлы сайта
wp … от своего пользователяWP-CLI не сможет записать файлы www-data, а созданные файлы достанутся вам — сайт не сможет их обновлять
wp … от rootWP-CLI откажется: Error: YIKES! It looks like you're running this as root.

Права файлов сайта — права на файлы сайта.

У пользователя www-data нет входа на сервер: его оболочка — nologin, а домашняя папка /var/www принадлежит root. Команде sudo -u www-data wp … это не мешает: она запускает только wp, без входа. Ключ -i не добавляйте: sudo -i -u www-data пробует войти от имени www-data, и вход не получится.

Если файлы сайта принадлежат другому пользователю, например ivan, запускайте sudo -u ivan wp ….

Почему не от root

Error: YIKES! It looks like you're running this as root.

Дальше — несколько строк пояснения, ключ --allow-root и подсказка sudo -u USER -i -- wp <command>. Для www-data эта подсказка не подойдёт: из-за -i команда пробует войти от имени www-data, а входа у него нет. Пишите без -i: sudo -u www-data wp ….

WP-CLI загружает WordPress и все плагины. От root код плагинов работал бы с правами root, а новые файлы принадлежали бы root — и сайт не смог бы их обновлять.

Что делать: запустите ту же команду через sudo -u www-data.

Ключ --allow-root убирает эту проверку. С ним новые файлы WordPress и плагинов будут принадлежать root. Если вы всё же запустили так, верните владельца:

sudo chown -R www-data:www-data /var/www/example.com

Без проверки от root работают только wp cli update и wp cli info — они не загружают WordPress (обновление WP-CLI).

Ключ --path

WP-CLI ищет WordPress в папке, где вы стоите, и выше по дереву папок. Если вы не в папке сайта:

Error: This does not seem to be a WordPress installation.

Строкой ниже — The used path is: и папка, где WP-CLI искал. Перейдите в папку сайта или укажите её ключом --path:

sudo -u www-data wp core version --path=/var/www/example.com
7.1.4

--path работает с любой командой WP-CLI. На сервере с несколькими сайтами так удобно запускать команду для нужного сайта, не переходя в его папку.

Кэш WP-CLI

Команды, которые скачивают файлы, — wp core download, wp core update, wp plugin install, wp theme install — сохраняют копии в папку .wp-cli/cache в домашней папке пользователя. У www-data домашняя папка /var/www, и записать туда он не может:

Warning: Failed to create directory '/var/www/.wp-cli/cache/'

Это предупреждение, а не ошибка: команда работает дальше без кэша. Убрать предупреждение — создайте папку и отдайте её www-data:

sudo mkdir -p /var/www/.wp-cli/cache
sudo chown -R www-data:www-data /var/www/.wp-cli

Ответа нет — папка создана. Папка /var/www/.wp-cli лежит вне папки сайта, и посетители её не видят.

Если WP-CLI спотыкается о плагин или тему

Если команда WP-CLI обрывается с Fatal error и путём к файлу в wp-content/plugins/ или wp-content/themes/, запустите её без плагинов и темы:

sudo -u www-data wp plugin list --skip-plugins --skip-themes

--skip-plugins и --skip-themes работают с любой командой: WordPress загрузится без плагинов и темы. Так можно отключить плагин, из-за которого не работает сайт (wp plugin).

Ошибки и как их исправить

Что видитеПричинаЧто делать
Error: YIKES! It looks like you're running this as root.команда запущена от rootsudo -u www-data wp … (выше)
Error: This does not seem to be a WordPress installation.вы не в папке сайтаcd /var/www/example.com или ключ --path (выше)
Warning: Failed to create directory '/var/www/.wp-cli/cache/'у www-data нет своей папки для кэшакоманда работает без кэша; убрать — выше
sudo -i -u www-data не открывает сессиюу www-data нет входа на серверsudo -u www-data wp … без -i
после wp plugin install сайт не может обновить плагинплагин ставили от своего пользователя или с --allow-rootsudo chown -R www-data:www-data /var/www/example.com (права на файлы)
It seems, the WordPress core files do not have the proper file permissions.WP-CLI не может прочитать файлы WordPressпроверьте владельца и права файлов (права на файлы)

Команды и ответы сверены с документацией и исходным кодом WP-CLI 2.12.0; WordPress в примерах — 7.1.4.

Источники

Сверено 10 ноября 2026 года.

Где попробовать. Команды из статьи безопаснее сначала повторить на отдельном тестовом сервере, а не на рабочем. Подойдёт VPS с Ubuntu, например Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше