python-rac

Клиент администрирования кластеров 1С через RAS. Говорит с сервером администрирования напрямую по TCP на Python: бинарный rac из платформы не нужен. Одна библиотека и четыре интерфейса.

Дистрибутив на PyPI называется python-rac, а в коде импортируется как pyrac (имя pyrac на PyPI принадлежит другому проекту).

Возможности

• Протокол по умолчанию — auto («Автоматически»): согласует максимум версий сервера, читает и пишет (RAS 8.5.1 — версией 16.0, RAS 8.5.4 — 22.0); явная N.0 читает, а пишет, только если N равна максимуму сервера. Версия 10.0 — платформы новее 8.3.15, а не 8.3.11 (таблица «версия → платформа» в docs/protocol.md).
• Чтение кластеров, серверов, процессов, ИБ, сеансов, соединений, блокировок, профилей безопасности, счётчиков, ограничений, правил и настроек сервисов.
• Защищённые изменения: каждое с повторным чтением и сверкой результата.
• Интерфейсы: библиотека asyncio, CLI, веб-консоль, настольная консоль, MCP-сервер.
• Несколько RAS в одной консоли (до 64); серверы, добавленные вручную, сохраняются в файле настроек.
• Автопоиск серверов RAS по диапазонам адресов (IP, CIDR, имена с числовым суффиксом).
• Вход по логину и паролю администратора для любых чтений и изменений; отдельные учётные данные администратора информационной базы (не проверены на живом RAS); пароли хранятся в связке ключей ОС (или в файле настроек).
• Веб-консоль со входом по учётным записям и ролям (web и desktop), образ Docker и exe настольной консоли для Windows.

Установка

Python 3.11+.

python -m pip install python-rac                 # библиотека, CLI, веб-консоль
python -m pip install 'python-rac[desktop]'      # + настольная консоль (PySide6, keyring)
python -m pip install 'python-rac[mcp]'          # + MCP-сервер
python -m pip install 'python-rac[secrets]'      # + keyring: пароли в связке ключей ОС (для web)
python -m pip install 'python-rac[keys]'         # + вход по открытому ключу RAS 8.5.4 (cryptography; входит в desktop и mcp)

Быстрый старт

Библиотека

import asyncio
from pyrac import RacClient

async def main():
    async with RacClient('127.0.0.1', 1545) as rac:
        print(await rac.list_clusters())

asyncio.run(main())

CLI — команды как у rac

pyrac --ras-host=127.0.0.1 cluster list
pyrac --ras-host=127.0.0.1 infobase --cluster=UUID summary list

Веб-консоль (Vue SPA, Node.js не нужен; --ras-host необязателен: адрес по умолчанию localhost:1545 добавляется, только если параметр указан или в настройках нет серверов, а сам адрес вы не удаляли: удалённые адрес по умолчанию и найденные серверы запоминаются как скрытые)

pyrac-web --ras-host=127.0.0.1        # http://127.0.0.1:8080/
pyrac-web --ras-host=127.0.0.1 --read-only    # только чтение

Настольная консоль

pyrac-desktop --ras-host=127.0.0.1

Для Windows есть готовый exe без Python (артефакты CI, docs/desktop.md; exe не подписан).

Docker (веб-консоль с входом по учётным записям; подробности и HTTPS — в docs/docker.md)

mkdir secrets && printf '%s' 'пароль-администратора' > secrets/master_password.txt   # пароль первого администратора admin
cp .env.example .env && docker compose up -d --build     # http://localhost:8080/

MCP-сервер (stdio)

pyrac-mcp --ras-host=127.0.0.1

Безопасность

• Изменение поведения в 0.4.0: веб-консоль и настольная консоль по умолчанию разрешают все совместимые операции изменения (раньше только читали). --read-only отключает изменения; явные --allow-<операция> включают только перечисленные. MCP по умолчанию только читает (82 флага --allow-*).
• Изменения безопасны версией записи, равной максимуму версий сервера: auto (по умолчанию) пишет везде, явная 16.0 — на RAS 8.5.1, 22.0 — на RAS 8.5.4; явная версия ниже максимума сервера только читает (запись версией ниже максимума стёрла бы поля новее); на старых платформах запись проверена только эмуляцией; права на изменения задают роли учётных записей (web и desktop).
• Перед выполнением нужно ввести точную строку подтверждения (например, UUID объекта); успех засчитывается после повторного чтения состояния.
• Пароль администратора RAC идёт по сети открытым текстом (ограничение протокола): подключайтесь через VPN или SSH-туннель. Пароли только записываются: интерфейсы их не возвращают, CLI не принимает их в аргументах.
• Вход всегда по логину и паролю учётной записи (роли Администратор, Оператор, Наблюдатель и пользовательские; области: везде, группа, сервер, строка автопоиска). Для доступа по сети используйте прокси с HTTPS; встроенного TLS нет. Подробности — в docs/security.md.
• Исключение — CLI и библиотека: там нет флагов и подтверждений, команды изменяют RAS сразу. Проверяйте изменения на собственном изолированном стенде, а не на производственном кластере.
• Покрытие команд rac неполное, многие операции проверены только на изолированном RAS 8.5.1 или тестами; ограничения собраны в docs/limitations.md.

Документация

Опубликованная справочная документация с описанием API классов: https://platform42.gitlab.io/python-rac/ (GitLab Pages; собирается из docs-site/, локальная сборка — в docs/development.md).

Разработка

python -m pip install -e '.[desktop,mcp]' pytest
python -m pytest tests/ -q          # для Qt: QT_QPA_PLATFORM=offscreen

Исходники интерфейса веб-консоли — в web-ui/ (см. web-ui/README.md). Выпуск на PyPI выполняется вручную: docs/pypi-release.md.

Лицензия

MIT