Большинство глобальных параметров сервера определяются в 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

Флаг для обозначения резервных серверов. Некоторые задачи, например, запланированные отчеты, будут выполняться только на основном сервере.