Служба ragent не стартует или ещё не настроена: запускаем сервер 1С:Предприятия 8.3 в Windows и Linux
Содержание
Агент сервера 1С:Предприятие 8.3 — это процесс ragent.exe, который в Windows работает как служба «Агент сервера 1С:Предприятия 8.3 (x86-64)». Чтобы его запустить, откройте services.msc, найдите эту службу и нажмите «Запустить». В Linux то же самое делает systemctl start для юнита srv1cv8-<версия>@default.
Если служба запускается и сразу останавливается, причина почти всегда в одном из трёх мест: учётная запись службы, занятый порт 1540 или каталог srvinfo, к которому у службы нет доступа. Ниже — пошаговый запуск для обеих ОС, проверка портов и разбор ошибок по логам.
Подготовка: учётная запись, права и каталог srvinfo
Установщик сервера 1С сам создаёт пользователя USR1CV8 и регистрирует службу от его имени. Если сервер ставили «по-быстрому» или переносили, проверьте окружение до первого запуска.
✅ Что должно быть готово:
- Учётная запись службы. Локальный пользователь
USR1CV8или доменная учётка. Пароль у неё не должен истекать: иначе через 42 дня (срок по умолчанию в Windows) служба перестанет стартовать после перезагрузки. - Право «Вход в качестве службы». Проверяется в
secpol.msc → Локальные политики → Назначение прав пользователя. Без него Windows не пустит службу в систему. - Группа «Пользователи журналов производительности». Учётку службы добавляют в эту группу — так требует документация к серверу 1С.
- Полные права на каталог данных. По умолчанию это
C:\Program Files\1cv8\srvinfo. Там лежит реестр кластера, журналы регистрации серверных баз и сеансовые данные. - Лицензия сервера. Сама служба стартует и без неё, но клиенты получат отказ при подключении к базе. Ключ HASP или программную лицензию готовьте заранее.
Если учётка доменная, групповая политика может перезаписать список «Вход в качестве службы». Тогда право пропадает после очередного обновления политик, и служба падает с ошибкой 1069. Добавляйте учётку в политику на уровне домена, а не вручную на сервере.
Проверить, от чьего имени работает служба, можно на вкладке «Вход в систему» в её свойствах.
Как запустить агент сервера 1С в Windows
Способ 1. Через оснастку «Службы»
- Нажмите
Win + R, введитеservices.msc. - Найдите «Агент сервера 1С:Предприятия 8.3 (x86-64)». Для 32-битного сервера в названии не будет
(x86-64). - Откройте свойства и поставьте «Тип запуска: Автоматически».
- Нажмите «Запустить» и дождитесь состояния «Выполняется».
На вкладке «Общие» в поле «Исполняемый файл» видна полная строка запуска. По ней сразу понятно, какая версия платформы и какие порты используются:
"C:\Program Files\1cv8\8.3.24.1342\bin\ragent.exe" -srvc -agent -regport 1541 -port 1540 -range 1560:1591 -d "C:\Program Files\1cv8\srvinfo" -debug
Что означают ключи:
| Ключ | Назначение |
|---|---|
-srvc | ragent работает как служба Windows |
-agent | запуск в режиме агента сервера |
-port 1540 | порт агента, к нему идут клиенты и консоль |
-regport 1541 | порт главного менеджера кластера |
-range 1560:1591 | диапазон портов для рабочих процессов |
-d "…" | каталог данных сервера (srvinfo) |
-debug | разрешает отладку серверного кода |
Способ 2. Из командной строки
Для скриптов и удалённого администрирования удобнее консоль. Запустите cmd от имени администратора:
net start "1C:Enterprise 8.3 Server Agent (x86-64)"
net stop "1C:Enterprise 8.3 Server Agent (x86-64)"
sc query "1C:Enterprise 8.3 Server Agent (x86-64)"
Здесь используется системное имя службы, а не отображаемое. Точное имя посмотрите в свойствах службы, поле «Имя службы». Если на сервере стоят две версии платформы, имён тоже будет два.
Способ 3. Зарегистрировать службу вручную
Службы может не быть вовсе: сервер ставили без галочки «Установить сервер
как службу Windows» или её удалили при переходе на новый релиз. Тогда регистрируют её сами из каталога bin нужной версии:
cd "C:\Program Files\1cv8\8.3.24.1342\bin"
ragent.exe -instsrvc -usr .\USR1CV8 -pwd Пароль -port 1540 -regport 1541 -range 1560:1591 -d "C:\Program Files\1cv8\srvinfo"
ragent.exe -start
Снять службу с регистрации — ragent.exe -rmsrvc, остановить — ragent.exe -stop.
Перед -rmsrvc и -stop предупредите пользователей. Остановка агента обрывает все сеансы на сервере, несохранённые документы пропадут. Делайте это вне рабочего времени.
Способ 4. Запуск как обычное приложение
Для диагностики ragent можно запустить без службы, прямо в консоли: та же строка, но без ключа -srvc. Процесс будет работать, пока открыто окно. Ошибки старта при этом выводятся на экран — удобно, когда служба падает молча.
ragent.exe -agent -port 1540 -regport 1541 -range 1560:1591 -d "C:\Program Files\1cv8\srvinfo"
Не оставляйте сервер в таком режиме в работе: при выходе из сеанса Windows процесс завершится вместе с базами.
Обновление платформы: смена версии службы
После установки нового релиза служба продолжает смотреть в каталог старой версии. Типовой порядок:
- Остановить службу старой версии в нерабочее время.
- Удалить её регистрацию
ragent.exe -rmsrvcиз старогоbin. - Зарегистрировать службу из нового
binс тем же каталогом-dи теми же портами. - Запустить и проверить, что версия в строке запуска новая.
Каталог srvinfo при этом сохраняется: кластер, список баз и настройки остаются на месте.
Запуск агента сервера 1С 8.3 в Linux
В Linux агент — тот же ragent, но работает от пользователя usr1cv8 (группа grp1cv8). В актуальных релизах платформы (8.3.21 и новее) вместе с сервером в каталог версии кладётся готовый юнит systemd.
Пошаговый запуск через systemd
Пример для версии 8.3.24.1342, каталог /opt/1cv8/x86_64/8.3.24.1342:
sudo systemctl link /opt/1cv8/x86_64/8.3.24.1342/srv1cv8-8.3.24.1342@.service
sudo systemctl enable srv1cv8-8.3.24.1342@default
sudo systemctl start srv1cv8-8.3.24.1342@default
sudo systemctl status srv1cv8-8.3.24.1342@default
В выводе status должно быть active (running). Порты и каталог данных заданы в юнит-файле. Менять их лучше через systemctl edit, чтобы при следующем обновлении правки не затёрлись.
Каталог данных по умолчанию — /home/usr1cv8/.1cv8/1C/1cv8. Владельцем должен быть usr1cv8, иначе агент не сможет создать реестр кластера.
Старые релизы
В версиях до 8.3.21 службой управлял скрипт /etc/init.d/srv1cv83, а параметры (порты, каталог, отладка) задавались в /etc/sysconfig/srv1cv83. Запуск — sudo service srv1cv83 start. Если на сервере остался такой скрипт и вы ставите новую платформу, сначала отключите старую службу, чтобы два агента не боролись за порт 1540.
Журнал службы в Linux
Причину падения смотрите в журнале systemd:
journalctl -u srv1cv8-8.3.24.1342@default -n 100 --no-pager
Частые находки: нет прав на каталог данных, нет библиотек (например, после установки на «голую» систему), занят порт.
Порты агента сервера и брандмауэр
Схема подключения клиента: сначала агент на порту 1540, затем менеджер кластера на 1541, затем рабочий процесс из диапазона 1560–1591. Диапазон задаётся в свойствах рабочего сервера в консоли кластера. Если закрыт хотя бы один из этих портов, клиент не подключится, хотя служба «Выполняется».
| Порт | Кто слушает | Нужен для |
|---|---|---|
| 1540 | агент сервера (ragent) | первое подключение клиента и консоли |
| 1541 | менеджер кластера (rmngr) | регистрация баз, распределение сеансов |
| 1560–1591 | рабочие процессы (rphost) | обработка сеансов пользователей |
| 1545 | сервер администрирования (ras) | только если используете rac |
Открыть порты в Windows
netsh advfirewall firewall add rule name="1C Server 8.3" dir=in action=allow protocol=TCP localport=1540-1541,1560-1591
Открыть порты в Linux (ufw)
sudo ufw allow 1540:1541/tcp
sudo ufw allow 1560:1591/tcp
Проверить, что агент слушает порт
- Windows:
netstat -ano | findstr :1540— в последней колонке PID, сверьте его сragent.exeв диспетчере задач. - Linux:
sudo ss -tlnp | grep ragent. - С клиентского ПК:
Test-NetConnection имя_сервера -Port 1540в PowerShell.
Две версии сервера на одной машине — нормальная практика для теста обновлений. Второй агент регистрируют на других портах, например -port 2540 -regport 2541 -range 2560:2591. В строке подключения клиента тогда указывают сервер:2541.
Консоль и rac
Чтобы управлять кластером из «Администрирования серверов 1С Предприятия», в Windows регистрируют radmin.dll нужной версии:
regsvr32 "C:\Program Files\1cv8\8.3.24.1342\bin\radmin.dll"
Если версия radmin.dll не совпадает с версией агента, консоль не подключится к серверу. Это одна из самых частых причин «сервер не отвечает» после обновления.
Альтернатива консоли — утилита rac через сервер администрирования ras:
ras cluster --port=1545 localhost:1540
rac localhost:1545 cluster list
Если cluster list возвращает кластер с портом 1541, агент запущен и отвечает.
Почему агент сервера 1С не запускается: ошибки и логи
Первое место, куда смотреть в Windows, — eventvwr.msc → Журналы Windows → Приложение и «Система». Агент и диспетчер служб пишут туда причину отказа.
Технологический журнал
Когда журналов ОС мало, включают технологический журнал. Файл настройки logcfg.xml кладут в каталог conf установки платформы, например C:\Program Files\1cv8\conf\. Минимальный вариант для поиска ошибок старта:
<?xml version="1.0" encoding="UTF-8"?>
<config xmlns="http://v8.1c.ru/v8/tech-log">
<log location="C:\1C_logs" history="24">
<event>
<eq property="name" value="EXCP"/>
</event>
</log>
</config>
Платформа подхватывает файл без перезапуска. Каталог C:\1C_logs должен быть доступен на запись учётке службы. После диагностики удалите logcfg.xml: журнал растёт быстро и занимает диск.
Сеансовые данные
Если агент стартует, но рабочие процессы падают или зависают на подключении, причиной бывает повреждённый кэш сеансовых данных. Это папки snccntx* внутри srvinfo\reg_1541\.
Порядок очистки:
- Предупредить пользователей и выбрать время без работы в базах.
- Остановить службу агента.
- Удалить только папки
snccntx*. Файл1CV8Clst.lstи папки баз не трогать — в них реестр кластера. - Запустить службу.
Остановка службы обрывает все сеансы на сервере. Удаление 1CV8Clst.lst стирает список баз кластера, после этого их придётся регистрировать заново.
Быстрый и стабильный старт сервера
Агент стартует за несколько секунд. Если запуск тянется минуту и дольше или сервер «тормозит» сразу после старта, проверьте следующее.
- 🛡️ Исключения антивируса. Каталог
srvinfo, каталогbinплатформы и папку технологического журнала исключают из проверки в реальном времени. Иначе антивирус сканирует каждый файл сеансовых данных. - 💾 Каталог данных на быстром диске.
srvinfoс сеансовыми данными лучше держать на SSD. При переносе укажите новый путь в ключе-dи перенесите папку целиком при остановленной службе. - 🐞 Ключ
-debugв рабочей системе. Отладка серверного кода добавляет нагрузку. Если отладкой на этом сервере не пользуются, уберите ключ из строки запуска. - 🔁 Автозапуск после перезагрузки. Тип запуска «Автоматически», а в Linux —
systemctl enable. На вкладке «Восстановление» в свойствах службы Windows можно задать перезапуск при сбое. - 🧹 Размер журналов регистрации. Журналы серверных баз лежат внутри
srvinfo. Многогигабайтный журнал замедляет и старт, и работу. Настройте сокращение журнала в самой базе. - 🕒 Один агент на порт. Старые службы прошлых версий отключите или переведите в ручной запуск, чтобы после перезагрузки порт 1540 не занимал «не тот» ragent.