Зачем нужен автономный сервер

В этой статье собраны примеры работы с ibsrv, которые показывают пользу автономного сервера на реальных задачах. Он работает с файловыми базами и СУБД, публикует базу через встроенный HTTP-сервер и принимает прямые подключения.

ibsrv.exe находится в каталоге bin нужной версии платформы:

"C:\Program Files\1cv8\8.3.27.2074\bin\ibsrv.exe" help

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

ibsrv.exe [параметры базы] [каталоги] [шлюзы] [отладка]

Основные группы параметров

Проверить доступные параметры своей версии можно встроенной справкой:

ibsrv.exe help
ibsrv.exe --version
ibsrv.exe help > "D:\Docs\ibsrv-help.txt"

• Для разных экземпляров используйте отдельные каталоги --data и непересекающиеся сетевые порты.
• --database-path указывает каталог файловой базы, а не сам файл 1Cv8.1CD.
• Если путь базы не указан, сервер ищет её в подкаталоге db-data каталога --data.

Параметры подключения и шлюзов можно хранить в YAML. Это удобно, когда команда разрастается на несколько экранов или один запуск нужно воспроизводить на разных стендах.

Базовый YAML для существующей файловой базы создаёт утилита ibcmd:

ibcmd.exe server config init ^
  --database-path="D:\Bases\Demo" ^
  --name=demo ^
  --http-address=localhost ^
  --http-port=8314 ^
  --http-base=/demo ^
  --out="D:\Standalone\Demo\demo.yml"

Каталог D:\Standalone\Demo должен существовать до создания файла. После этого сервер запускается короткой командой:

ibsrv.exe ^
  --config="D:\Standalone\Demo\demo.yml" ^
  --data="D:\Standalone\Demo"

База будет доступна по адресу http://localhost:8314/demo. Команда server config init формирует настройки, но не создаёт информационную базу.

Служебные пути --data, --temp, --log-data и другие задаются при запуске. Параметры командной строки имеют приоритет над YAML. Путь к файлу каждый раз передаётся через --config.

Запустить существующую базу

Основной и самый прозрачный вариант запуска:

ibsrv.exe ^
  --database-path="D:\Bases\Demo" ^
  --data="D:\Standalone\Demo" ^
  --name=demo

База находится в D:\Bases\Demo\1Cv8.1CD, служебные данные записываются в D:\Standalone\Demo. Имя demo понадобится клиентам при прямом подключении.

Создать файловую базу из CF и сразу запустить

Сначала ibcmd создаёт базу и применяет конфигурацию, затем ibsrv начинает её обслуживать:

ibcmd.exe infobase create ^
  --database-path="D:\Bases\NewDemo" ^
  --data="D:\Standalone\NewDemo" ^
  --load="D:\Configs\Demo.cf" ^
  --apply

ibsrv.exe ^
  --database-path="D:\Bases\NewDemo" ^
  --data="D:\Standalone\NewDemo" ^
  --name=new-demo ^
  --http-base=/new-demo

В D:\Bases\NewDemo до первой команды не должно быть существующей базы. Параметр --apply относится к ibcmd, а имя для клиентов задаётся параметром --name при запуске ibsrv.

У ibsrv есть встроенный HTTP-сервер. Для простой публикации не нужны IIS или Apache. Значения по умолчанию: интерфейс localhost, порт 8314, путь /.

Опубликовать базу только на этом компьютере

При --http-address=localhost база доступна по HTTP только локально. С других компьютеров подключиться к ней не получится.

ibsrv.exe ^
  --database-path="D:\Bases\Demo" ^
  --data="D:\Standalone\Demo" ^
  --name=demo ^
  --enable-http-gate ^
  --http-address=localhost ^
  --http-port=8080 ^
  --http-base=/demo

Веб-клиент будет доступен по адресу http://localhost:8080/demo.

Опубликовать базу в локальной сети

Укажите IP сетевого интерфейса компьютера, на котором работает сервер:

