Команды сервера

Команды сервера — справочник CLI-команд утилиты rude, через которую системный администратор управляет сервером RuDesktop из консоли. Команды сгруппированы по областям применения: учётные записи, серверные операции, работа с файлами и данными, API-токены, синхронизация с LDAP, UEM-задачи, аналитика Apache Superset, обслуживающие команды и расширенные Django-команды

Подсказка

Все команды выполняются на сервере под пользователем с правами root (sudo rude <команда>). Список доступных команд можно вывести в любой момент через rude --help

Предупреждение

В таблице ниже команды, помеченные как деструктивно, изменяют или удаляют данные без подтверждения — выполняйте их только после резервного копирования

Команды с пометкой dev предназначены для разработки и обслуживания исходного кода RuDesktop. В рабочей инсталляции их запуск, как правило, не требуется и может привести к непредсказуемому поведению

Группы команд

Действия с сервером

Установка, перезапуск, диагностика, сертификаты, лицензия

server_commands/actions_server.html
Действия с учётными записями

Создание суперпользователя, смена пароля, сброс блокировок и MFA

server_commands/actions_accounts.html
Действия с логами

Очистка логов аудита и логов задач

server_commands/actions_logs.html
Действия с адресной книгой

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

server_commands/actions_addressbook.html
Действия с геолокацией

Загрузка городов и определение геолокации устройств по IP

server_commands/actions_geolocation.html
Действия с файлами

Управление файлами сервера

server_commands/actions_files.html
Действия с фактами и отчётами

Генерация отчётов и обновление данных инвентаризации

server_commands/actions_facts_report.html
Действия с API

Создание, просмотр и отзыв API-токенов

server_commands/actions_api.html
Действия с LDAP

Взаимодействие с доменом и Keycloak

server_commands/actions_ldap.html
Действия с UEM

Управление задачами, политиками и удалённым выполнением команд

server_commands/actions_uem.html
Действия с модулем аналитики

Управление встроенным Apache Superset

server_commands/actions_superset.html
Дополнительные команды

Расширенные Django-команды и обслуживающие операции

server_commands/actions_add.html

Полный список команд

Команда

Описание

Действия с адресной книгой

addressbook

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

Действия с геолокацией

load_cities

Загрузка параметров городов из файла

locate

Определение геолокации по IP-адресу

update_peers_geo

Обновление геолокации устройств на основе IP-адресов

Действия с логами

clean_audit_logs

Удаление старых логов аудита

clean_job_logs

Удаление старых логов задач

Действия с сервером

backup

Создание резервной копии базы данных сервера

collectstatic

Сбор статических файлов в одном каталоге

constance

Получение и установка параметров конфигурации сервера

delete

Очистка устройств по дате последней активности на сервере

diag

Сбор информации для диагностики сервера

gencert

Генерация сертификата для моста

install

Первичная установка сервера и его служб

license

Получение информации о лицензии

maintain

Регламентное обслуживание сервера: ротация логов и удаление устаревших архивов

migrate_postgresql

Миграция БД на другую версию PostgreSQL

ping

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

prof

Отображение запросов к базе данных

reconnect

Получение сертификата и мастер-пароля с устройства

reinstall

Переустановка сервера со сбросом конфигурации и сертификатов CA (деструктивно)

relay

Получение информации о версии сервера

restart

Перезапуск сервера

restore

Восстановление базы данных сервера из резервной копии (деструктивно)

setup_server

Установка сервера в качестве рандеву для подключения удалённого доступа

start

Запуск сервера

status

Получение информации о статусах служб сервера

stop

Остановка сервера

Действия с учётными записями

axes_list_attempts

Формирование списка ошибочных попыток авторизации

axes_reset_failure_logs

Сброс журнала неуспешных попыток доступа

axes_reset_ip_username

Сброс попыток доступа и блокировок для пары IP-адрес/имя пользователя

axes_reset_ip

Сброс блокировки IP-адреса

axes_reset_logs

Сброс неуспешных попыток входа для всех IP

axes_reset_username

Сброс блокировки пользователя

axes_reset

Сброс всех блокировок

bad_auth_list

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

changepassword

Смена пароля пользователя

clean_otp

Удаление устаревших одноразовых паролей

createsuperuser

Создание пользователя с полными правами

