Ключи 1cv8.exe: как открыть нужную базу, режим и пользователя одной командой

· 9 мин

Содержание

Чтобы запустить 1С:Предприятие с параметрами, вызовите исполняемый файл платформы с ключами в командной строке или в ярлыке: 1cv8.exe ENTERPRISE /F"C:\Bases\Buh" /N"Иванов" /P"123". Первое слово задаёт режим (ENTERPRISE — пользовательский, DESIGNER — Конфигуратор), дальше идут ключи базы, пользователя и дополнительные команды.

Способов передать ключи три. Ярлык на рабочем столе выбирают, когда нужно открыть одну базу без окна выбора. Поле «Дополнительные параметры запуска» в свойствах базы списка — когда ключ должен срабатывать у всех, кто запускает базу через стартер. Bat-файл или планировщик Windows — для ночных выгрузок, обновлений и прочей автоматики. Ключи везде одинаковые, это механизм платформы 8.3, а не конкретной конфигурации: в БП, ЗУП и УТ команды те же.

Какие файлы запускают 1С и как устроена командная строка

В папке платформы, например C:\Program Files\1cv8\8.3.24.1691\bin\, лежат два основных исполняемых файла. Рядом, в C:\Program Files\1cv8\common\, находится стартер.

ФайлЧто запускаетРежимы
1cestart.exeСтартер: окно со списком баз, сам выбирает версию платформыПередаёт ключи дальше
1cv8.exeТолстый клиентENTERPRISE, DESIGNER, CREATEINFOBASE
1cv8c.exeТонкий клиентТолько ENTERPRISE

Общий вид команды:

"<путь к исполняемому файлу>" <РЕЖИМ> <ключи базы> <ключи пользователя> <прочие ключи>

Правила записи простые:

  • 🔹 ключ начинается с косой черты: /F, /N, /DisableStartupMessages;
  • 🔹 значение пишется сразу за ключом или через пробел, а если в нём есть пробелы — в двойных кавычках: /F"D:\Базы 1С\Торговля";
  • 🔹 кавычка внутри значения удваивается: пароль a"b записывается как /P"a""b";
  • 🔹 регистр букв в именах ключей не важен, но для читаемости принято писать как в документации.

Если в пути к 1cv8.exe есть пробелы (Program Files), весь путь берите в кавычки. Без них Windows попытается запустить C:\Program и выдаст ошибку ещё до старта 1С.

Через 1cestart.exe удобно запускать, когда на компьютере стоит несколько версий платформы. Стартер посмотрит, какая версия указана для базы, и запустит нужную. Прямой вызов 1cv8.exe жёстко привязывает ярлык к конкретной сборке: после обновления платформы путь с номером версии придётся поправить.

Ключи подключения к базе и входа пользователя

Сначала платформе нужно указать, какую базу открыть. Для этого используется один из ключей ниже — не несколько сразу.

КлючТип базыПример
/FФайловая/F"C:\Bases\Buh"
/SКлиент-серверная/S"srv1c\buh_prod"
/WSОпубликованная на веб-сервере/WS"http://web01/buh"
/IBNameИмя базы из списка стартера/IBName"Бухгалтерия ООО Ромашка"

Для файловой базы в /F указывается каталог, где лежит 1Cv8.1CD, а не сам файл. Для серверной — имя сервера и имя базы в кластере через обратную косую черту. Если кластер работает не на стандартном порту, порт пишут после имени сервера: /S"srv1c:2541\buh_prod".

Затем — кто входит:

  • 👤 /N"Имя" — имя пользователя ровно так, как оно записано в списке пользователей базы;
  • 🔑 /P"Пароль" — пароль; если пароля нет, ключ можно не писать;
  • 🪟 /WA- — запретить вход через аутентификацию Windows, /WA+ — использовать её принудительно.

Ключ /WA- нужен, когда у пользователя настроены оба способа входа, а вы хотите зайти под другой учётной записью 1С. Без него платформа может молча пустить под доменным пользователем.

Пароль в ярлыке или bat-файле хранится открытым текстом. Любой, кто откроет свойства ярлыка, его увидит. Для ночных заданий заведите в базе отдельного служебного пользователя с минимально нужными правами и не используйте учётную запись администратора.

Пример ярлыка для серверной базы:

"C:\Program Files\1cv8\common\1cestart.exe" ENTERPRISE /S"srv1c\zup" /N"Кадровик" /P"Kd2024" /WA-

Режимы клиента: пользовательский, Конфигуратор, создание базы

