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.7.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.7.0
File Size Uploaded Provenance Actions
python_rac-1.7.0.tar.gz 1.4 MB Without provenance Details for python_rac-1.7.0.tar.gz

Built distribution (wheel)

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

Total release size: 2.5 MB

Release files / python_rac-1.7.0.tar.gz

Download URL python_rac-1.7.0.tar.gz
Size 1.4 MB
Tags Source
SHA-256 checksum
How to use checksums
ab1ec4a41b1570f59cd63c50469e10ea62132eb9302464bdcaf93f2a8de1d5d7
BLAKE2b-256 checksum
How to use checksums
39246b354df0bf5fe0eebf47565977fc81ee575690c1d4e112ecdfea4e4392ae
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.7.0-py3-none-any.whl

Download URL python_rac-1.7.0-py3-none-any.whl
Size 1.1 MB
Tags Python 3
SHA-256 checksum
How to use checksums
443fe5e5a51652f206ac6b1e71d51d898fe3298908b680d113882ffce1d5f717
BLAKE2b-256 checksum
How to use checksums
217c28b0ed261b70d7963d813cf41fb158ad87d268c169462c9ea33668b61cfa
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.7.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.7.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