Как сбросить пароль администратора Nextcloud с помощью OCC

Если вы больше не можете войти в Nextcloud с учетной записью администратора, occкоманда на стороне сервера может сбросить пароль этой учетной записи без использования веб-интерфейса. occ— это интерфейс командной строки Nextcloud для администрирования. Сброс изменяет пароль учетной записи Nextcloud; он не изменяет ваш логин Linux, пароль базы данных или пароль панели управления хостингом.

В этом пошаговом руководстве используется актуальное руководство администратора Nextcloud 35, доступное по состоянию на 6 октября 2026 года. Базовая команда стабильна во многих версиях, но пути установки, команды PHP, учетные записи служб и рабочие процессы контейнеров могут различаться. Используйте примеры значений только после проверки того, как установлена ​​ваша собственная версия.

Что вам понадобится перед выполнением сброса

• Доступ к командной оболочке сервера или контейнера, в котором запущено PHP-приложение Nextcloud.
• Путь к каталогу установки Nextcloud в файловой системе, то есть к директории, содержащей occфайл.
• Точный идентификатор учетной записи Nextcloud, пароль которой необходимо изменить. Идентификатор учетной записи не может быть admin.
• Учетная запись операционной системы, используемая веб-сервером или средой выполнения PHP. В Debian и Ubuntu это часто www-data; в других системах может использоваться другая учетная запись.
• Новый, уникальный пароль, хранящийся в менеджере паролей.

Запускайте приложения occот имени пользователя HTTP — учетной записи операционной системы, которая запускает веб-приложение, — чтобы обеспечить согласованность прав собственности и разрешений файлов. Это требование описано в руководстве Nextcloud. Не запускайте команды от имени root по умолчанию только потому, что у вас есть доступ к sudo.

Шаг 1: Найдите подходящую установку и учетную запись.

Подключитесь по SSH или откройте командную оболочку, предоставляемую вашей хостинговой средой. Перейдите в каталог установки Nextcloud. Обычно путь установки из исходного кода — /var/www/nextcloud, но пакеты, устройства, контейнеры и размещенные сервисы могут использовать другие пути.

cd /var/www/nextcloud
ls -l occ

Вторая команда должна показать occфайл. Если этого не происходит, остановитесь и найдите фактический каталог приложения, вместо того чтобы пытаться угадать пути. Если у вас другое имя учетной записи, замените adminв последующей команде точный идентификатор пользователя Nextcloud. Идентификатор пользователя не обязательно совпадает с отображаемым именем или адресом электронной почты.

Шаг 2: Запустите интерактивную процедуру сброса пароля.

Для типичной установки Debian или Ubuntu, в которой веб-сервер работает от имени пользователя www-data, выполните следующую команду из каталога Nextcloud:

sudo -E -u www-data php occ user:resetpassword admin

Замените указанный путь, www-dataесли ваш сервер использует другого HTTP-пользователя, на adminподтвержденный вами идентификатор учетной записи. Если вы еще не находитесь в каталоге установки, используйте полный путь:

sudo -E -u www-data php /var/www/nextcloud/occ user:resetpassword admin

Nextcloud запросит новый пароль и попросит вас его подтвердить. Символы пароля обычно не отображаются во время ввода; это ожидаемое поведение. Введите один и тот же пароль в обоих запросах. Сообщение об успешном выполнении подтвердит, что Nextcloud принял сброс пароля.

Шаг 3: Используйте переменную среды только для автоматизации.

Nextcloud также поддерживает --password-from-envоперации, выполняемые с помощью скриптов. Он считывает пароль из OC_PASSпеременной окружения. Избегайте ввода реального пароля непосредственно в командную строку, историю командной оболочки, скрипт, добавленный в систему контроля версий, или в общую стенограмму терминала.

Для одноразовой сессии в командной оболочке вы можете ввести секретный ключ, не выводя его на экран, экспортировать его, выполнить описанную команду, а затем очистить:

