Агент сервера 1С:Предприятия 8.3 на Windows и Linux: установка, служба, порты и первый запуск кластера
Содержание
Агент сервера 1С ставится из полного дистрибутива технологической платформы: на Windows это компонент «Сервер 1С:Предприятия» с галкой «Установить 1С:Предприятие как сервис Windows
», на Linux — компонент server пакетного установщика и юнит systemd. После установки служба ragent слушает порт 1540, менеджер кластера — 1541, рабочие процессы — диапазон 1560–1591. Дальше остаётся открыть порты, зарегистрировать консоль и создать базу в кластере.
Типичный сценарий: фирма выросла с 5 до 25 пользователей, файловая база начала тормозить и ловить блокировки. Администратор получает задачу «перевести 1С на сервер» и первым делом должен правильно установить агент сервера. Ошибка на этом шаге всплывает позже — в виде «сервер не обнаружен» у всех клиентов.
Что делает агент сервера и из чего состоит кластер
Агент сервера (процесс ragent) — точка входа в кластер 1С. Клиент сначала обращается к агенту, тот передаёт его менеджеру кластера (rmngr), а менеджер направляет к рабочему процессу (rphost), где и выполняется код конфигурации.
| Процесс | Что делает | Порт по умолчанию |
|---|---|---|
ragent | Агент: принимает подключения, хранит список кластеров, через него работает консоль | 1540 |
rmngr | Менеджер кластера: реестр баз, сеансы, блокировки, лицензии | 1541 |
rphost | Рабочий процесс: исполняет запросы пользователей | 1560–1591 |
ras | Сервер администрирования для утилиты rac и сторонних консолей | 1545 |
Диапазон портов рабочих процессов задаётся в свойствах рабочего сервера, а не агента. Там же лежат параметры отказоустойчивости и требования назначения функциональности.
Без агента нет ни консоли администрирования, ни клиент-серверного режима. Если служба остановлена, пользователи не войдут в базу, даже если сам компьютер работает.
Требования к серверу перед установкой агента 1С
Точные системные требования для каждой версии платформы публикует фирма 1С. Ниже — практические ориентиры для небольшой и средней базы.
- 🖥️ ОС: Windows Server 2016 и новее (x86-64) или актуальный 64-битный Linux: Debian, Ubuntu, РЕД ОС, Astra Linux, Альт.
- 🧠 Память: от 8 ГБ для базы на 10–20 пользователей. Каждый
rphostпод нагрузкой легко занимает 1–2 ГБ. - 💾 Диск: SSD. Каталог кластера (
srvinfo) с журналами регистрации растёт на гигабайты. - 🗄️ СУБД: MS SQL Server или PostgreSQL в сборке для 1С, можно на отдельной машине. Файловые базы сервер 1С не обслуживает.
- 🔑 Лицензия: ключ или программная лицензия на сервер 1С:Предприятия. Установить агент можно и без неё, но клиентские сеансы на сервере без лицензии не стартуют.
- 🌐 Сеть: постоянный IP или стабильное имя в DNS. Клиенты обращаются к серверу по имени, которое записано в настройках кластера.
Версия платформы на сервере и у клиентов должна совпадать до последней цифры сборки, например 8.3.24.1548 и там, и там. Иначе клиент не подключится. Проще выбрать одну сборку и раскатать её на все рабочие места.
Подготовка системы: имя, учётная запись, брандмауэр
Три вещи стоит сделать до запуска установщика. Потом их переделывать дороже.
Имя сервера
Задайте окончательное имя компьютера до установки. Имя хранится в реестре кластера (1CV8Clst.lst), и после переименования машины агент продолжает искать старое имя. Клиенты в этом случае получают ошибку подключения.
Проверьте, что имя разрешается и с сервера, и с клиентов:
hostname
ping srv1c
nslookup srv1c
Если DNS в сети нет, пропишите имя и IP в файле hosts на каждом клиенте (C:\Windows\System32\drivers\etc\hosts) и на самом сервере.
Учётная запись службы
Установщик Windows по умолчанию создаёт локального пользователя USR1CV8 и запускает службу от него. Это нормальный вариант. Если базы и выгрузки лежат на сетевом ресурсе, берут доменную учётную запись.
Учётной записи нужны:
- Право «Вход в качестве службы» (в локальной политике безопасности).
- Полный доступ к каталогу кластера, обычно
C:\Program Files\1cv8\srvinfo. - Членство в группе «Пользователи журналов производительности» — без неё агент не читает счётчики нагрузки.
Брандмауэр
Откройте входящие TCP-порты 1540, 1541 и 1560–1591. Если будете ставить ras — ещё 1545. Для Windows одной командой из PowerShell от администратора:
New-NetFirewallRule -DisplayName "1C Server" -Direction Inbound -Protocol TCP -LocalPort 1540,1541,1545,1560-1591 -Action Allow
Установка агента сервера 1С на Windows по шагам
Нужен полный дистрибутив платформы для Windows x86-64 — архив, внутри которого setup.exe. Тонкий клиент и «клиентский» дистрибутив серверных компонентов не содержат.
Шаги мастера установки
- Распакуйте архив и запустите
setup.exeот имени администратора. - В списке компонентов включите «Сервер 1С:Предприятия». Если на машине будет работать консоль — также «Администрирование сервера 1С:Предприятия».
- Отметьте «Установить 1С:Предприятие как сервис Windows». Без этой галки агент установится файлами, но служба не появится.
- Оставьте пользователя
USR1CV8или укажите свою учётную запись с паролем. - Дождитесь окончания установки. На вопрос про установку драйвера защиты ответьте «да», только если используете аппаратный ключ HASP.
- Откройте
services.mscи найдите службу «Агент сервера 1С:Предприятия 8.3 (x86-64)». Тип запуска — «Автоматически», состояние — «Выполняется».
Проверьте, что порты действительно слушаются:
netstat -ano | findstr ":1540 :1541"
Ручная регистрация службы через ragent
Иногда службу нужно зарегистрировать отдельно: галку забыли, поставили вторую версию платформы или переносите каталог кластера на другой диск. Это делает сам ragent.exe из каталога bin нужной версии. Командная строка — от администратора:
cd "C:\Program Files\1cv8\8.3.24.1548\bin"
ragent.exe -instsrvc -usr .\USR1CV8 -pwd "Пароль" -regport 1541 -port 1540 -range 1560:1591 -d "D:\srvinfo" -debug
ragent.exe -start
Ключи: -port — порт агента, -regport — порт менеджера кластера, -range — диапазон рабочих процессов, -d — каталог кластера. Ключ -debug включает отладку на сервере; на рабочем сервере его обычно не ставят.
Удалить службу, зарегистрированную так же, можно командой ragent.exe -rmsrvc. Перед этим остановите её — все сеансы пользователей на сервере оборвутся, поэтому делайте это вне рабочего времени.
Если на одном сервере нужны две версии платформы, у второй службы должны быть другие порты, например -port 2540 -regport 2541 -range 2560:2591, и свой каталог -d. Иначе служба стартует и сразу останавливается.
Как установить агент сервера 1С на Linux
На Linux с версии 8.3.20 платформа поставляется единым установщиком setup-full-<версия>-x86_64.run. Старые deb- и rpm-пакеты по отдельности для новых версий не нужны.
Установка компонентов
Перед установкой поставьте шрифты и библиотеки, без которых не строятся печатные формы. Для Debian и Ubuntu:
sudo apt update
sudo apt install fontconfig libgsf-1-114 ttf-mscorefonts-installer
Затем запустите установщик в тихом режиме:
chmod +x setup-full-8.3.24.1548-x86_64.run
sudo ./setup-full-8.3.24.1548-x86_64.run --mode unattended --enable-components server,ws,server_admin
Компонент server — сам сервер с агентом, ws — модули веб-сервера для публикации, server_admin — сервер администрирования ras. Файлы ложатся в /opt/1cv8/x86_64/8.3.24.1548/, установщик создаёт пользователя usr1cv8.
Запуск службы через systemd
В каталоге версии лежит шаблон юнита. Его подключают, включают автозапуск и стартуют:
sudo systemctl link /opt/1cv8/x86_64/8.3.24.1548/srv1cv8-8.3.24.1548@.service
sudo systemctl enable srv1cv8-8.3.24.1548@default
sudo systemctl start srv1cv8-8.3.24.1548@default
systemctl status srv1cv8-8.3.24.1548@default
Каталог кластера по умолчанию — домашний каталог пользователя usr1cv8, обычно /home/usr1cv8/.1cv8/1C/1cv8.
Для работы утилиты rac запустите ras в режиме демона и проверьте список кластеров:
sudo -u usr1cv8 /opt/1cv8/x86_64/8.3.24.1548/ras cluster --daemon
/opt/1cv8/x86_64/8.3.24.1548/rac cluster list
На Linux главная причина «сервер не найден» — имя хоста. Убедитесь, что hostname возвращает то же имя, что прописано в /etc/hosts с реальным IP, а не с 127.0.1.1.
Первая настройка кластера после установки агента
Агент запущен — теперь кластер нужно увидеть в консоли, закрыть паролем и создать в нём базу.
Регистрация консоли
Консоль администрирования серверов 1С — это оснастка MMC. Она работает через библиотеку radmin.dll, которую нужно зарегистрировать той же версией, что и сервер:
regsvr32 "C:\Program Files\1cv8\8.3.24.1548\bin\radmin.dll"
Если консоль после обновления платформы пишет ошибку версии или не открывается, повторите эту команду для новой версии. Это самая частая причина «сломанной» консоли.
Порядок действий в консоли
- Откройте «Администрирование серверов 1С Предприятия» из меню «Пуск».
- На узле «Central 1C:Enterprise 8.3 servers» вызовите контекстное меню, выберите создание центрального сервера и укажите имя машины и порт 1540.
- Раскройте сервер — появится «Локальный кластер» на порту 1541. Его создаёт установщик.
- Добавьте администратора центрального сервера в узле «Администраторы». Запишите пароль — без него в консоль не попасть.
- В свойствах кластера добавьте администратора кластера.
- В свойствах рабочего сервера проверьте диапазон портов и, при необходимости, ограничьте память рабочих процессов.
- В узле «Информационные базы» создайте базу: имя в кластере, тип СУБД, сервер СУБД, имя базы данных и пользователь СУБД.
После этого клиенты добавляют базу в список со строкой подключения вида Srvr="srv1c";Ref="buh";.
Лицензия на сервер
Программную лицензию активируют из клиента 1С, подключённого к серверной базе, указав, что лицензия получается для сервера. Файл лицензии сохраняется в каталог, доступный пользователю службы. Аппаратный ключ HASP вставляют в сервер или в машину с менеджером лицензий.
Ошибки при установке и запуске агента 1С
Ниже — симптомы, которые администратор видит после установки, и что проверить в каждом случае.
netstat -ano | findstr :1540 и PID в диспетчере задач. Вторая причина — у учётной записи службы нет прав на каталог srvinfo.ping по имени и доступность порта: Test-NetConnection srv1c -Port 1541.Любой перезапуск службы агента рвёт сеансы всех пользователей и фоновые задания. Предупредите людей и делайте это после окончания рабочего дня.
Частые вопросы об установке агента сервера
Можно ли поставить агент сервера на ту же машину, где работает SQL Server или PostgreSQL?
Как обновить версию платформы у работающего агента?
Нужен ли IIS или Apache, чтобы установить агент сервера 1С?
Где хранится список баз и настройки кластера?
reg_1541: файл 1CV8Clst.lst. Его копию полезно класть в резервную копию сервера вместе с базами СУБД.Можно ли запустить агент без службы, вручную?
ragent.exe -agent из каталога bin. Так удобно проверять ошибки запуска, но при выходе из сеанса Windows агент остановится.