ibsrv.exe ^
  --database-path="D:\Bases\Demo" ^
  --data="D:\Standalone\Demo" ^
  --name=demo ^
  --enable-http-gate ^
  --http-address=192.168.1.150 ^
  --http-port=8080 ^
  --http-base=/demo

Адрес для клиентов: http://192.168.1.150:8080/demo. Входящие подключения к порту 8080 должны быть разрешены в фаерволе.

Слушать все сетевые интерфейсы

ibsrv.exe ^
  --database-path="D:\Bases\Demo" ^
  --data="D:\Standalone\Demo" ^
  --name=demo ^
  --enable-http-gate ^
  --http-address=any ^
  --http-port=8314 ^
  --http-base=/demo

Клиенты используют реальный IP или DNS-имя сервера, например http://srv-1c:8314/demo. Значение any указывается только в настройках и не подставляется в URL.

Несколько публикаций одной базы, OData, веб-сервисы и HTTP-сервисы настраиваются через YAML. Подробная структура файла описана на ИТС.

ibsrv подключается к уже существующей базе 1С в СУБД. Он не регистрирует её в кластере и не создаёт автоматически. Для создания используйте ibcmd infobase create.

Параметры --database-user и --database-password содержат учётные данные СУБД, а не пользователя информационной базы 1С.

Microsoft SQL Server

ibsrv.exe ^
  --dbms=mssqlserver ^
  --database-server=sql-srv ^
  --database-name=demo_sql ^
  --database-user=dbUser ^
  --database-password=ExampleDbPassword ^
  --data="D:\Standalone\DemoSQL" ^
  --name=demo

--database-name задаёт физическое имя базы в SQL Server, а --name задаёт имя для клиентских подключений. Они могут различаться. Microsoft SQL Server поддерживается автономным сервером под Windows.

PostgreSQL с HTTP-публикацией

ibsrv.exe ^
  --dbms=postgresql ^
  --database-server=pg-srv ^
  --database-name=demo_pg ^
  --database-user=dbUser ^
  --database-password=ExampleDbPassword ^
  --data="D:\Standalone\DemoPG" ^
  --name=demo ^
  --enable-http-gate ^
  --http-address=192.168.1.150 ^
  --http-port=8080 ^
  --http-base=/demo

База будет опубликована по адресу http://192.168.1.150:8080/demo.

Параметр --request-database-password заставляет сервер прочитать пароль из стандартного потока ввода, поэтому его не нужно оставлять среди аргументов процесса.

Ввести пароль после запуска

ibsrv.exe ^
  --dbms=mssqlserver ^
  --database-server=sql-srv ^
  --database-name=demo_sql ^
  --database-user=dbUser ^
  --request-database-password ^
  --data="D:\Standalone\DemoSQL" ^
  --name=demo

После запуска введите пароль и нажмите Enter. Отдельное приглашение не выводится: консоль просто ждёт ввод без подсказки.

Прочитать пароль из файла

ibsrv.exe ^
  --dbms=mssqlserver ^
  --database-server=sql-srv ^
  --database-name=demo_sql ^
  --database-user=dbUser ^
  --request-database-password ^
  --data="D:\Standalone\DemoSQL" ^
  --name=demo < "D:\Secrets\sqlpwd.txt"

Автономный сервер использует три основных шлюза:

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

Оставить только HTTP

ibsrv.exe ^
  --database-path="D:\Bases\Demo" ^
  --data="D:\Standalone\Demo" ^
  --name=demo ^
  --enable-http-gate ^
  --disable-direct-gate ^
  --disable-ssh-gate ^
  --http-address=localhost ^
  --http-port=8314 ^
  --http-base=/demo

Тонкий клиент подключается по URL публикации:

1cv8c.exe ENTERPRISE /WS"http://localhost:8314/demo"

По тому же адресу базу можно открыть веб-клиентом в браузере.

Оставить только прямое подключение TCP/IP

ibsrv.exe ^
  --database-path="D:\Bases\Demo" ^
  --data="D:\Standalone\Demo" ^
  --name=demo ^
  --enable-direct-gate ^
  --direct-regport=1541 ^
  --direct-range=1560:1591 ^
  --disable-http-gate ^
  --disable-ssh-gate