read -s OC_PASS
export OC_PASS
sudo -E -u www-data php occ user:resetpassword --password-from-env admin
unset OC_PASS

После этого read -sвведите новый пароль и нажмите Enter; поле ввода останется скрытым. Эта -Eопция запрашивает у sudo сохранение среды, но локальная политика sudo может ограничивать такое поведение. Если команда сообщает, что поле OC_PASSотсутствует или пусто, используйте вместо этого интерактивный сброс или следуйте процедуре управления секретами вашей платформы. Не отключайте средства защиты sudo только для того, чтобы скрипт заработал.

Шаг 4: Убедитесь, что учетная запись может войти в систему.

Откройте обычную ссылку Nextcloud в приватном окне браузера или выйдите из текущей сессии, затем войдите в систему, используя тот же идентификатор учетной записи и новый пароль. Успешный вход в систему подтверждает работоспособность учетных данных через веб-приложение, а не только выполнение команды CLI. Если в вашей организации используется второй фактор аутентификации, выполните также и этот обычный запрос.

Типичные проблемы и способы их решения

• Could not open input file: occили ошибка отсутствия файла: Вероятно, вы находитесь в неправильном каталоге или используете неправильный путь. Найдите установленный occфайл и повторно выполните команду там.
• Ошибки доступа или владения: проверьте учетную запись веб-сервера/PHP для вашего дистрибутива и выполните команду от имени этой учетной записи. Не следует в качестве быстрого решения рекурсивно изменять права собственности; это может привести к более серьезным проблемам с доступом.
• Ошибка «Пользователь не существует» или аналогичная ошибка учетной записи: подтвердите идентификатор учетной записи, включая регистр букв, где это необходимо. Не заменяйте адрес электронной почты, если он не является фактическим идентификатором учетной записи.
• phpОтсутствует или выбрана неправильная версия PHP: используйте исполняемый файл PHP CLI, поддерживаемый вашей установкой Nextcloud и платформой хостинга. На сервере может быть установлено несколько версий PHP, поэтому не следует предполагать, что команда по умолчанию соответствует среде выполнения веб-приложений.
• Сервер работает в Docker, Nextcloud AIO, Snap или в виде виртуального устройства: запустите его occв среде приложения и следуйте официальной процедуре выполнения команд для этого развертывания. Путь к хосту, имя контейнера и пользователь среды выполнения могут отличаться; команда уровня хоста, скопированная из исходной установки, может быть нацелена на неправильную файловую систему.
• Учетная запись управляется через LDAP или Active Directory: эти системы могут быть уполномоченными органами для доступа к учетным данным. Локальный сброс пароля Nextcloud может не обновить пароль, управляемый извне. Следуйте процедуре сброса, предложенной администратором каталога, и проверьте конфигурацию поставщика удостоверений.
• У вас нет доступа к командной строке: попробуйте воспользоваться ссылкой для сброса пароля на странице входа, если в Nextcloud сохранен действующий адрес электронной почты для вашей учетной записи, или попросите другого администратора Nextcloud или вашего хостинг-провайдера сбросить его.

Чего следует избегать после выздоровления

Не редактируйте базу данных Nextcloud напрямую, заменяя хэш пароля. Не меняйте пароль операционной системы, рассчитывая на сброс пароля пользователя Nextcloud. Храните новый пароль в секрете, удалите все временные секреты из среды командной строки и сохраните его в менеджере паролей. Если вы подозреваете, что старые учетные данные были скомпрометированы, проверьте доступ в соответствии со стандартными процедурами безопасности вашей организации.

Официальные ссылки

В документации Nextcloud описаны варианты восстановления и процедура восстановления утерянного пароля администратора в разделе « Сброс утерянного пароля администратора» . Поддерживаемые команды, запросы пароля и параметры переменных среды описаны в разделах «Команды пользователей и групп» и «Использование команды occ» .