python-rac

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

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

Возможности

• Протокол 16.0 (1С 8.5.1) — основной; узкий набор чтений для 10.0 (1С 8.3.11) и режим auto (только чтение).
• Чтение кластеров, серверов, процессов, ИБ, сеансов, соединений, блокировок, профилей безопасности, счётчиков, ограничений, правил и настроек сервисов.
• Защищённые изменения: каждое с повторным чтением и сверкой результата.
• Интерфейсы: библиотека asyncio, CLI, веб-консоль, настольная консоль, MCP-сервер.
• Несколько RAS в одной консоли (до 64).

Установка

Python 3.11+.

python -m pip install python-rac                 # библиотека, CLI, веб-консоль
python -m pip install 'python-rac[desktop]'      # + настольная консоль (PySide6)
python -m pip install 'python-rac[mcp]'          # + 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 не нужен)

pyrac-web --ras-host=127.0.0.1        # http://127.0.0.1:8080/

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

pyrac-desktop --ras-host=127.0.0.1

MCP-сервер (stdio)

pyrac-mcp --ras-host=127.0.0.1

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

• Веб, desktop и MCP по умолчанию только читают. Каждое изменение включается отдельным флагом --allow-<операция> (36 операций в web и desktop, 82 флага в MCP).
• Изменения возможны только по протоколу 16.0 (auto — только чтение), на любом RAS этого протокола, а в вебе — только на loopback.
• Перед выполнением нужно ввести точную строку подтверждения (например, UUID объекта); успех засчитывается после повторного чтения состояния.
• Пароли не вводятся и не хранятся; для аутентификации используются имена пользователей ОС (--agent-user, --cluster-user).
• Исключение — CLI и библиотека: там нет флагов и подтверждений, команды изменяют RAS сразу. Проверяйте изменения на собственном изолированном стенде, а не на производственном кластере.
• Покрытие команд rac неполное; многие операции проверены только на изолированном RAS 8.5.1, режим 10.0 — только тестами. Границы описаны в rac-command-coverage.md и protocol.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