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, мобильная версия (PWA)
Настольная консоль 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.5.1

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.5.1
File Size Uploaded Provenance Actions
python_rac-1.5.1.tar.gz 1.3 MB Without provenance Details for python_rac-1.5.1.tar.gz

Built distribution (wheel)

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

Total release size: 2.3 MB

Release files / python_rac-1.5.1.tar.gz

Download URL python_rac-1.5.1.tar.gz
Size 1.3 MB
Tags Source
SHA-256 checksum
How to use checksums
fdb89ab12cbf96868dcda22a7dda774f80a849190f69f47c2156f5ea660959e2
BLAKE2b-256 checksum
How to use checksums
80c5d4fa1ddd8f8dbae0a4de279fe80a8510dd9a81e7524354086b9c39c1ea0a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.18

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

Download URL python_rac-1.5.1-py3-none-any.whl
Size 978.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7d40dd7dab04ef97c1fb89bb232298410c6af4841ed93f3bb2fe71dbe0f43b88
BLAKE2b-256 checksum
How to use checksums
7694c794c7c0cbd8d55bd1ac1713eca74f344fe59bdf6b3e3454f64c71443caa
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.18

Security for python-rac 1.5.1

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.5.1 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