Автономный сервер 1C: компактная альтернатива кластеру

С версии 8.3.14 в состав технологической платформы 1С введён новый инструмент — автономный сервер, обеспечивающий работу клиентских приложений с информационной базой через протокол HTTP.

Автономный сервер (ibsrv.exe для Windows, ibsrv для Linux) представляет собой отдельное приложение, которое позволяет организовать клиент‑серверный режим работы 1С без развертывания полноценного кластера. Он поддерживает подключение к информационной базе через тонкий клиент, веб‑клиент, мобильное приложение, а начиная с версии 8.3.23 — толстый клиент и конфигуратор.

Автономный сервер преимущественно применяется для разработки и тестирования, однако функционал позволяет использовать его и для постоянной работы в небольших организациях. Его основные качества — упрощённое развертывание, оптимальное использование ресурсов и простое администрирование.

Ключевые особенности автономного сервера

• Не требует установки отдельного веб‑сервера для работы по HTTP — автономный сервер содержит встроенный веб-сервер, и публикация информационной базы выполняется автоматически при его запуске. Не поддерживает протокол HTTPS.

• Может работать с файловыми и с серверными базами данных. Для файловой базы доступна работа до трех одновременных подключений без приобретения серверной лицензии.

• Один экземпляр автономного сервера обслуживает только одну информационную базу. Для работы с несколькими базами можно запускать несколько экземпляров одновременно.

• Не может обслуживать информационную базу обычного приложения.

• До версии 8.3.23 не поддерживает работу с толстым клиентом и в режиме конфигуратора, а также отладку по протоколу TCP/IP.

• Для администрирования использует собственную утилиту (ibcmd.exe для Windows, ibcmd для Linux).

Подробнее про особенности и ограничения версий автономного сервера представлено в официальной документации на ИТС.

Исходя из перечисленного, автономный сервер 1С может быть полезен в решении следующих задач:

• Создание среды разработки и тестирования HTTP и WEB-сервисов;

• Отладка серверного кода на файловых базах;

• Организация бэкенда для небольших веб-приложений через HTTP API;

• Обеспечение доступа к файловой базе для нескольких пользователей (до трех клиентских сеансов без приобретения серверной лицензии).

Установка и запуск Автономного сервера 1С (Windows)

Системные требования автономного сервера аналогичны системным требованиям кластера серверов 1С:Предприятие. Из этого правила существуют исключения:

• Автономный сервер не работает под управлением 32-разрядных ОС семейства Windows.

• Автономный сервер не работает под управлением 64-разрядных ОС Windows Server 2003 и Windows XP.

Быстрый старт:

1. Скачайте и установите компонент платформы 1С версии 8.3.14+

Автономный сервер устанавливается одновременно с кластером серверов 1С:Предприятия. Для этого при установке технологической платформы 1С необходимо выбрать компонент Сервер 1С:Предприятия 8. Устанавливать сервер 1С:Предприятия 8 как сервис Windows не требуется.

2. Найдите файл ibsrv.exe в каталоге установки (bin)

После установки в каталоге bin появятся файлы:

• ibsrv.exe или просто ibsrv (для Linux) — исполняемый файл автономного сервера.

• ibcmd.exe — утилита командной строки для администрирования автономного сервера.

3. Откройте командную строку и запустите автономный сервер

Автономный сервер можно запускать как обычное приложение или как сервис (Windows), или демон (Linux).

Запуск автономного сервера в режиме обычного приложения выполняется из командной строки.

Параметры сервера можно задать в командной строке или в конфигурационном файле, путь к которому при запуске указывается в параметре --config. Параметры, указанные в командной строке, будут иметь приоритет над настройками в конфигурационном файле.

Если параметры запуска не заданы явно, применяются значения по умолчанию. Чтобы ознакомиться со всеми доступными параметрами, запустите утилиту с ключом --help.

Запуск сервера для файловой базы

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

ibsrv.exe --database-path ="C:\путь_до_каталога_базы" --http-base=/путь_к_веб_ресурсу --http-address=сетевой_интерфейс --http-port=порт --name=имя_информационной_базы

Значение указанных параметров публикации:

--database-path — Путь к каталогу файловой базы данных 1С:Предприятия 8. По умолчанию используется подкаталог db-data в каталоге данных сервера.

--http-base — Базовый путь к ресурсу, который будет использоваться для доступа к публикации информационной базы. По умолчанию используется значение /.

--http-adress — Сетевой интерфейс, используемый для доступа к публикации. По умолчанию используется localhost. Допустимые значения:

• localhost - локальный сетевой интерфейс;

• any - все доступные сетевые интерфейсы;

• xxx.xxx.xxx.xxx - IPv4 адрес используемого сетевого интерфейса;

• xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx - IPv6 адрес используемого сетевого интерфейса.

