Большинство глобальных параметров сервера определяются в XML-файле конфигурации. В Linux этот файл находится по адресу /opt/traccar/conf/. В Windows его местоположение можно указать во время установки, но по умолчанию это C:\Program Files\Traccar\conf. Вы можете редактировать этот файл любым текстовым редактором — просто убедитесь, что он остается допустимым XML-кодом и что специальные символы правильно экранированы.
Некоторые параметры можно настроить в качестве атрибутов для устройств, серверов и других объектов через веб-приложение. Обратитесь к значку рядом с каждым ключом атрибута, чтобы узнать, где можно использовать тот или иной параметр.
В случае логических значений любое неуказанное значение интерпретируется сервером как false.
Вы также можете переопределять значения конфигурации с помощью переменных окружения, которые имеют приоритет над XML-файлом. Чтобы включить эту функцию, установите значение CONFIG_USE_ENVIRONMENT_VARIABLESна true. Чтобы преобразовать ключ конфигурации в ключ переменной окружения, замените точки на подчеркивание, а остальное переведите в регистр "screaming snake case". Например, mail.smtp.fromNameбудет MAIL_SMTP_FROM_NAME.
Список доступных параметров конфигурации:
[protocol].address config
Сетевой интерфейс для протокола. Если не указан, сервер будет привязываться ко всем интерфейсам.
[protocol].port config
Номер порта для протокола. Большинство протоколов используют TCP на транспортном уровне. Некоторые протоколы используют UDP. Некоторые поддерживают как TCP, так и UDP.
[protocol].devices config
Список устройств для протоколов опроса. Список должен содержать уникальные идентификаторы, разделенные запятыми. Используется только для протоколов опроса.
[протокол].интервал config
Интервал опроса в секундах. Используется только для протоколов опроса.
[протокол].ssl config
Включите поддержку SSL для данного протокола. Не все протоколы поддерживают эту функцию.
[протокол].таймаут
config
Значение таймаута соединения в секундах. Поскольку иногда невозможно обнаружить потерю TCP-соединения, старые соединения остаются в открытом состоянии. В большинстве систем существует ограничение на количество открытых соединений, что приводит к проблемам с установлением новых соединений при большом количестве устройств или нестабильности соединений передачи данных между устройствами.
пароль устройства устройство
Пароль устройства. Часто используется в некоторых протоколах для отправки команд.
[протокол].devicePassword config
Пароль устройства. Часто используется в некоторых протоколах для отправки команд.
[протокол].маска config
Маска протокола по умолчанию для использования. В настоящее время используется только протоколом Skypatrol.
[протокол].длина сообщения config
Пользовательская длина сообщения. В настоящее время используется только протоколом H2 для указания длины двоичного сообщения.
[протокол].расширенный config
Включите расширенную функциональность протокола. По умолчанию она отключена, потому что не все устройства её поддерживают.
[протокол].utf8 config
Декодирование строки в UTF8 вместо ASCII. Применимо только для некоторых протоколов.
[протокол].кан config
Включите декодирование CAN для этого протокола. Как и в случае с расширенной конфигурацией, для некоторых устройств это не поддерживается.
[протокол].ack конфигурация устройство
Указывает, требуется ли подтверждение от сервера. Применимо только для некоторых протоколов.
Значение по умолчанию: false
[протокол].ignoreFixTime config
Игнорировать время исправления, сообщаемое устройством. Полезно в случае, если некоторые устройства сообщают неверное время. В настоящее время доступно только для протокола GL200.
[протокол].decodeLow config
Декодирование дополнительных атрибутов TK103. Не поддерживается для некоторых устройств.
[протокол].длинная дата config
Для протокола Atrack используйте длинный формат даты.
[протокол].десятичноеТопливо config
Для протокола Atrack используйте десятичный формат значения расхода топлива.
[протокол].custom config
Указывает на дополнительные пользовательские атрибуты протокола Atrack.
[протокол].форма config
Пользовательская строка формата для протокола Atrack.
[протокол].frameMask config
Маска кадра для протокола Atrack.
[протокол].config config
Настройка протокола. Требуется для некоторых устройств для декодирования входящих данных.
[протокол].alarmMap config
Сопоставление сигналов тревоги для протокола Atrack.
[протокол].префикс config
Указывает, следует ли протоколу TAIP иметь префиксы для сообщений.
[протокол].сервер config
Для некоторых устройств требуется подтверждение адреса сервера. Используйте этот параметр для настройки правильного публичного адреса.
suntech.protocolType конфигурация устройство
Тип протокола для Suntech.
suntech.hbm конфигурация устройство
Значение конфигурации Suntech HBM.
[протокол].включитьAdc конфигурация устройство
Формат включает значение АЦП.
[протокол].включитьRpm конфигурация устройство
Формат включает значение RPM.
[протокол].включитьTemp конфигурация устройство
Формат включает значения температуры.
[протокол].disableCommands
config
Отключить команды для протокола. Не все протоколы поддерживают эту опцию.
[протокол].формат конфигурация устройство
Формат протокола. Используется протоколами, имеющими настраиваемый формат сообщений.
[протокол].формат даты устройство
Формат даты протокола. Используется протоколами, имеющими настраиваемый формат даты.
декодер.часовой пояс конфигурация устройство
Часовой пояс устройства. Большинство устройств отображают время в формате UTC, но в некоторых случаях устройства отображают местное время, поэтому этот параметр необходимо настроить, чтобы сервер мог правильно декодировать время.
orbcomm.accessId
config
Идентификатор доступа к API ORBCOMM.
orbcomm.password
config
Пароль API ORBCOMM.
smartcar.managementToken config
Токен управления Smartcar используется для проверки веб-перехватчика.
osmand.minAccuracy config
Минимальная требуемая точность. Если значение ниже нуля, оно будет установлено на ноль.
Значение по умолчанию: 10.0
[протокол].альтернатива конфигурация устройство
Используйте альтернативный формат для протокола команд.
Значение по умолчанию: false
[протокол].язык конфигурация устройство
Формат протокола включает поле для указания языка.
Значение по умолчанию: false
server.buffering.threshold config
Если значение не равно нулю, включить буферизацию входящих данных для обработки мест размещения заказов. Значение представляет собой пороговое значение для буферизации в миллисекундах.
Значение по умолчанию: 3000 л
server.timeout config
Значение таймаута соединения на уровне сервера в секундах. Дополнительную информацию см. в разделе «Таймаут протокола».
server.delayAcknowledgement config
Отправляйте ответы устройству немедленно, прежде чем записывать их в базу данных.
server.nettyBossThreads config
Количество основных потоков Netty. Если не указано или равно нулю, используется значение по умолчанию Netty.
Значение по умолчанию: 0
server.nettyThreads config
Количество рабочих потоков Netty. Если не указано или равно нулю, используется значение по умолчанию Netty.
Значение по умолчанию: 0
сервер.статистика config
Адрес для загрузки сводной анонимной статистики использования. Загружаемая информация идентична той, что отображается на экране статистики в веб-приложении. Она не содержит конфиденциальных данных (например, местоположения).
Значение по умолчанию: "https://www.traccar.org/analytics/"
fuelDropThreshold сервер устройство
Пороговое значение падения уровня топлива. Когда уровень топлива падает с одного положения на другое более чем на это значение, генерируется событие.
Значение по умолчанию: 0,0
Порог повышения уровня топлива сервер устройство
Пороговое значение увеличения уровня топлива. Когда уровень топлива увеличивается от одной позиции до другой более чем на это значение, генерируется событие.
Значение по умолчанию: 0,0
топливная емкость устройство
Емкость топливного бака устройства в литрах.
Ограничение скорости сервер устройство
Ограничение скорости указано в узлах.
Значение по умолчанию: 0,0
отключитьПоделиться сервер
Отключите совместное использование устройств на сервере.
event.overspeed.thresholdMultiplier config
Множитель порогового значения ограничения скорости. Например, если ограничение скорости составляет 100, но мы хотим генерировать событие только при скорости выше 105, этот параметр можно установить равным 1,05. Множитель по умолчанию — 1,0.
Значение по умолчанию: 1.0
event.overspeed.minimalDuration config
Минимальная продолжительность превышения скорости, необходимая для срабатывания события. Значение в секундах.
event.overspeed.preferLowest config
Это относится только к ограничениям скорости в пределах геозон. Используйте самое низкое ограничение скорости из всех геозон.
event.behavior.accelerationThreshold config
Пороговое значение ускорения, характерное для поведения водителя. Значение выражено в метрах в секунду в квадрате.
event.behavior.brakingThreshold config
Порог торможения, определяемый поведением водителя. Значение выражено в метрах в секунду в квадрате.
event.ignoreDuplicateAlerts config
Не следует генерировать событие оповещения, если аналогичное оповещение присутствовало в последнем известном местоположении.
Значение по умолчанию: true
event.motion.speedThreshold конфигурация устройство
Если скорость превышает заданное значение, объект считается находящимся в движении. Значение по умолчанию — 0,01 узла.
Значение по умолчанию: 0,01
база данных.память config
Вместо базы данных SQL используйте базу данных, работающую в оперативной памяти.
database.driverFile config
Путь к JAR-файлу драйвера базы данных. Traccar включает драйверы для баз данных MySQL, PostgreSQL и H2. Если вы используете одну из них, указывать этот параметр не нужно.
database.driver config
Java-класс драйвера базы данных. Для H2 используйте 'org.h2.Driver'. Имя класса драйвера MySQL — 'com.mysql.jdbc.Driver'.
database.url config
URL-адрес подключения к базе данных. По умолчанию Traccar использует базу данных H2.
база данных.пользователь config
Имя пользователя базы данных. Пользователь-администратор по умолчанию для базы данных H2 — 'sa'.
база данных.пароль config
Пароль пользователя базы данных. Пароль по умолчанию для пользователя H2 admin (sa) пуст.
database.changelog
config
Путь к основному файлу журнала изменений Liquibase.
Значение по умолчанию: "./schema/changelog-master.xml"
database.maxPoolSize
config
Размер пула соединений с базой данных. Значение по умолчанию определяется библиотекой HikariCP.
database.checkConnection
config
SQL-запрос для проверки состояния соединения. Значение по умолчанию — 'SELECT 1'. Для базы данных Oracle можно использовать 'SELECT 1 FROM DUAL'.
Значение по умолчанию: "ВЫБЕРИТЕ 1"
database.saveOriginal
config
Сохраните исходные шестнадцатеричные или строковые данные в качестве атрибута "raw" в соответствующей позиции.
database.throttleUnknown
config
Ограничивать количество запросов к базе данных неизвестных устройств при отправке повторных запросов.
database.registerUnknown
config
Автоматическая регистрация неизвестных устройств в базе данных.
database.registerUnknown.defaultCategory
config
Категория по умолчанию для автоматически зарегистрированных устройств.
database.registerUnknown.defaultGroupId
config
Идентификатор группы, присвоенный автоматически зарегистрированным устройствам.
database.registerUnknown.regex
config
Автоматическая регистрация неизвестных устройств с помощью фильтра регулярных выражений.
database.saveEmpty
config
Пустые сообщения следует хранить в качестве позиций. Например, пульсации.
users.defaultDeviceLimit
config
Ограничение на количество устройств для самостоятельно зарегистрированных пользователей. Значение по умолчанию -1, что означает отсутствие ограничений.
Значение по умолчанию: -1
users.defaultExpirationDays
config
Значение по умолчанию для самостоятельно зарегистрированных пользователей. Указывается в днях. По умолчанию срок действия не установлен.
ldap.url
config
URL LDAP-сервера. Для получения дополнительной информации см. <a href="https://www.traccar.org/ldap/">конфигурацию LDAP</a>.
ldap.user
config
Вход на LDAP-сервер.
ldap.password
config
Пароль LDAP-сервера.
ldap.force
config
Принудительная аутентификация LDAP.
ldap.base
config
База поиска пользователей LDAP.
ldap.idAttribute
config
Атрибут LDAP, используемый в качестве идентификатора пользователя. Значение по умолчанию — 'uid'.
Значение по умолчанию: "uid"
ldap.nameAttribute
config
Атрибут LDAP, используемый в качестве имени пользователя. Значение по умолчанию — 'cn'.
Значение по умолчанию: "cn"
ldap.mailAttribute
config
Атрибут LDAP, используемый в качестве адреса электронной почты пользователя. Значение по умолчанию — 'mail'.
Значение по умолчанию: "почта"
ldap.searchFilter
config
Пользовательский фильтр поиска LDAP. Если не указан, в качестве фильтра будет использоваться '({idAttribute}=:login)'.
ldap.adminFilter
config
Пользовательский фильтр поиска администратора LDAP.
ldap.adminGroup
config
Группа пользователей-администраторов LDAP. Используется, если не указан пользовательский фильтр администратора.
openid.clients
config
Список клиентов OpenID Connect для встроенного провайдера. Значение должно представлять собой список записей типа 'clientId:clientSecret:redirectUri', разделенных запятыми. Можно указать несколько URI перенаправления, используя символ '|' в качестве разделителя.
openid.force
config
Принудительная аутентификация OpenID Connect. При включении этой функции страница входа в Traccar будет пропущена, и пользователи будут перенаправлены на сайт поставщика OpenID Connect.
openid.clientId
config
Идентификатор клиента OpenID Connect. Это уникальный идентификатор, присваиваемый каждому приложению, которое вы регистрируете у своего поставщика идентификационных данных. Необходим для включения единого входа (SSO).
openid.clientSecret
config
Секретный ключ клиента OpenID Connect. Это секретный ключ, присваиваемый каждому приложению, которое вы регистрируете у своего поставщика идентификации. Необходим для включения единого входа (SSO).
openid.issuerUrl
config
Базовый URL-адрес эмитента OpenID Connect. Он используется для автоматической настройки URL-адресов авторизации, токена и информации о пользователе, если они указаны.
openid.authUrl
config
URL-адрес авторизации OpenID Connect. Обычно его можно найти в документации вашего поставщика идентификации или используя общеизвестную конечную точку конфигурации, например, https://auth.example.com/.well-known/openid-configuration. Необходим для включения единого входа (SSO), если параметр openid.issuerUrl не задан.
openid.tokenUrl
config
URL-адрес токена OpenID Connect. Его можно найти тем же способом, что и openid.authUrl. Он необходим для включения единого входа (SSO), если openid.issuerUrl не задан.
openid.userInfoUrl
config
URL-адрес информации о пользователе OpenID Connect. Его можно найти тем же способом, что и openid.authUrl. Необходим для включения единого входа (SSO), если openid.issuerUrl не задан.
openid.groupsClaimName
config
Имя области действия группы OpenID Connect. Если оно не указано, Traccar будет использовать имя области действия "groups".
Значение по умолчанию: "группы"
openid.allowGroup
config
Группа OpenID Connect, к которой будет ограничен доступ. Если она не указана, все пользователи OpenID будут иметь доступ к Traccar. Этот вариант будет работать только в том случае, если ваш поставщик OpenID поддерживает область действия группы.
openid.adminGroup
config
Для предоставления административного доступа группам OpenID Connect. Если эта информация не указана, административный доступ не будет предоставлен ни одной группе. Этот вариант будет работать только в том случае, если ваш поставщик OpenID поддерживает область действия групп.
статус.таймаут
config
Если устройство не передает данные в течение заданного времени, статус меняется с «в сети» на «неизвестно». Значение указывается в секундах. Время ожидания по умолчанию составляет 10 минут.
Значение по умолчанию: 600 л
статус.игнорироватьОфлайн
config
Список названий протоколов, которые следует игнорировать в состоянии «вне сети». Может быть полезно для предотвращения изменения статуса, когда устройства настроены на отключение после отправки пакета данных.
медиа.путь
config
Путь к папке с медиафайлами. Сервер хранит аудио-, видео- и фотофайлы в этой папке. Для каждого устройства автоматически создаются подпапки с уникальным идентификатором.
Значение по умолчанию: "./media"
веб-адрес
config
Необязательный параметр для указания сетевого интерфейса, к которому будет привязываться веб-интерфейс. По умолчанию сервер будет привязываться ко всем доступным интерфейсам.
веб.порт
config
Номер TCP-порта веб-интерфейса. По умолчанию Traccar использует порт 8082. Чтобы не указывать порт в браузере, можно установить его на 80 (порт HTTP по умолчанию).
Значение по умолчанию: 8082
web.path
config
Путь к папке веб-приложения.
Значение по умолчанию: "./web"
web.override
config
Путь к папке с переопределениями. Его можно использовать для брендинга, чтобы хранить пользовательские логотипы в отдельном месте.
Значение по умолчанию: "./override"
web.timeout
config
Время ожидания соединения WebSocket в миллисекундах. Время ожидания по умолчанию — 5 минут.
Значение по умолчанию: 300000 л
web.sessionTimeout
config
Время ожидания сеанса аутентификации в секундах. По умолчанию время ожидания не установлено.
веб-консоль
config
Включите консоль доступа к базе данных через URL-адрес '/console'. Используйте только для отладки. Никогда не используйте в рабочей среде.
web.debug
config
Отладочная серверная версия веб-приложения. Не рекомендуется использовать по соображениям производительности. Предназначена для использования в целях разработки и отладки.
web.serviceAccountToken
config
Токен для входа в систему под виртуальной учетной записью администратора. Может использоваться для восстановления доступа в случае проблем с обычным входом в систему администратора. Например, если пароль утерян и его невозможно восстановить.
web.origin
config
Значение заголовка origin для обмена ресурсами между источниками.
web.cacheControl
config
Значение заголовка управления кэшированием. По умолчанию ресурсы кэшируются на один час.
Значение по умолчанию: "max-age=3600,public"
web.localizationPath
config
Путь к файлам локализации.
Значение по умолчанию: "./templates/translations"
totpEnable сервер
Включите аутентификацию TOTP на сервере.
totpForce сервер
Атрибут сервера, указывающий на необходимость аутентификации TOTP для новых пользователей.
server.forward
config
Хост для пересылки необработанных данных.
forward.type
config
Формат пересылки позиций. Доступные варианты: "url", "json" и "kafka". По умолчанию используется "url".
Значение по умолчанию: "url"
forward.exchange
config
Обмен данными о позициях через AMQP-платформу.
Значение по умолчанию: "traccar"
forward.topic
config
Переадресация позиции в топике Kafka или ключ маршрутизации AMQP.
Значение по умолчанию: "позиции"
forward.url конфигурация устройство
URL-адрес для пересылки данных о местоположении. Данные передаются через параметры URL-адреса. Например, {uniqueId} — идентификатор устройства, {latitude} и {longitude} — координаты.
forward.header
config
Дополнительный HTTP-заголовок, который можно использовать для авторизации.
forward.retry.enable
config
Включите повторные попытки пересылки позиций. При включении этой опции предпринимаются дополнительные попытки доставки позиций. Если первоначальная доставка не удалась из-за недоступности сервера или HTTP-ответа, отличного от «2xx», программное обеспечение ожидает «forward.retry.delay» миллисекунд для повторной попытки доставки. При последующих сбоях эта задержка удваивается. Если пересылка повторяется в течение «forward.retry.count», повторная попытка отменяется, и позиция отбрасывается. Количество позиций, ожидающих доставки, ограничено «forward.retry.limit». Если этот лимит достигнут, позиции отбрасываются.
forward.retry.delay
config
Задержка повторной попытки пересылки позиции в миллисекундах. Может быть установлена на любое значение больше 0. По умолчанию — 100 миллисекунд.
Значение по умолчанию: 100
forward.retry.count
config
Максимальное количество попыток пересылки позиции. Может быть установлено значение больше 0. По умолчанию — 10 попыток.
Значение по умолчанию: 10
forward.retry.limit
config
Ограничение на количество повторных попыток переадресации позиций. Может быть установлено значение больше 0. По умолчанию — 100 позиций.
Значение по умолчанию: 100
event.forward.type
config
Формат пересылки событий. Доступные варианты: "json" и "kafka". По умолчанию используется "json".
Значение по умолчанию: "json"
event.forward.exchange
config
Обмен событиями через AMQP.
Значение по умолчанию: "fornavi"
событие.пересылка.тема
config
Пересылка событий в топик Kafka или по ключу маршрутизации AMQP.
Значение по умолчанию: "events"
event.forward.url
config
URL-адрес пересылки событий.
event.forward.header
config
Заголовки пересылки событий. Пример значения: FirstHeader: hello SecondHeader: world
шаблоны.корневой
config
Корневая папка для всех файлов шаблонов.
Значение по умолчанию: "шаблоны"
mail.debug
config
Вместо отправки электронных писем через SMTP, используйте функцию регистрации событий. Предназначено исключительно для тестирования.
mail.smtp.systemOnly
config
Ограничьте глобальную конфигурацию SMTP только системными сообщениями (например, сбросом пароля).
mail.smtp.ignoreUserConfig
config
Принудительное указание параметров SMTP из конфигурационного файла и игнорирование атрибутов пользователя.
mail.smtp.host конфигурация пользователь
SMTP-сервер, к которому нужно подключиться.
mail.smtp.port конфигурация пользователь
Порт SMTP-сервера для подключения. По умолчанию — 25.
Значение по умолчанию: 25
почта.транспорт.протокол конфигурация пользователь
Протокол передачи электронной почты. Значение по умолчанию — "smtp".
Значение по умолчанию: "smtp"
mail.smtp.starttls.enable конфигурация пользователь
Если значение равно true, это позволяет использовать команду STARTTLS (если она поддерживается сервером) для переключения соединения на защищенное TLS-соединение перед отправкой каких-либо команд входа в систему.
mail.smtp.starttls.required конфигурация пользователь
Если это так, требуется использование команды STARTTLS. Если сервер не поддерживает команду STARTTLS или команда не выполняется, метод подключения завершится ошибкой.
mail.smtp.ssl.enable конфигурация пользователь
Если установлено значение true, для подключения будет использоваться SSL, а по умолчанию — SSL-порт.
mail.smtp.ssl.trust конфигурация пользователь
Если установлено значение "*", все хосты считаются доверенными. Если задан список хостов, разделенных пробелами, доверенными считаются именно эти хосты. В противном случае доверие зависит от сертификата, предоставленного сервером.
mail.smtp.ssl.protocols конфигурация пользователь
Указывает протоколы SSL, которые будут включены для SSL-соединений.
mail.smtp.username конфигурация пользователь
Имя пользователя для подключения по протоколу SMTP.
mail.smtp.password конфигурация пользователь
Пароль для подключения по протоколу SMTP.
mail.smtp.from конфигурация пользователь
Адрес электронной почты, используемый для команды SMTP MAIL.
mail.smtp.fromName конфигурация пользователь
Имя отправителя в электронном письме.
sms.http.url
config
Полный URL-адрес сервиса SMS API. Позволяет отправлять SMS-команды и уведомления.
sms.http.authorizationHeader
config
Имя заголовка авторизации SMS API. Значение по умолчанию — 'Authorization'.
Значение по умолчанию: "Авторизация"
sms.http.authorization
config
Значение заголовка авторизации SMS API. Это значение имеет приоритет над именем пользователя и паролем.
sms.http.user
config
Базовая аутентификация пользователя через SMS API.
sms.http.password
config
Пароль для базовой аутентификации SMS API.
sms.http.template
config
Шаблон тела SMS API. В шаблоне можно использовать заполнители {phone} и {message}. Если значение начинается с '{' или '[', сервер автоматически предполагает формат JSON.
sms.aws.access
config
Ключ доступа AWS с разрешением SNS.
sms.aws.secret
config
Секретный ключ доступа AWS с разрешением SNS.
sms.aws.region
config
Для службы SNS используйте регион AWS. Убедитесь, что вы используете регионы, поддерживаемые для обмена сообщениями.
команда.отправитель устройство
Тип отправителя команд для устройства. Это переопределяет стандартные команды передачи данных или текста командами на основе API. Например, это могут быть команды отправки данных от имени клиента Traccar.
команда.клиент.службаУчетная запись конфигурация
JSON-файл учетной записи службы Firebase для команд push.
command.findHub.url устройство
URL-адрес сервиса Google Find Hub.
command.findHub.key устройство
Ключ API сервиса Google Find Hub.
notificator.types
config
Включены параметры уведомлений. Ожидается строка, разделенная запятыми. Пример: web,mail,sms
Значение по умолчанию: "web,mail,command"
notificator.timeThreshold
config
Если время события слишком велико, уведомления отправлять не следует. Этот параметр задает пороговое значение в миллисекундах. Значение по умолчанию — 15 минут.
Значение по умолчанию: 15 * 60 * 1000 л
notificator.traccar.key
config
Ключ API для уведомлений Traccar.
notificator.firebase.serviceAccount
config
JSON-данные учетной записи службы Firebase для push-уведомлений.
notificator.pushover.user
config
Имя пользователя для уведомлений Pushover.
notificator.pushover.token
config
Пользовательский токен для уведомлений Pushover.
notificator.telegram.key
config
Ключ API для уведомлений в Telegram.
notificator.telegram.chatId
config
Идентификатор чата уведомлений Telegram для отправки сообщений.
notificator.telegram.sendLocation
config
В уведомлении Telegram отправляется сообщение с указанием местоположения.
notificator.whatsapp.token
config
Постоянный токен доступа к облачному API WhatsApp.
notificator.whatsapp.phoneNumberId
config
Идентификатор номера телефона в WhatsApp Cloud API.
notificator.whatsapp.templateName
config
Название шаблона WhatsApp Cloud API.
notificator.whatsapp.templateLanguage
config
Код языка шаблона API облачного сервиса WhatsApp. Значение по умолчанию — "en_US".
Значение по умолчанию: "en_US"
notification.expiration.user
config
Включить уведомления по электронной почте об истечении срока действия учетной записи пользователя.
notification.expiration.user.reminder
config
Напоминание пользователю об истечении срока действия. Значение в миллисекундах.
notification.expiration.device
config
Включить уведомления по электронной почте об истечении срока действия устройства.
notification.expiration.device.reminder
config
Напоминание об истечении срока действия устройства. Значение в миллисекундах.
notification.block.users
config
Блокировать уведомления для определенных пользователей. Значение должно представлять собой список внутренних идентификаторов пользователей, разделенных запятыми.
report.periodLimit
config
Максимальный период времени для отчетов указан в секундах. Может быть полезно для предотвращения запросов пользователями на отчеты неоправданно большой продолжительности. По умолчанию ограничений нет.
report.fastThreshold
config
Временной порог для быстрых отчетов. Быстрые отчеты более эффективны, но менее точны и могут содержать неполную информацию. Значение указывается в секундах. По умолчанию — один день.
Значение по умолчанию: 86400 л
report.trip.newLogic
config
Включить новую логику расчета поездок.
Значение по умолчанию: true
report.trip.minDistance конфигурация устройство
Расстояния, превышающие минимальное значение, считаются поездками.
Значение по умолчанию: 200 л
report.trip.minDuration конфигурация устройство
Если устройство не движется в течение минимального времени, это считается остановкой.
Значение по умолчанию: 180 л
report.trip.stopGap конфигурация устройство
Перерывы, превышающие указанное время, рассматриваются как остановки/поездки/остановки в зависимости от средней скорости. Значение по умолчанию — один час.
Значение по умолчанию: 3600 л
report.trip.minimalTripDistance конфигурация устройство
Поездки продолжительностью менее минимальной и на минимальное расстояние игнорируются. По умолчанию установлено значение 300 секунд и 500 метров.
Значение по умолчанию: 500 л
report.trip.minimalTripDuration конфигурация устройство
Поездки продолжительностью менее минимальной и на минимальное расстояние игнорируются. По умолчанию установлено значение 300 секунд и 500 метров.
Значение по умолчанию: 300 л
report.trip.minimalParkingDuration конфигурация устройство
Парковка на время, меньшее минимального, не разделяет поездку на части. По умолчанию — 300 секунд.
Значение по умолчанию: 300 л
report.trip.minimalNoDataDuration конфигурация устройство
Перерывы, превышающие указанное время, считаются остановками. Значение по умолчанию — один час.
Значение по умолчанию: 3600 л
report.trip.useIgnition конфигурация устройство
Флаг, разрешающий использование зажигания для расчета поездок.
Значение по умолчанию: false
report.ignoreOdometer конфигурация устройство
Игнорируйте показания одометра, отображаемые устройством, и используйте вместо них общее пройденное расстояние, рассчитанное сервером. Это полезно, если устройство сообщает недопустимые или нулевые значения одометра.
Значение по умолчанию: false
filter.enable
config
Логический флаг для включения или отключения фильтрации по позиции.
Значение по умолчанию: true
filter.invalid
config
Фильтрация недопустимых позиций (поле допустимости установлено в значение false).
filter.zero
config
Фильтрация нулевых координат. Нулевые значения широты и долготы теоретически допустимы, но на практике обычно указывают на некорректные данные GPS.
filter.duplicate
config
Фильтрация повторяющихся записей (дубликаты обнаруживаются по значению времени).
фильтр.устаревший
config
Отфильтруйте сообщения, не содержащие данных о местоположении GPS. Если они не отфильтрованы, в них будет указано последнее известное местоположение.
фильтр.будущее
config
Фильтруйте записи с фиксированным временем в будущем. Значение указывается в секундах. Записи, у которых фиксированное время отстает от текущего серверного времени более чем на указанное количество секунд, будут отфильтрованы.
Значение по умолчанию: 86400 л
filter.past
config
Фильтруйте записи, у которых фиксированное время находится в прошлом. Значение указывается в секундах. Записи, у которых фиксированное время превышает указанное количество секунд до текущего времени сервера, будут отфильтрованы.
фильтр.точность
config
Фильтрация позиций с точностью ниже заданного значения в метрах.
фильтр.приблизительный
config
Фильтруйте местоположения сотовых телефонов и сетей Wi-Fi, полученные от поставщика геолокации.
filter.static
config
Фильтруйте позиции со значениями скорости, равными нулю.
фильтр.расстояние
config
Фильтрация записей по расстоянию. Значение указывается в метрах. Если новая позиция находится ближе к предыдущей, чем это значение, она отфильтровывается.
filter.maxSpeed
config
Фильтрация записей по значению максимальной скорости в узлах. Может использоваться для фильтрации прыжков в удаленные места, даже если положение кажется допустимым или если поле «скорость» положения, сообщаемое устройством, также находится в пределах допустимых значений. Скорость рассчитывается исходя из расстояния до предыдущей позиции и прошедшего времени. Совет: значения не должны быть слишком низкими. Начните тестирование со значений около 25000.
filter.minPeriod
config
Отфильтруйте позицию, если время, прошедшее с предыдущей позиции, меньше указанного значения в секундах.
filter.dailyLimit
config
Положение дроссельной заслонки, если превышен суточный лимит для устройства.
filter.dailyLimitInterval
config
Интервал регулирования, если превышен лимит. Значение указывается в секундах.
filter.relative
config
Если значение равно false, сервер ожидает, что все местоположения будут поступать последовательно (для каждого устройства). Фильтр проверяет наличие дубликатов, расстояния, скорости или временного периода только по отношению к последнему полученному сервером местоположению. Если значение равно true, сервер ожидает, что местоположения будут поступать в случайном порядке (поскольку устройство слежения может отключиться). Фильтр проверяет наличие дубликатов, расстояния, скорости или временного периода по отношению к предыдущей позиции. Важно: установка значения true может привести к потенциальным проблемам с производительностью.
filter.skipLimit
config
Ограничение по времени для фильтрации в секундах. Если разница во времени между моментом получения сервером последней позиции и моментом получения сервером новой позиции превышает это ограничение, новая позиция не будет отфильтрована.
filter.skipAttributes.enable
config
Включите пропуск атрибутов. Пропуск атрибутов можно включить в конфигурации или в атрибутах устройства. Если позиция содержит какой-либо атрибут, указанный в ключе конфигурации "filter.skipAttributes", позиция не будет отфильтрована.
filter.skipAttributes конфигурация устройство
Пропуск атрибутов можно включить в конфигурации или в атрибутах устройства. Если позиция содержит какой-либо атрибут, указанный в ключе конфигурации "filter.skipAttributes", позиция не будет отфильтрована.
Значение по умолчанию: ""
время.переопределение
config
Задайте время устройства. Возможные значения: 'deviceTime' и 'serverTime'.
протоколы.включить
config
Список протоколов для включения. Если не указано, Traccar включает все протоколы, номера портов которых перечислены. Значение представляет собой список названий протоколов, разделенных запятыми. Пример значения: teltonika,osmand
время.протоколы
config
Список протоколов для переопределения времени. Если не указано иное, переопределение применяется глобально. Список состоит из названий протоколов, которые могут быть разделены запятой или одним пробелом.
координаты.фильтр
config
Заменяет координаты последними известными координатами, если изменение меньше 'coordinates.minError' метров или больше 'coordinates.maxError' метров. Помогает избежать скачков координат во время парковки или скачков до нулевых координат.
coordinates.minError
config
Расстояние в метрах. Расстояния меньше этого значения обрабатываются, как описано в файле 'coordinates.filter'.
coordinates.maxError
config
Расстояние в метрах. Расстояния, превышающие это значение, обрабатываются, как описано в файле 'coordinates.filter'.
processing.remoteAddress.enable
config
Включить сохранение информации об IP-адресе устройства. По умолчанию отключено.
обработка.использованиеСвязанногоДрайвера конфигурация
Если устройство не отправляет идентификатор драйвера, используйте связанный идентификатор драйвера для указания местоположения.
processing.copyAttributes.enable
config
Включить копирование отсутствующих атрибутов из последней позиции в текущую. Может быть полезно, если устройство не отправляет некоторые значения в каждом сообщении.
processing.copyAttributes конфигурация устройство
Список атрибутов для копирования. Атрибуты должны быть разделены запятой без пробелов. Например: alarm,ignition
обработка.вычисленныеАтрибуты.атрибутыУстройства конфигурация
Включите атрибуты устройства в контекст вычисляемых атрибутов.
обработка.вычисленныеАтрибуты.последниеАтрибуты конфигурация
Включите атрибуты последней позиции в контекст вычисляемого атрибута.
processing.computedAttributes.localVariables
config
Включить объявление локальных переменных.
processing.computedAttributes.loops
config
Включить циклическую обработку.
processing.computedAttributes.newInstanceCreation
config
Включить создание новых экземпляров. Если эта функция отключена, при разборе скрипта/выражения с использованием 'new(...)' возникнет исключение.
geocoder.enable
config
Логический флаг для включения или выключения обратного геокодера.
Значение по умолчанию: true
geocoder.type
config
Тип обратного геокодера. Для получения дополнительной информации см. документацию по обратному геокодированию.
Значение по умолчанию: "locationiq"
geocoder.url
config
URL-адрес сервера геокодирования. Применимо только к поставщикам услуг Nominatim и Gisgraphy.
geocoder.key
config
Ключ API поставщика. Большинству поставщиков требуются ключи API.
Значение по умолчанию: "pk.689d849289c8c63708068b2ff1f63b2d"
geocoder.language
config
Параметр языка для поставщиков, поддерживающих локализацию (например, Google и Nominatim).
geocoder.format
config
Строка формата адреса. Значение по умолчанию: %h %r, %t, %s, %c. Дополнительную информацию см. в разделе AddressFormat.
geocoder.cacheSize
config
Размер кэша для результатов геокодирования.
geocoder.ignorePositions
config
Отключить автоматические запросы обратного геокодирования для всех позиций.
Значение по умолчанию: true
geocoder.reuseDistance
config
Необязательный параметр для указания минимального расстояния для нового запроса обратного геокодирования. Если расстояние меньше указанного значения (в метрах), Traccar будет использовать последний известный адрес.
geocoder.onRequest
config
При подготовке отчетов и отправке уведомлений выполняйте геокодирование.
Значение по умолчанию: true
геолокация.включить
config
Логический флаг для включения определения местоположения по LBS. Некоторые устройства отправляют информацию о вышках сотовой связи и точках Wi-Fi, когда местоположение GPS недоступно. Traccar может определять координаты на основе этой информации с помощью сторонних сервисов. Значение по умолчанию — false.
геолокация.тип
config
Поставщик услуг определения местоположения по LBS. Доступные варианты: Google, Unwired и OpenCellID. По умолчанию используется Google. Вам необходимо указать ключ, который вы получите от соответствующего поставщика. Для получения дополнительной информации см. документацию по геолокации LBS.
геолокация.url
config
URL-адрес API поставщика геолокации. Для большинства поставщиков это не требуется.
геолокация.ключ
config
Ключ API поставщика. Сервису OpenCellID требуется ключ API.
geolocation.processInvalidPositions
config
Логический флаг для применения геолокации к недопустимым позициям.
геолокация.повторное использование
config
Если данные сети не изменились, используйте последний полученный результат геолокации.
geolocation.requireWifi
config
Обрабатывайте геолокацию только при наличии информации о Wi-Fi. Это повышает точность результата.
геолокация.мкк
config
Значение MCC по умолчанию, используемое, если устройство не сообщает о наличии MCC.
геолокация.мнк
config
Значение MNC по умолчанию, используемое, если устройство не сообщает о наличии MNC.
speedLimit.enable
config
Логический флаг, позволяющий включить API для получения значений ограничения скорости в зависимости от местоположения. Значение по умолчанию — false.
speedLimit.type
config
Поставщик услуг, используемый для определения ограничения скорости. Доступные варианты: эстакада. По умолчанию используется эстакада.
speedLimit.url
config
URL-адрес API поставщика ограничений скорости.
speedLimit.accuracy
config
Радиус поиска ограничения скорости. Значение указывается в метрах. Значение по умолчанию — 100.
Значение по умолчанию: 100
местоположение.широтаПолушарие
config
Переопределить знак широты/полушари. Полезно в случаях, когда значение неверно из-за ошибки устройства. Значение может быть N для севера или S для юга.
местоположение.долготаПолушарие
config
Переопределить знак долготы / полушарие. Полезно в случаях, когда значение неверно из-за ошибки устройства. Значение может быть E для Востока или W для Запада.
web.requestLog.path
config
Путь к логам запросов Jetty. Путь должен содержать строку "yyyy_mm_dd", которая заменяется фактической датой при создании и обновлении файла. Пример: ./logs/jetty-yyyy_mm_dd.request.log
web.requestLog.retainDays
config
Установите количество дней, через которое будут удалены файлы журналов ротированных запросов.
web.disableHealthCheck
config
Отключить проверки работоспособности systemd.
web.healthCheck.dropThreshold
config
Если этот параметр задан, Traccar будет отслеживать снижение количества сохраненных сообщений. Если оно превысит пороговое значение, служба systemd будет помечена как неисправная. Пороговое значение — от 0,0 до 1,0. Например, значение 0,7 означает, что количество сообщений за последний период составляет лишь 70% от количества сообщений за предыдущий период.
web.sameSiteCookie
config
Устанавливает значение атрибута cookie SameSite. Поддерживаемые параметры: Lax, Strict, None.
web.persistSession
config
Позволяет сохранять сессии Jetty в базе данных.
web.url
config
Публичный URL веб-приложения. Используется для уведомлений, ссылок на отчеты и OpenID Connect. Если не указан, Traccar попытается получить URL с IP-адреса сервера, но это может быть локальный адрес.
web.showUnknownDevices
config
Показать журналы с неизвестных устройств.
web.shareDevice.commands
config
Включить команды для устройства общего пользования.
web.shareDevice.reports
config
Включите создание отчетов для устройства, используемого совместно.
web.mcp.enable
config
Включите службу MCP.
logger.console
config
Вывод логов осуществляется в стандартный вывод терминала, а не в лог-файл.
logger.queries
config
Записывайте в журнал выполненные SQL-запросы.
logger.file
config
Имя файла журнала. Для ротируемых журналов в конец имени файла для неактуальных журналов добавляется дата.
Значение по умолчанию: "./logs/tracker-server.log"
logger.level
config
Уровень логирования. Значение по умолчанию — 'info'. Доступные варианты: off, severe, warning, info, config, fine, finer, finest, all.
Значение по умолчанию: "info"
logger.fullStackTraces
config
Выводит полные трассировки исключений. Полезно для отладки. По умолчанию записываются сокращенные трассировки.
logger.rotate
config
Ежедневно создавать новый файл журнала. Это помогает в управлении журналами, например, при загрузке и очистке. Включено по умолчанию.
Значение по умолчанию: true
logger.decodeTextData
config
Если все байты являются печатными символами, регистрируйте сетевые данные в текстовом формате, а не в шестнадцатеричном.
Значение по умолчанию: true
logger.rotate.interval
config
Интервал ротации лог-файлов. По умолчанию ротация происходит один раз в день. Этот параметр игнорируется, если 'logger.rotate' = false. Доступные значения: день, час.
Значение по умолчанию: "день"
logger.attributes
config
Список атрибутов позиции для записи в лог.
Значение по умолчанию: "время, положение, скорость, курс, точность, результат"
broadcast.type
config
Метод широковещательной рассылки. Доступные варианты: "multicast" и "redis". По умолчанию (если значение не указано или не соответствует доступным параметрам) сервер отключает широковещательную рассылку.
broadcast.interface
config
Многоадресный интерфейс. Он может представлять собой либо IP-адрес, либо имя интерфейса.
broadcast.address
config
Адрес многоадресной рассылки или URL-адрес Redis для трансляции событий синхронизации.
broadcast.port
config
Многоадресный порт для трансляции событий синхронизации.
трансляция.вторичная
config
Флаг для обозначения резервных серверов. Некоторые задачи, например, запланированные отчеты, будут выполняться только на основном сервере.