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

Built distribution (wheel)

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

Total release size: 2.3 MB

Release files / python_rac-1.5.0.tar.gz

Download URL python_rac-1.5.0.tar.gz
Size 1.3 MB
Tags Source
SHA-256 checksum
How to use checksums
0425058528befab4b199cffbc855be3c9eea0aade2002442ef4ed6774ca3e756
BLAKE2b-256 checksum
How to use checksums
7e663c1362caf656879f7168c4a734d7829c762c21d477e8f5eef7cbc510433b
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.0-py3-none-any.whl

Download URL python_rac-1.5.0-py3-none-any.whl
Size 978.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
db96d0937adc0c70b5b750455b212f1e93215b35bb325c3cfc3204fe24d3ce8a
BLAKE2b-256 checksum
How to use checksums
5a0fc3d409233905ded1921f636e5894bf8dc6d16629032902baec880aae0861
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.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.5.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