Режим — первое слово после имени файла. Если его пропустить, 1cv8.exe покажет окно выбора базы и режима.

  • 🟢 ENTERPRISE — обычная работа пользователя;
  • 🛠 DESIGNER — Конфигуратор;
  • 🆕 CREATEINFOBASE — создание новой базы без открытия окон.

Для режима ENTERPRISE толстого клиента есть два уточняющих ключа:

КлючЧто делаетКогда нужен
/RunModeOrdinaryApplicationЗапускает обычное приложение (старые формы)Конфигурации на обычных формах, старые внешние обработки
/RunModeManagedApplicationЗапускает управляемое приложениеПроверить, как ведёт себя управляемый интерфейс в толстом клиенте

Тонкий клиент 1cv8c.exe обычное приложение не открывает вообще. Если конфигурация написана на обычных формах, её запускают только через 1cv8.exe.

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

"C:\Program Files\1cv8\8.3.24.1691\bin\1cv8.exe" CREATEINFOBASE File="D:\Bases\Test" /AddInList"Тестовая база"

Здесь путь задаётся строкой соединения File="...", а не ключом /F. Ключ /AddInList сразу добавляет новую базу в список стартера под указанным именем. Чтобы создать базу из шаблона или выгрузки, добавьте /UseTemplate"D:\dist\buh.dt" — подходят и .dt, и .cf.

Дополнительные параметры и пакетные команды

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

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

  • 📨 /C"текст" — строка, которую код конфигурации прочитает через свойство глобального контекста ПараметрЗапуска. Типовые конфигурации понимают свои значения, например для завершения работы пользователей перед обновлением.
  • 📂 /Execute"D:\epf\Выгрузка.epf" — сразу после входа открыть внешнюю обработку .
  • 🔗 /URL"e1cib/..." — открыть навигационную ссылку: конкретный документ, список или отчёт.
  • 🔓 /UC"код" — код разрешения, чтобы войти в базу, где установлена блокировка начала сеансов.
  • 🌐 /L"ru" — язык интерфейса, /VL"ru_RU" — локаль для форматов дат и чисел.
  • 🧹 /ClearCache — очистить клиентский кэш перед запуском.
  • 📋 /DisplayAllFunctions — показать пункт «Все функции» в главном меню без включения его в настройках.
  • 🤫 /DisableStartupMessages — не показывать стартовые предупреждения, /DisableStartupDialogs — не показывать стартовые диалоги, например окно выбора базы.

Свойство ПараметрЗапуска удобно и в своих доработках. Пример в модуле приложения:

Процедура ПриНачалеРаботыСистемы()
    Если СтрНайти(ПараметрЗапуска, "ОтчетДня") > 0 Тогда
        // здесь открывается нужная форма или запускается обработка
        Сообщить("Запуск с параметром: " + ПараметрЗапуска);
    КонецЕсли;
КонецПроцедуры

Пакетный режим Конфигуратора

В режиме DESIGNER ключи-команды выполняют операцию и закрывают программу. Так автоматизируют выгрузку, обновление и проверку базы.

КлючДействие
/DumpIB"файл.dt"Выгрузить информационную базу в .dt
/RestoreIB"файл.dt"Загрузить базу из .dt (текущие данные заменяются)
/DumpCfg"файл.cf"Сохранить конфигурацию в .cf
/LoadCfg"файл.cf"Загрузить конфигурацию из .cf
/UpdateCfg"файл.cfu"Обновить конфигурацию, стоящую на поддержке
/UpdateDBCfgОбновить конфигурацию базы данных
/CheckModulesСинтаксический контроль модулей
/IBCheckAndRepairТестирование и исправление базы

Для пакетного режима нужны ещё три ключа: /Out"файл.log" пишет все сообщения в журнал, /DumpResult"файл.txt" сохраняет код результата (0 — успех), /DisableStartupDialogs не даёт процессу зависнуть на окне, которое некому закрыть.

Пример ночной выгрузки файловой базы:

@echo off
set V8="C:\Program Files\1cv8\8.3.24.1691\bin\1cv8.exe"
start "" /wait %V8% DESIGNER /F"D:\Bases\Buh" /N"Backup" /P"Bk_9921" /WA- ^
  /DisableStartupDialogs /DumpIB"E:\Backup\buh_%date:~6,4%%date:~3,2%%date:~0,2%.dt" ^
  /Out"E:\Backup\dump.log" /DumpResult"E:\Backup\result.txt"

start "" /wait заставляет bat-файл дождаться завершения 1С. Без него следующая строка скрипта выполнится сразу, пока выгрузка ещё идёт. Формат %date% зависит от региональных настроек Windows: на русской локали получится ГГГГММДД, на других проверьте и поправьте позиции символов.

