Как запустить RAS 1C: пошаговая инструкция

RAS (Remote Administration Server) — это сервер администрирования 1С:Предприятия, который позволяет управлять кластером серверов удалённо: через консоль администрирования, утилиту RAC или через OneScript и Java-библиотеки. Без запущенного RAS подключиться к кластеру извне и программно управлять информационными базами, сеансами и блокировками невозможно.

Типовая задача выглядит так: на сервере работает агент сервера 1С (ragent), а администратору нужно из скрипта или с другой машины получить список баз, завершить сеанс или установить блокировку регламентных заданий. Для этого рядом с агентом поднимают RAS, и именно он принимает подключения по сети и транслирует команды кластеру.

Ниже разобран полный цикл: проверка компонентов, установка и регистрация RAS как службы Windows, запуск в консольном режиме для отладки, подключение через консоль администрирования, проверка работоспособности и разбор частых ошибок. Инструкция ориентирована на Windows, но в конце есть замечания по Linux.

Что такое RAS и когда он нужен

RAS входит в состав дистрибутива сервера 1С:Предприятия и представляет собой исполняемый файл ras.exe (в Linux — ras). Он работает как посредник: принимает подключения от клиентских средств администрирования и обращается к агенту кластера (ragent), который должен быть запущен на том же или на другом сервере.

RAS необходим в трёх сценариях. Первый — удалённое администрирование кластера через стандартную консоль «Администрирование серверов 1С:Предприятия» с машины администратора. Второй — автоматизация через утилиту командной строки RAC: скрипты обновления, блокировки баз, отключение сеансов. Третий — интеграция с внешними инструментами: OneScript с библиотекой irac, Java-инструментарий, системы мониторинга.

Важно понимать: RAS сам по себе не управляет базами. Он лишь транслирует команды в кластер. Если агент сервера 1С не запущен или недоступен, RAS запустится, но любые команды через него будут завершаться ошибкой соединения с кластером.

Подготовка: что проверить перед запуском

Перед запуском RAS убедитесь, что на сервере установлен компонент «Сервер 1С:Предприятия» той же версии платформы, с которой работают ваши базы. Файл ras.exe находится в каталоге bin установленной платформы, например: C:\Program Files\1cv8\8.3.22.1750\bin\ras.exe. Если каталога bin с ras.exe нет — компонент сервера не установлен, и сначала нужно запустить установщик платформы в режиме изменения состава.

Проверьте, что служба «Агент сервера 1С:Предприятия» работает: откройте services.msc и найдите службу с именем вида «Агент сервера 1С:Предприятия 8.3». Также убедитесь, что порт 1545 (стандартный порт RAS) не занят другим приложением и открыт в брандмауэре, если подключаться будете с другой машины.

Запуск RAS в консольном режиме для проверки

Самый быстрый способ проверить работоспособность — запустить RAS вручную из командной строки с правами администратора. Это позволяет сразу увидеть ошибки в окне консоли, не разбираясь со службами.

cd "C:\Program Files\1cv8\8.3.22.1750\bin"
ras.exe cluster --port=1545 --daemon localhost:1540

Здесь cluster — режим работы с кластером, --port=1545 — порт, на котором RAS принимает подключения, localhost:1540 — адрес и порт агента кластера (1540 — стандартный порт ragent). Если RAS запущен на том же сервере, что и агент, достаточно указать localhost. Если окно консоли не закрылось с ошибкой и процесс висит в памяти — RAS работает.

Для остановки консольного экземпляра достаточно нажать Ctrl+C или закрыть окно. Консольный режим удобен только для диагностики: для постоянной работы RAS следует зарегистрировать как службу.

Регистрация RAS как службы Windows

Чтобы RAS стартовал автоматически вместе с сервером, зарегистрируйте его как службу через утилиту sc.exe. Команду выполняйте в командной строке с правами администратора. Обратите внимание на пробелы после знаков равенства — это обязательный синтаксис sc.exe.

sc create "1C:RAS 8.3" binPath= "\"C:\Program Files\1cv8\8.3.22.1750\bin\ras.exe\" cluster --daemon --port=1545 localhost:1540" start= auto DisplayName= "1C:Enterprise 8.3 Remote Administration Server"
sc start "1C:RAS 8.3"

Ключ start= auto задаёт автоматический запуск при загрузке системы. После создания службы команда sc start запускает её немедленно. Проверить состояние можно через services.msc или командой sc query "1C:RAS 8.3" — статус должен быть RUNNING.

1. 1
   Убедитесь, что агент сервера 1С запущен и работает
2. 2
   Откройте командную строку от имени администратора
3. 3
   Выполните sc create с путём к ras.exe нужной версии платформы
4. 4
   Запустите службу командой sc start
5. 5
   Проверьте статус RUNNING и доступность порта 1545

Если на сервере установлено несколько версий платформы, указывайте ras.exe той же версии, что и работающий агент кластера. Несовпадение версий RAS и ragent — частая причина ошибок подключения. Для удаления службы используйте sc delete "1C:RAS 8.3" после её остановки.

Подключение к RAS через консоль и RAC

После запуска RAS подключитесь к нему для проверки. В консоли «Администрирование серверов 1С:Предприятия» создайте новый центральный сервер: в поле «Имя» укажите адрес машины с RAS, а в поле «IP-порт» — порт RAS (1545). Если вместо списка информационных баз вы видите пустое дерево или ошибку — проверьте, что RAS и агент доступны и версии совпадают.

Через утилиту RAC проверка выполняется одной командой из каталога bin платформы:

rac.exe cluster list localhost:1545

Команда должна вернуть список кластеров с их идентификаторами. Если в ответ приходит описание кластера — связка RAS + агент работает корректно, и можно переходить к прикладным задачам: получению списка баз, сеансов, установке блокировок.

Запуск RAS в Linux

В Linux логика та же: исполняемый файл ras находится в каталоге /opt/1cv8/x86_64/<версия>/. Запуск в foreground-режиме для проверки выполняется командой ./ras cluster --port=1545 --daemon localhost:1540. Для постоянной работы создают systemd-юнит с аналогичной командой запуска и директивой автоперезапуска.

Учитывайте, что служба RAS должна стартовать после службы агента сервера 1С — в юните это задаётся директивами After= и Wants=. Права: процессу нужен доступ на чтение исполняемых файлов платформы, обычно его запускают от того же пользователя, под которым работает агент (например, usr1cv8).

Типичные ошибки и их решение

Если служба RAS не стартует, первым делом запустите ту же команду в консольном режиме — текст ошибки появится прямо в окне терминала. Часто причиной оказывается опечатка в пути к ras.exe, занятый порт или отсутствие прав у учётной записи службы.

Проверка результата и дальнейшие шаги

Итоговый признак успешной настройки — три работающих проверки: служба RAS в статусе RUNNING, команда rac cluster list localhost:1545 возвращает список кластеров, а консоль администрирования с другой машины показывает информационные базы. После этого RAS можно использовать в скриптах обновления, регламентных задачах мониторинга и интеграциях.

Частые вопросы