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.
Лицензия
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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.