python-rac

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

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

Возможности

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

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

Библиотека

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
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) пишут, явный 10.0 на RAS 8.5.1 только читает (запись версией ниже максимума стёрла бы поля новее); на старых платформах запись проверена только эмуляцией; веб-консоль без мастер-пароля изменяет только на loopback.
• Перед выполнением нужно ввести точную строку подтверждения (например, 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