disable_mfa

Отключение методов 2FA для конкретного пользователя

normalize_phones

Приведение номеров телефонов к стандартному виду

passwd

Смена пароля пользователя admin

Действия с файлами

file

Управление файлами

Действия с фактами и отчётами

report generate

Генерация отчётов

update_inventory

Обновление полей для раздела «Инвентаризация»

Действия с API

token create

Создание токена

token list

Получение списка созданных токенов

token revoke

Отзыв токена

Действия с LDAP

keycloak

Взаимодействие с Keycloak

ldap

Взаимодействие с доменом

Действия с UEM

job

Управление задачами

policy

Управление политиками

remote

Выполнение команд с сервера на удалённых устройствах

Действия с модулем аналитики

superset backup

Создание резервной копии базы данных модуля аналитики

superset drop

Пересоздание базы данных модуля аналитики (деструктивно)

superset init

Инициализация базы данных модуля аналитики

superset install

Установка и инициализация службы модуля аналитики

superset restart

Перезапуск модуля аналитики

superset restore

Восстановление базы данных модуля аналитики из резервной копии (деструктивно)

superset start

Запуск модуля аналитики

superset status

Получение информации о статусах служб модуля аналитики

superset stop

Остановка модуля аналитики

Дополнительные команды (Django и обслуживающие)

analyze

Анализ списков на наличие IP-адресов из файла или лога

check

Проверка проекта Django на наличие потенциальных проблем

clearsessions

Очистка сессий с истекшим сроком действия

cleartokens

Очистка просроченных токенов

client

Установка клиента RuDesktop по SSH

compilemessages

Компиляция po-файлов в mo-файлы для встроенной поддержки gettext (dev)

createapplication

Создание нового OAuth-приложения программным способом

createcachetable

Создание таблиц для использования кэша SQL

dbshell

Запуск клиента командной строки для базы данных (dev)

diffsettings

Отображение различий между текущим settings.py и настройками Django по умолчанию (dev)

drf_create_token

Создание токена DRF для заданного пользователя

dumpdata

Вывод содержимого базы данных в виде фикстуры заданного формата (dev)

event

Постановка события в очередь задач

executor

Фоновый процесс-воркер — постоянно выполняет задачи из очереди

export

Экспорт сетевого графа

findstatic

Поиск абсолютных путей к статическим файлам (dev)

fix_groups

Исправление символов в путях CN/DN для аккаунтов из LDAP-каталога

flush

Удаление всех данных из БД (деструктивно

dev)

generateschema

Генерация схемы API для проекта (dev)

genmodels

Создание моделей аудита и перечислений (dev)

inspectdb

Вывод информации о моделях Django по таблицам БД (dev)

loaddata

Установка фикстур в БД (dev)

makemessages

Генерация po-файлов с переводами (dev)

makemigrations

Создание новых миграций для приложений (dev)

migrate

Применение миграций для приложений

oauth_app

Создание нового OAuth-приложения программным способом

optimizemigration

Оптимизация операций для указанной миграции (dev)

playbook

Запуск указанного playbook на исполнение

provise

Генерация конфигурационных файлов для PXE-сервера

remove_stale_contenttypes

Удаление устаревших типов контента из БД

run_job

Запуск задачи по её ID в БД сервера

runserver

Запуск встроенного веб-сервера для разработки (dev)

sendtestemail

Отправка тестового письма на указанные адреса

set_option

Установка значения переменной конфигурации

shell

Вход в терминал Python в окружении сервера (dev)

showmigrations

Отображение всех доступных миграций для текущего проекта

spectacular

Создание схемы API в соответствии со стандартом OpenAPI 3

sqlflush

Получение SQL-запросов для восстановления таблиц БД до начального состояния (dev)

sqlmigrate

Вывод SQL-запросов для указанной миграции (dev)

sqlsequencereset

Вывод SQL-запросов для сброса последовательностей по именам приложений (dev)

squashmigrations

Объединение существующих наборов миграций в одну новую (dev)

startapp

Создание структуры каталогов нового Django-приложения (dev)

startproject

Создание структуры каталогов нового Django-проекта (dev)

test

Обнаружение и запуск тестов в указанных модулях (dev)

testserver

Запуск сервера для разработки с данными из фикстур (dev)