Подключение тонкого клиента и Конфигуратора на том же компьютере:

1cv8c.exe ENTERPRISE /S "localhost:1541\demo"
1cv8.exe DESIGNER /S "localhost:1541\demo"

Имя после \ должно совпадать со значением --name. Порт регистрации по умолчанию равен 1541, диапазон дополнительных портов равен 1560:1591. Толстый клиент не поддерживает прямое подключение к автономному серверу по TCP/IP.

Включить SSH-шлюз

Для SSH нужен существующий закрытый ключ хоста:

ibsrv.exe ^
  --database-path="D:\Bases\Demo" ^
  --data="D:\Standalone\Demo" ^
  --name=demo ^
  --enable-ssh-gate ^
  --ssh-address=192.168.1.150 ^
  --ssh-port=8282 ^
  --ssh-host-key="D:\Standalone\Keys\demo-host-key"

ibcmd сможет обратиться к серверу по адресу ssh://192.168.1.150:8282. Значения SSH по умолчанию в версии 8.3.27.2074: адрес 127.0.0.1, порт 1543, ключ %USERPROFILE%\.ssh\id_rsa.

Для каждой базы запускается отдельный процесс. У процессов должны различаться базы, каталоги данных и все занятые сетевые порты.

Бухгалтерская база

ibsrv.exe ^
  --database-path="D:\Bases\Accounting" ^
  --data="D:\Standalone\Accounting" ^
  --name=accounting ^
  --enable-http-gate ^
  --disable-direct-gate ^
  --disable-ssh-gate ^
  --http-address=localhost ^
  --http-port=8314 ^
  --http-base=/accounting ^
  --monitor-port=1555

База розницы

ibsrv.exe ^
  --database-path="D:\Bases\Retail" ^
  --data="D:\Standalone\Retail" ^
  --name=retail ^
  --enable-http-gate ^
  --disable-direct-gate ^
  --disable-ssh-gate ^
  --http-address=localhost ^
  --http-port=8315 ^
  --http-base=/retail ^
  --monitor-port=1556

Адреса публикаций: http://localhost:8314/accounting и http://localhost:8315/retail. Разные процессы ibsrv не позволяют совместно использовать один и тот же порт, поэтому --http-portразличаются.

Включить отладку по TCP/IP

ibsrv.exe ^
  --database-path="D:\Bases\Demo" ^
  --data="D:\Standalone\Demo" ^
  --name=demo ^
  --enable-direct-gate ^
  --debug=tcp

Этот вариант используется вместе с прямым шлюзом.

Включить отладку по HTTP

ibsrv.exe ^
  --database-path="D:\Bases\Demo" ^
  --data="D:\Standalone\Demo" ^
  --name=demo ^
  --enable-http-gate ^
  --http-address=localhost ^
  --http-port=8314 ^
  --debug=http ^
  --debug-address=127.0.0.1 ^
  --debug-port=1550

Сервер использует только один протокол отладки одновременно. Явное значение tcp или http делает запуск понятнее.

Подключить внешний сервер отладки

ibsrv.exe ^
  --database-path="D:\Bases\Demo" ^
  --data="D:\Standalone\Demo" ^
  --name=demo ^
  --debug=server ^
  --debug-server-url="http://localhost:1550"

Внешний сервер отладки настраивается отдельно. В версии 8.3.27.2074 используется параметр --debug-server-url.

Включить расширенные возможности Конфигуратора

ibsrv.exe ^
  --database-path="D:\Bases\Demo" ^
  --data="D:\Standalone\Demo" ^
  --name=demo ^
  --enable-direct-gate ^
  --enable-extended-designer-features

Параметр включает дополнительные возможности Конфигуратора, например запись конфигураций мобильных приложений в файл. Для отключения используйте --disable-extended-designer-features.

По умолчанию служебные данные находятся внутри --data. Их можно разнести по отдельным дискам, чтобы журнал регистрации и временные данные не конкурировали за одно хранилище.