--http-port — TCP порт, который будет использоваться для доступа к приложению. По умолчанию используется 8314.

--name — Имя информационной базы.

В случае примера после выполнения команды указанная информационная база станет доступна по адресу http://127.0.0.1:8080/InfoBase для веб-подключения из браузера или тонкого клиента на том же компьютере, где запущен автономный сервер.

Чтобы подключиться к информационной базе толстым клиентом, её нужно добавить в список баз, как расположенную на сервере 1С:Предприятие, указав в адресе кластера значение параметра --http-address, а в имени базы — значение параметра --name.

Запуск сервера для серверной базы

Пример команды запуска автономного сервера для клиент-серверной базы:

Ibsrv.exe --dbms=тип_СУБД --database-server=имя_сервера --database-user=пользователь --database-password =пароль --database-name=имя_базы

Значение указанных параметров публикации:

-- dbms — Тип СУБД, в которой размещается информационная база. Если параметр не указан, используется файловая база данных. Допустимые значения:

• MSSQLServer - Microsoft SQL Server;

• PostgreSQL - PostgreSQL;

• IBMDB2 - IBM DB2;

• OracleDatabase - Oracle Database.

-- database-server — Имя сервера СУБД. Для каждой СУБД есть свой пример указания имени, подробнее в справке параметров автономного сервера (ключ запуска --help).

--database-user — Имя пользователя сервера СУБД.

--database-password — Пароль пользователя сервера СУБД.

 --database-name — Имя базы данных.

Подключение клиентских приложений осуществляется аналогично описанному для варианта файловой базы.

Запуск автономного сервера как службы Windows

Чтобы запустить автономный сервер как сервис, нужно вручную создать службу с использованием системной команды sc.

Простой пример создания сервиса (выполняется от имени администратора):

sc create "имя_службы" binPath= "команда_запуска_автономного_сервера" start= тип_запуска

Значение указанных параметров:

• binPath — Команда запуска автономного сервера с указанными параметрами. Среди них должен быть указан ключ запуска --service - работа в режиме сервиса ОС Windows.

• start — тип запуска для службы. Если параметр не указан, используется demand - ручной запуск. Допустимые значения: boot, system, auto, demand, disabled.

Запуск созданной службы:

start "имя_службы"

Автономный сервер, запущенный как служба, может работать круглосуточно и без входа пользователя в систему. Он может оказаться решением для программ мониторинга и управления ИТ-инфраструктурой организации.

Примеры использования автономного сервера

Автономный сервер даёт возможность быстро развернуть локальную среду для разработки и тестирования клиент‑серверных приложений на файловой базе. Он позволяет проверить работу серверной логики в условиях реального клиент‑серверного взаимодействия — например, отладить обмен данными между клиентом и информационной базой.

Публикация HTTP‑сервисов на автономном сервере

Автономный сервер автоматически публикует HTTP‑сервисы вместе с базой — не требуется ручная регистрация в IIS или Apache. Это делает интеграцию внешних систем и разработку REST‑интерфейсов максимально простой и быстрой.

1) Запустите автономный сервер.

1) Подключитесь к опубликованной информационной базе в режиме конфигуратора и создайте новый HTTP‑сервис. Перезапускать автономный сервер для публикации нового сервиса не потребуется.

2) После обновления конфигурации базы данных, сервис будет доступен для обращения по адресу:

http://<адрес>:<порт>/<имя_базы>/hs/<имя_сервиса>/<метод>

3) Тестируйте работу сервиса через Postman, браузер или утилиту curl.

Запуск автономного сервера с отладкой серверного кода

Автономный сервер позволяет тестировать и отлаживать серверную логику приложения без поднятия полноценного кластера.

1) Запустите автономный сервер с параметрами внешнего сервера отладки:

--debug=протокол_отладки;

--debug-address=IP_адрес_сервера_отладки;

--debug-port=порт_сервера_отладки.

2) Настройте параметры отладки в конфигураторе: в меню «Сервис» — «Параметры» — «Отладка» укажите использование удаленного сервера отладки по выбранному протоколу. В поле «Адрес удаленного сервера отладки» впишите значения параметров отладки --debug-address и через двоеточие --debug-port. В качестве имени информационной базы используется значение параметра --name.

3) Настройте параметры отладки в отлаживаемой базе: в меню «Сервис» — «Параметры» укажите адрес сервера отладки для подключения.

4) Подключитесь к базе и начните отладку: запустите 1С:Предприятие через автономный сервер и в конфигураторе подключите активный сеанс в Предметах отладки.

Автономный сервер 1С является универсальным инструментом, который может быть полезен как разработчикам для тестирования и отладки кода, так и небольшим организациям для поддержания работы сервисов и обеспечения доступа к информационным базам.