Выгрузке в .dt, загрузке .dt, обновлению структуры базы и тестированию нужен монопольный доступ. Если в базе кто-то работает, команда завершится с ошибкой. Запускайте такие задания ночью, а пользователей предупреждайте заранее. Перед /RestoreIB и /IBCheckAndRepair сделайте отдельную копию: первая полностью заменяет данные, вторая может их изменить.

Чтобы выгнать пользователей перед ночным обновлением серверной базы, установите блокировку начала сеансов с кодом разрешения в консоли кластера или в самой конфигурации, а в команду добавьте /UC"тот_же_код". Блокировка обрывает работу всех, кто остался в базе, поэтому время её начала согласуйте с отделом.

Тонкий клиент, веб-клиент и запуск через стартер

У тонкого клиента набор ключей тот же, но есть ограничения. Он подключается к файловой базе, к серверу 1С или к опубликованной на веб-сервере базе через /WS. Конфигуратор и пакетные команды в нём недоступны.

"C:\Program Files\1cv8\8.3.24.1691\bin\1cv8c.exe" ENTERPRISE /WS"https://web01.firma.local/buh" /N"Менеджер" /P"Mn_501"

Веб-клиент запускается в браузере, и параметры передаются в адресе после знака ?. Основные совпадают с ключами командной строки, только без косой черты:

https://web01.firma.local/buh/ru_RU/?N=Менеджер&P=Mn_501&C=ОтчетДня

Здесь N — пользователь, P — пароль, C — параметр запуска. Пароль в адресе попадает в историю браузера и журналы веб-сервера, поэтому для постоянной работы так не делают. Используйте вариант с параметрами в адресе только для тестов и внутренних стендов.

Ключи в свойствах базы из списка

Если ярлыки не нужны, ключ прописывают в самой базе списка стартера. В окне выбора базы выделите базу, нажмите «Изменить» и пролистайте мастер до последней страницы. Там есть поле «Дополнительные параметры запуска». Строка из этого поля добавляется к каждому запуску базы, например /DisplayAllFunctions или /ClearCache.

Список баз хранится в файле %APPDATA%\1C\1CEStart\ibases.v8i. Его можно скопировать на другие компьютеры вместе с уже настроенными параметрами.

Там же, в настройках стартера, есть флажок автоматического выбора версии. Ключ /AppAutoCheckVersion+ включает тот же механизм из командной строки: подходящая сборка платформы подбирается под конкретную базу.

Почему 1С не запускается с параметрами: разбор ошибок

Ошибки запуска делятся на три группы: неверная командная строка, проблемы с пользователем и базой, ограничения окружения. Первым делом добавьте к команде /Out"C:\Temp\1c.log" — текст ошибки попадёт в файл, даже если окно закрылось сразу.

Диагностика: выберите симптом

Отдельный случай — ошибка лицензии при запуске по расписанию. Задание из планировщика Windows часто работает под служебной учётной записью без доступа к той же программной лицензии, что у обычного пользователя. Запустите задание от имени пользователя, у которого 1С открывается вручную, или проверьте доступ этой учётной записи к сервису лицензирования.

Если после смены параметров интерфейс ведёт себя странно (пустые формы, старые панели), разовый запуск с /ClearCache обычно возвращает всё в норму. Клиентский кэш при этом пересоздаётся, а данные базы не затрагиваются.

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

Можно ли запустить сразу две разные базы одним ярлыком?
Нет. Один вызов 1cv8.exe открывает одну базу. Для двух баз сделайте bat-файл с двумя строками start без ключа /wait.
Как узнать, какие параметры уже передаются при запуске базы?
Откройте свойства ярлыка и посмотрите поле «Объект». Для запуска через список проверьте поле «Дополнительные параметры запуска» в мастере изменения базы.
Работают ли ключи командной строки на Linux и macOS?
Да, синтаксис тот же, меняется только путь к исполняемому файлу, например /opt/1cv8/x86_64/<версия>/1cv8. Пути к базам пишутся в формате этой системы.
Можно ли передать пароль так, чтобы его не было видно в ярлыке?
Средствами командной строки — нет. Используйте аутентификацию Windows: пользователь входит без пароля в ярлыке, а платформа сверяет его доменную учётную запись.
Какой код возвращает пакетный режим, если всё прошло успешно?
В файл из ключа /DumpResult записывается 0 при успехе и ненулевое значение при ошибке. Подробности ищите в журнале из ключа /Out.