Как запустить агент сервера 1С:Предприятие 8.3

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

Способ запуска зависит от операционной системы и от того, как была установлена платформа. В Windows агент обычно работает как служба, в Linux — как демон, запускаемый скриптом или через systemd. Оба варианта дают одинаковый результат, но отличаются командами, учётными записями и типичными проблемами.

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

Что нужно проверить перед запуском агента

Прежде чем запускать агент, убедитесь, что компонента «Сервер 1С:Предприятия» вообще установлена на компьютере. При установке платформы в Windows её можно было не выбрать — тогда службы агента в системе не будет. Проверить это просто: откройте каталог установки платформы (обычно C:\Program Files\1cv8\<версия>\bin) и найдите файл ragent.exe.

Второе условие — права. Служба агента в Windows по умолчанию работает от имени учётной записи USR1CV8, которая создаётся при установке. Эта учётная запись должна существовать, не быть заблокированной и иметь права на каталог служебных файлов кластера (каталог srvinfo). Если пароль учётной записи меняли вручную, служба не стартует.

Третий момент — свободные порты. Агент по умолчанию использует порт 1540, рабочие процессы — диапазон 1560–1591, а менеджер кластера — 1541. Если эти порты заняты другим приложением или другой версией агента, запуск завершится ошибкой или кластер окажется недоступен.

Запуск агента в Windows через службу

Стандартный способ — оснастка управления службами. Нажмите Win+R, введите services.msc и найдите в списке службу с именем вида «Агент сервера 1С:Предприятия 8.3 (x86-64)». Щёлкните по ней правой кнопкой и выберите «Запустить». Если служба уже работает, будет доступен пункт «Перезапустить».

Тот же результат даёт командная строка, запущенная от имени администратора:

net start "1C:Enterprise 8.3 Server Agent (x86-64)"

Имя службы может отличаться в зависимости от версии платформы и разрядности — точное имя смотрите в свойствах службы в services.msc. Для автоматизации удобно использовать sc start с коротким именем службы или PowerShell-командлет Start-Service.

Если служба не запускается, откройте её свойства и проверьте вкладку «Вход в систему»: там указана учётная запись, от имени которой стартует агент. Ошибка «отказано в доступе» или код 1069 почти всегда означает проблему с паролем или правами этой учётной записи.

Запуск агента в Linux

В Linux агент устанавливается из пакетов платформы и обычно запускается скриптом srv1cv83, расположенным в каталоге /opt/1cv8/x86_64/<версия>/. Запуск выполняется от root или через sudo:

sudo /opt/1cv8/x86_64/8.3.22.1750/srv1cv83 start

В современных дистрибутивах с systemd агент может быть оформлен как unit-файл. Тогда управление выглядит стандартно: systemctl start srv1cv83, а автозапуск при загрузке включается командой systemctl enable srv1cv83. Наличие unit-файла зависит от способа установки — при ручной распаковке пакетов его может не быть.

Агент в Linux работает от имени пользователя usr1cv8. Этот пользователь должен быть владельцем каталога /home/usr1cv8/.1cv8 (или другого каталога, указанного параметром -d при запуске), где хранится реестр кластера. Если права на каталог сбиты, агент стартует и сразу завершится или будет работать с пустым кластером.

1. 1
   Убедитесь, что пакеты сервера 1С установлены и ragent существует в каталоге платформы
2. 2
   Проверьте, что пользователь usr1cv8 существует и владеет каталогом данных кластера
3. 3
   Запустите агент скриптом srv1cv83 start или через systemctl
4. 4
   Проверьте процесс: ps aux | grep ragent
5. 5
   Проверьте порт: ss -tlnp | grep 1540

Ручной запуск ragent из командной строки

Для диагностики агент можно запустить не как службу, а как обычное приложение — тогда все сообщения выводятся в консоль, и причина сбоя видна сразу. В Windows остановите службу и выполните из каталога bin платформы:

ragent.exe -debug

Ключ -debug переводит агент в отладочный режим с подробным выводом. Дополнительно можно указать порт (-port 1540) и каталог кластера (-d "C:\Program Files\1cv8\srvinfo"). Если агент в таком режиме ругается на занятый порт или недоступный каталог — причина проблемы найдена.

В Linux ручной запуск выглядит аналогично: ./ragent -debug из каталога платформы. Запускать вручную следует от того же пользователя, под которым работает демон, иначе агент не получит доступ к файлам кластера или, наоборот, создаст новый реестр с другими правами.

Проверка: агент запущен и кластер доступен

Факт запуска службы ещё не гарантирует работоспособность. Проверка состоит из трёх шагов: процесс, порт, подключение консоли. Сначала убедитесь, что процесс ragent существует: в Windows — через диспетчер задач или tasklist | findstr ragent, в Linux — ps aux | grep ragent.

Затем проверьте, что порт 1540 прослушивается. В Windows: netstat -an | findstr 1540, в Linux: ss -tlnp | grep 1540. Если процесс есть, а порта нет — агент завис на старте или упал; смотрите журнал событий Windows или вывод в консоль при отладочном запуске.

Финальная проверка — подключение консолью администрирования серверов 1С. Откройте консоль, добавьте сервер по имени или IP и разверните ветку кластера: должны отображаться рабочие процессы (rphost) и список информационных баз. Если кластер открывается и базы видны — агент работает штатно.

Типичные ошибки при запуске и их решение

Самая частая проблема в Windows — служба не стартует с ошибкой входа в систему. Причина: изменён или истёк пароль учётной записи USR1CV8 либо учётная запись отключена. Решение: задать учётной записи новый пароль и прописать его в свойствах службы на вкладке «Вход в систему», либо переключить службу на другую учётную запись с достаточными правами.

Вторая по частоте ситуация — занятый порт. Так бывает, когда на сервере установлены две версии платформы и обе службы настроены на порт 1540, либо предыдущий агент завершился некорректно. Узнайте, какой процесс держит порт (netstat -ano и поиск PID в диспетчере задач), завершите его или перенастройте один из агентов на другой порт.

В Linux типичны проблемы с правами: каталог /home/usr1cv8/.1cv8 принадлежит root после ручных экспериментов. Лечится командой chown -R usr1cv8:grp1cv8 /home/usr1cv8/.1cv8. Ещё одна причина молчаливого незапуска — нехватка разделяемой памяти или лимитов на количество открытых файлов; проверяйте вывод при запуске с ключом -debug.

Если агент работает, но клиенты не подключаются

Ситуация «служба запущена, а база не открывается» обычно связана не с агентом, а с сетью или разрешением имён. Проверьте с клиентской машины доступность порта: Test-NetConnection имя_сервера -Port 1540 в PowerShell. Если порт недоступен — откройте в брандмауэре сервера входящие правила для диапазона 1540–1541 и 1560–1591.

Отдельный частый случай — имя сервера не разрешается в IP-адрес или разрешается неправильно (например, в IPv6 или внешний интерфейс). Проверьте ping имя_сервера с клиента: он должен показывать корректный внутренний адрес. При проблемах пропишите соответствие в файле hosts на клиенте или используйте IP-адрес в строке подключения.

Также убедитесь, что версия платформы на клиенте совместима с версией сервера. Клиент 8.3 старой версии может не подключиться к серверу новой версии — в этом случае обновите клиентскую часть или установите соответствующий релиз.

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