Разнести временные файлы, сеансы и журнал

ibsrv.exe ^
  --database-path="D:\Bases\Demo" ^
  --data="D:\Standalone\Demo" ^
  --name=demo ^
  --temp="E:\1C Temp\Demo" ^
  --users-data="D:\Standalone\Demo\users-data" ^
  --session-data="E:\1C Sessions\Demo" ^
  --log-data="F:\1C Logs\Demo"

--temp задаёт временный каталог информационной базы. Временные файлы процесса ibsrv используют временный каталог пользователя операционной системы, который можно изменить переменной среды TEMP.

Разнести остальные служебные данные

ibsrv.exe ^
  --database-path="D:\Bases\Demo" ^
  --data="D:\Standalone\Demo" ^
  --name=demo ^
  --ftext-data="E:\1C Indexes\Demo\ftext" ^
  --ftext2-data="E:\1C Indexes\Demo\ftext2" ^
  --openid-data="D:\Standalone\Demo\openid-data" ^
  --bin-data-strg="F:\1C Binary\Demo" ^
  --clnt-notif-data="D:\Standalone\Demo\clnt-notif-data"

--ftext-data и --ftext2-data хранят индексы разных версий полнотекстового поиска. В справке 8.3.27.2074 хранилище двоичных данных задаётся параметром --bin-data-strg.

--service переводит процесс в режим службы, но не регистрирует его в Windows. Создание, запуск и удаление службы выполняются системной утилитой sc.exe.

Подготовить командную строку службы

"C:\Program Files\1cv8\8.3.27.2074\bin\ibsrv.exe" --service --database-path="D:\Bases\Demo" --data="D:\Standalone\Demo" --name=demo --enable-http-gate --disable-direct-gate --disable-ssh-gate --http-address=localhost --http-port=8314 --http-base=/demo

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

Зарегистрировать и запустить службу

Команды выполняются в CMD с правами администратора:

sc.exe create "1CStandaloneDemo" binPath= "\"C:\Program Files\1cv8\8.3.27.2074\bin\ibsrv.exe\" --service --database-path=\"D:\Bases\Demo\" --data=\"D:\Standalone\Demo\" --name=demo --enable-http-gate --disable-direct-gate --disable-ssh-gate --http-address=localhost --http-port=8314 --http-base=/demo" start= auto obj= "DOMAIN\svc_1c" password= "ExampleServicePassword" DisplayName= "1C Standalone Demo"
sc.exe start "1CStandaloneDemo"

После binPath=, start=, obj= и других имён параметров sc.exe нужен пробел. Последовательность \" сохраняет кавычки внутри командной строки службы.

Остановить и удалить службу

sc.exe stop "1CStandaloneDemo"
sc.exe delete "1CStandaloneDemo"

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

В Linux исполняемый файл называется ibsrv, без расширения .exe. В примерах предполагается, что каталог с ним добавлен в PATH. Перенос строки в shell выполняется символом \.

Параметры конкретного Linux-релиза проверяйте командой ibsrv help. Например, --daemon отсутствует в справке Windows 8.3.27.2074, хотя описан для Linux на ИТС.

Запустить файловую базу в терминале

ibsrv \
  --database-path="/srv/1c/bases/demo" \
  --data="/srv/1c/standalone/demo" \
  --name=demo \
  --enable-http-gate \
  --http-address=localhost \
  --http-port=8314 \
  --http-base=/demo

Запустить в режиме демона

ibsrv --daemon \
  --database-path="/srv/1c/bases/demo" \
  --data="/srv/1c/standalone/demo" \
  --name=demo \
  --http-address=localhost \
  --http-port=8314 \
  --http-base=/demo

Для создания базы, загрузки CF или DT, работы с расширениями и администрирования запущенного сервера используйте ibcmd. Готовые команды собраны в статье «Примеры приготовления IBCMD».

ibsrv остаётся работать и обслуживает подключения, а ibcmd выполняет одну операцию и завершается.

Примеры приготовления IBSRV · 1С:Предприятие 8.3.27