Skip to main content

python-rac

python-rac

Управляйте кластером 1С напрямую по протоколу RAS — без rac.exe.
Библиотека на Python, CLI, веб-консоль, настольная консоль и MCP-сервер.

Python 3.11+ · RAS 10.0–22.0 · платформы 8.3.x–8.5.4 · лицензия MIT · PyPI: python-rac

Сайт · Документация · Релизы (exe для Windows) · История изменений · Issues

Веб-консоль: дерево групп серверов, таблица сеансов и свойства выбранного сеанса

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

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

Что где

Интерфейс Команда Для чего
Веб-консоль pyrac-web Дерево кластера в браузере (Vue SPA, Node.js не нужен), вход по учётным записям и ролям, образ Docker
Настольная консоль pyrac-desktop То же в окне (PySide6); для Windows есть готовый exe без Python
CLI pyrac Команды как у rac для скриптов; изменяет кластер сразу, без подтверждений
MCP-сервер pyrac-mcp Инструменты для ИИ-агентов; по умолчанию только чтение, изменения включают флаги --allow-*
Библиотека from pyrac import RacClient Асинхронный клиент asyncio

Возможности

  • Прямой протокол RAS 10.0–22.0 (платформы 8.3.x–8.5.4). По умолчанию auto: версия согласуется с сервером, запись идёт версией, равной максимуму сервера (RAS 8.5.1 — 16.0, RAS 8.5.4 — 22.0). Таблица «версия → платформа» — в docs/protocol.md.
  • Чтение кластеров, серверов, процессов, информационных баз, сеансов, соединений, блокировок, профилей безопасности, счётчиков, ограничений, правил и настроек сервисов; защищённые изменения с повторным чтением и сверкой.
  • Администрирование на месте: правка свойств в таблице, завершение сеансов, перезапуск рабочих процессов, блокировки информационных баз, запуск баз тонким или толстым клиентом и конфигуратором, показания счётчиков производительности.
  • Группы серверов (вложенные: «Продакшен», «Бета», «Dev») и автопоиск по диапазонам для каждой группы; группу можно указать прямо в строке диапазона: area-sp-01 - area-sp-99 - Production.
  • Учётные записи программы и роли (web и desktop): «Администратор», «Оператор», «Наблюдатель» и свои; роль назначается на область — везде, группа, сервер или строка автопоиска.
  • Шифрованное хранилище паролей (secrets.enc, AES-256-GCM); вход по открытому ключу на RAS 8.5.4.
  • Число серверов RAS в одной консоли не ограничено; серверы, добавленные вручную, сохраняются в файле настроек.

Установка

Python 3.11+. Обязательная зависимость одна — cryptography (шифрование хранилища паролей и вход по ключу); остальное — по необходимости.

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: пароли RAS в связке ключей ОС (для web без учётных записей)

Готовый exe настольной консоли для Windows — на странице последнего релиза (zip; exe не подписан, подробности — в docs/desktop.md).

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

Веб-консоль (--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

Библиотека

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

MCP-сервер (stdio): pyrac-mcp --ras-host=127.0.0.1.

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/

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

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

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

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

Документ О чём
docs/index.md Карта документации
docs/getting-started.md Установка и первый запуск
docs/troubleshooting.md Диагностика: журнал pyrac.log, что приложить к отчёту об ошибке
docs/library.md, docs/cli.md Библиотека и командная строка
docs/web.md, docs/desktop.md, docs/mcp.md Веб-консоль, настольная консоль, MCP
docs/operations.md Операции изменения, флаги --allow-* и --read-only
docs/settings.md, docs/discovery.md Файл настроек, группы серверов и автопоиск
docs/security.md, docs/limitations.md Учётные записи и роли, модель безопасности, известные ограничения
docs/docker.md Веб-консоль в контейнере
docs/protocol.md, docs/rac-command-coverage.md Протоколы и покрытие команд
docs/architecture.md, docs/development.md Устройство и разработка
CHANGELOG.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

Metadata

Release files for python-rac 1.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for python-rac 1.3.0
File Size Uploaded Provenance Actions
python_rac-1.3.0.tar.gz 1.1 MB Without provenance Details for python_rac-1.3.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for python-rac 1.3.0
File Interpreter ABI Platform Actions
python_rac-1.3.0-py3-none-any.whl Python 3 none any Details for python_rac-1.3.0-py3-none-any.whl

Total release size: 2.0 MB

Release files / python_rac-1.3.0.tar.gz

Download URL python_rac-1.3.0.tar.gz
Size 1.1 MB
Tags Source
SHA-256 checksum
How to use checksums
562bc92bbff314bbee4bff5fd3ab4568b11c3dba1cd91bfa8d61d6232470dfdf
BLAKE2b-256 checksum
How to use checksums
7516dfc32b9c538b1d287681713a32ec473321b7614872fcbdf48c1f1cc260be
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.17

Release files / python_rac-1.3.0-py3-none-any.whl

Download URL python_rac-1.3.0-py3-none-any.whl
Size 873.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
d454854d65db6edf1a08035db4d274ad43e73c539b59da2a84047b2e745adcf9
BLAKE2b-256 checksum
How to use checksums
0d82bce3f7c7b29b9e7d40fa7ad5ba960e8261a272d8a98b41ce93f7f13aef28
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.17

Security for python-rac 1.3.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.3.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page