Управление Nextcloud из командной строки

 

 

 

Полное руководство по использованию occ: Управление Nextcloud из командной строки

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

Что такое occ?

occ (сокращение от OwnCloud Console) представляет собой интерфейс командной строки для полного управления экземпляром Nextcloud. Этот инструмент позволяет администрировать пользователей, группы, приложения, системные настройки и выполнять техническое обслуживание с высокой эффективностью. Особенно ценна возможность интеграции occ в скрипты автоматизации, что существенно упрощает управление инфраструктурой.

В этом руководстве мы рассмотрим ключевые команды occ, которые помогут оптимизировать процессы администрирования вашего Nextcloud.

Основы работы с occ

Поскольку occ реализован как PHP-скрипт, для его выполнения требуется интерпретатор PHP. Скрипт расположен в корневом каталоге установки Nextcloud.

Базовый синтаксис вызова

sudo -u www-data php occ [команда] [аргументы] [--опции]

Ключевые элементы синтаксиса:

• sudo -u www-data: Запуск от имени пользователя веб-сервера (в Ubuntu/Debian обычно www-data, в CentOS/RHEL — apache). Этот параметр критически важен для корректной работы с правами доступа к файловой системе и базе данных.
• php: Явный вызов интерпретатора PHP.
• occ: Целевой скрипт.
• [команда] [аргументы] [--опции]: Конкретная команда управления с соответствующими параметрами.

Проверка доступности и версии

Первоначально убедитесь в корректной установке occ и определите версию вашего Nextcloud:

sudo -u www-data php occ status

Пример результата выполнения:

  - installed: true
  - version: 32.0.2.2
  - versionstring: 32.0.2
  - edition:

Классификация команд occ по функциональности

1. Системное администрирование и обслуживание

Эти команды обеспечивают стабильность работы и производительность вашего сервера.

maintenance:mode — Управление режимом обслуживания

Активация этого режима временно отключает веб-интерфейс для обычных пользователей (администраторы сохраняют доступ). Используется при установке обновлений, приложений или выполнении резервного копирования.

Активация режима:

sudo -u www-data php occ maintenance:mode --on

Деактивация режима:

sudo -u www-data php occ maintenance:mode --off

Проверка текущего статуса:

sudo -u www-data php occ maintenance:mode

maintenance:repair — Диагностика и восстановление

Утилита для исправления различных неполадок в базе данных и файловом хранилище.

Базовая проверка и восстановление:

sudo -u www-data php occ maintenance:repair

Расширенное восстановление с исправлением общих ресурсов (shares):

sudo -u www-data php occ maintenance:repair --include-expensive

Полное восстановление всех компонентов:

sudo -u www-data php occ maintenance:repair --include-expensive --all-apps

2. Управление пользователями и группами

Автоматизация работы с учетными записями — одна из наиболее сильных сторон occ.

user:add — Создание новых пользователей

Простое создание пользователя:

sudo -u www-data php occ user:add petrov

Создание с указанием отображаемого имени и групп:

sudo -u www-data php occ user:add ivanov --display-name="Иван Иванов" --group="users" --group="managers"

user:resetpassword — Смена пароля

Интерактивная смена пароля для указанного пользователя:

sudo -u www-data php occ user:resetpassword ivanov

user:list — Просмотр списка пользователей

Вывод всех пользователей:

sudo -u www-data php occ user:list

Фильтрация по группе:

sudo -u www-data php occ user:list --group="managers"

Поиск пользователей вне определенной группы:

sudo -u www-data php occ user:list --groups --less "users"

user:info — Детальная информация о пользователе

sudo -u www-data php occ user:info ivanov

group:add — Создание групп

sudo -u www-data php occ group:add new_interns

group:list — Просмотр списка групп

sudo -u www-data php occ group:list

3. Управление приложениями

Консольное управление приложениями обеспечивает высокую скорость работы и идеально подходит для автоматизированных сценариев развертывания.

app:list — Отображение списка приложений

Все установленные приложения:

sudo -u www-data php occ app:list

Только активные приложения:

sudo -u www-data php occ app:list --enabled

Только отключенные приложения:

sudo -u www-data php occ app:list --disabled

app:enable — Активация приложения

sudo -u www-data php occ app:enable contacts

app:disable — Деактивация приложения

sudo -u www-data php occ app:disable contacts

app:install — Установка из App Store

sudo -u www-data php occ app:install notes

app:update — Обновление приложений

Обновление конкретного приложения:

sudo -u www-data php occ app:update contacts

Массовое обновление всех компонентов:

sudo -u www-data php occ app:update --all

Проверка доступных обновлений без установки:

sudo -u www-data php occ app:update --showonly

app:remove — Полное удаление приложения

sudo -u www-data php occ app:remove notes

4. Дополнительные полезные команды

config:system:set — Прямое изменение системных настроек

Включение отладочного режима:

sudo -u www-data php occ config:system:set debug --value=true --type=boolean

Добавление доверенного домена:

sudo -u www-data php occ config:system:set trusted_domains 1 --value=cloud.mydomain.com

Установка региона для номеров телефонов:

sudo -u www-data php occ config:system:set default_phone_region --value="RU"

security:bruteforce:reset — Сброс блокировок

Снятие ограничений с IP-адреса после неудачных попыток входа:

sudo -u www-data php occ security:bruteforce:reset 192.168.1.1

files:scan — Переиндексация файлового хранилища

Необходима при прямом добавлении или изменении файлов в обход веб-интерфейса Nextcloud (например, через SSH).

Полная переиндексация:

sudo -u www-data php occ files:scan --all

Сканирование файлов конкретного пользователя:

sudo -u www-data php occ files:scan ivanov

Рекомендации и лучшие практики

1. Соблюдение прав доступа — Всегда используйте sudo -u www-data (или соответствующего пользователя веб-сервера) для предотвращения проблем с разрешениями.
2. Резервное копирование — Перед выполнением операций, потенциально влияющих на целостность данных (особенно maintenance:repair, удаление пользователей или приложений), создавайте резервные копии базы данных и директории data.
3. Встроенная справка — Для получения детальной информации по любой команде и ее параметрам используйте флаг --help:

   sudo -u www-data php occ user:add --help

4. Автоматизация — Интегрируйте часто используемые команды occ в скрипты (bash, Python и др.) для автоматизации рутинных задач администрирования.
5. Логирование — Регулярно проверяйте логи Nextcloud (nextcloud.log в директории данных) после выполнения консольных команд для мониторинга возможных ошибок или нештатных ситуаций.

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

 

 

 

 

 

---

---