WP-CLI от пользователя сайта: sudo -u www-data wp
Файлы сайта на сервере принадлежат пользователю, от имени которого работает сайт, — на Ubuntu это www-data. Команды WP-CLI нужно запускать от него же: тогда новые и обновлённые файлы достанутся тому же владельцу и сайт сможет с ними работать. Здесь — как это сделать и что значат ответы, если запустить иначе.
Содержание 9
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Перейдите в папку сайта:
cd /var/www/example.com. Вместо/var/www/example.com— папка вашего сайта. - Узнайте владельца файлов сайта:
stat -c '%U:%G' wp-config.phpwww-data:www-dataСлева от двоеточия — владелец, справа — группа.
- Запустите команду 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 … от root | WP-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.com7.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. | команда запущена от root | sudo -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-root | sudo 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.
Источники
- Документация WP-CLI: глобальные ключи — на английском: --path, --skip-plugins, --skip-themes и --allow-root.
- WP-CLI на GitHub — на английском: исходный код проверки запуска от root.
Сверено 10 ноября 2026 года.
Что почитать дальше
- Права на файлы сайтакакие права и владелец нужны файлам WordPress.
- Ошибки WP-CLIчто значат ответы Error и Warning.
- Команды WP-CLIвсе команды на одной странице.