Файловое хранилище

Настроить параметры хранения файлов можно, перейдя в Системная консоль → Окружение → Файловое хранилище или отредактировав файл config.json.

Хранилище файлов

примечание

Доступно только в On-Premise инсталляции Time.

Тип используемой системы хранения файлов. Это может быть либо локальная файловая система, либо Amazon S3.

• Путь к системной конфигурации: Окружение → Файловое хранилище
• Переменная среды: TIME_FILESETTINGS_DRIVERNAME
• Значения:
  • локальная файловая система: (По умолчанию) Файлы и изображения хранятся в указанном локальном каталоге файлов.
  • amazon S3: Файлы и изображения хранятся на Amazon S3 в соответствии с указанными полями ключа доступа, бакета и региона. Драйвер совместим с MinIO (бета-версия) и Digital Ocean Spaces.

Каталог хранения

примечание

Доступно только в On-Premise инсталляции Time.

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

По умолчанию используется ./data/.

• Путь к системной конфигурации: Окружение → Файловое хранилище
• Переменная окружения: TIME_FILESETTINGS_DIRECTORY

Если для системы хранения файлов установлено значение amazons3, эта настройка не доступна.

Максимальный размер файла

примечание

Для изменения параметра в SaaS инсталляции Time обратитесь в техническую поддержку.

Максимальный размер файла для вложений сообщения. Это значение должно быть указано в мегабайтах в системной консоли и в байтах в файле config.json.

По умолчанию: 104857600 байт (100 мегабайт).

• Путь к системной конфигурации: Окружение → Файловое хранилище
• Переменная окружения: TIME_FILESETTINGS_MAXFILESIZE

подсказка

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

Если используется прокси-сервер или балансировщик нагрузки следующие настройки прокси-сервера должны быть скорректированы соответствующим образом:

• Для NGINX необходимо использовать client_max_body_size.
• Для Apache необходимо использовать LimitRequestBody.

Включить поиск документов по содержанию

примечание

Доступно только в On-Premise инсталляции Time.

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

• Путь к системной конфигурации: Окружение → Файловое хранилище
• Переменная среды: TIME_FILESETTINGS_EXTRACTCONTENT
• Значения:
  • да: (По умолчанию) Документы можно искать по их содержимому.
  • нет: Документы нельзя искать по их содержимому. Если поиск по содержимому документа отключен, пользователи могут искать файлы только по имени файла.

Поиск осуществляется в следующих форматах: DOC, DOCX, PPTX, ODT, RTF, HTML:

Включить поиск в документах в ZIP-файлах

примечание

Доступно только в On-Premise инсталляции Time.

Позволяет пользователям искать содержимое сжатых ZIP-файлов, прикрепленных к сообщениям.

• Путь к системной конфигурации: Окружение → Файловое хранилище
• Переменная окружения: TIME_FILESETTINGS_ARCHIVERECURSION
• Значения:
  • да: Содержимое документов в ZIP-файлах возвращается в результатах поиска. Это может повлиять на производительность сервера для больших файлов.
  • нет: (По умолчанию) Содержимое документов в ZIP-файлах не возвращается в результатах поиска.

подсказка

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

Бакет Amazon S3

примечание

Доступно только в On-Premise инсталляции Time.

Имя бакета для вашего экземпляра объектного хранилища, совместимого с S3.

Строка с именем S3-совместимого бакета.

• Путь к системной конфигурации: Окружение → Файловое хранилище
• Переменная окружения: TIME_FILESETTINGS_AMAZONS3BUCKET

Префикс пути Amazon S3

примечание

Доступно только в On-Premise инсталляции Time.

Префикс, выбранный для Amazon S3 в AWS.

Строка, содержащая префикс пути.

• Путь к системной конфигурации: N/A
• Переменная окружения: TIME_FILESETTINGS_AMAZONS3PATHPREFIX

Регион Amazon S3

примечание

Доступно только в On-Premise инсталляции Time.

Регион AWS, выбранный при создании Amazon S3 в AWS.

Строка с регионом AWS. Если регион не задан, система пытается получить соответствующий регион от AWS и устанавливает его в us-east-1, если он не найден.

• Путь к системной конфигурации: Окружение → Файловое хранилище
• Переменная среды: TIME_FILESETTINGS_AMAZONS3REGION

подсказка

Для MinIO или Digital Ocean Spaces оставьте этот параметр пустым.

ID ключа доступа Amazon S3

примечание

Доступно только в On-Premise инсталляции Time.

Строка с ключом доступа для экземпляра хранилища, совместимого с S3.

Администратор EC2 может предоставить идентификатор ключа доступа.

• Путь к системной конфигурации: Окружение → Файловое хранилище
• Переменная окружения: TIME_FILESETTINGS_AMAZONS3ACCESSKEYID

Это необходимо для доступа, если не используется Amazon S3 IAM Role с Amazon S3.

Хост Amazon S3

примечание

Доступно только в On-Premise инсталляции Time.

Строка с именем хоста экземпляра хранилища, совместимого с S3.

По умолчанию s3.amazonaws.com.

• Путь к системной конфигурации: Окружение → Файловое хранилище
• Переменная среды: TIME_FILESETTINGS_AMAZONS3ENDPOINT

Для пространств Digital Ocean Spaces имя хоста должно быть установлено на <region>.digitaloceanspaces.com, где <region> — это аббревиатура региона, выбранного при настройке пространства. Это может быть nyc3, ams3 или sgp1.

Секретный ключ доступа Amazon S3

примечание

Доступно только в On-Premise инсталляции Time.

Секретный ключ доступа, связанный с идентификатором ключа доступа Amazon S3.

Строка с секретным ключом доступа для экземпляра хранилища, совместимого с S3.

• Путь к системной конфигурации: Окружение → Файловое хранилище
• Переменная окружения: TIME_FILESETTINGS_AMAZONS3SECRETACCESSKEY

Включить защищенные соединения с Amazon S3

примечание

Доступно только в On-Premise инсталляции Time.

Включить защищенные соединения с Amazon S3.

• Путь к системной конфигурации: Окружение → Файловое хранилище
• Переменная окружения: TIME_FILESETTINGS_AMAZONS3SSL
• Значения:
  • да: (По умолчанию) Включает только безопасные соединения Amazon S3.
  • нет: Разрешает небезопасные соединения с Amazon S3.

Amazon S3 v2

примечание

Доступно только в On-Premise инсталляции Time.

По умолчанию используется Signature v4 для вызовов API к AWS, но при некоторых обстоятельствах требуется v2.

• Путь к системной конфигурации: N/A
• Переменная окружения: TIME_FILESETTINGS_AMAZONS3SIGNV2
• Значения:
  • true: Использовать процесс Signature v2.
  • false: (По умолчанию) Использовать процесс Signature v4.

подсказка

Информацию о том, когда следует использовать процесс подписания Signature v2, см. в документации AWS.

Шифрование на стороне сервера для Amazon S3

примечание

Доступно только в On-Premise инсталляции Time.

Включить шифрование на стороне сервера для Amazon S3:

• Путь к системной конфигурации: Окружение → Файловое хранилище
• Переменная окружения: TIME_FILESETTINGS_AMAZONS3SSE
• Значения:
  • да: Шифрует файлы в Amazon S3, используя шифрование на стороне сервера с помощью ключей, управляемых Amazon S3.
  • нет: (По умолчанию) Не шифрует файлы в Amazon S3.

Включить отладку Amazon S3

примечание

Доступно только в On-Premise инсталляции Time.

Включить или отключить отладку Amazon S3 для сбора дополнительной отладочной информации в системных журналах.

• Путь к системной конфигурации: Окружение → Файловое хранилище
• Переменная окружения: TIME_FILESETTINGS_AMAZONS3TRACE
• Значения:
  • да: Запись дополнительной отладочной информации в системные журналы.
  • нет: (По умолчанию) Отладочная информация Amazon S3 не включается в системные журналы. Обычно на проде устанавливается значение false.

подсказка

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

Количество одновременной обработки картинок очереди FastTrack на каждый GiB памяти

Устанавливает количество картинок, которые сервер может обрабатывать одновременно на каждый GiB памяти.

Очередь FastTrack используется для обработки маленьких и/или baseline jpeg картинок.

Рекомендуемые значения: 20.

По умолчанию: 20.

• Переменная окружения: TIME_FILESETTINGS_IMAGEFASTTRACKQUEUESIZEPERGIB

Количество одновременной обработки картинок очереди Base на каждый GiB памяти

Устанавливает количество картинок, которые сервер может обрабатывать одновременно на каждый GiB памяти.

Очередь Base используется для обработки картинк, которые не подошли для очереди Fasttrack.

Рекомендуемые значения: 4.

По умолчанию: 4.

• Переменная окружения: TIME_FILESETTINGS_IMAGEBASEQUEUESIZEPERGIB

Количество одновременной обработки картинок очереди Background на каждый GiB памяти

Устанавливает количество картинок, которые сервер может обрабатывать одновременно в очереди Background на каждый GiB памяти.

Очередь Background используется для фоновой обработки превью картинок.

Рекомендуемые значения: 1.

По умолчанию: 1.

• Переменная окружения: TIME_FILESETTINGS_IMAGEBACKGROUNDQUEUESIZEPERGIB

Порог размера картинки для определения в FastTrack очередь

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

Рекомендуемые значения: +1 на каждый ГБ RAM.

По умолчанию: 120.

• Переменная окружения: TIME_FILESETTINGS_IMAGEBASEQUEUETHRESHOLD

Общее количество памяти для обработки картинок

Общее количество памяти на один под, используя для расчета размера очереди Должно соответствовать следующему уравнению: ^[0-9]+(([KMGT]i)?B)?$

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

• KiB, MiB, GiB, TiB, которые представляют двоичные единицы измерения IEC/ISO 80000, или
• B, который представляет только байты.

По умолчанию: 1GiB.

• Переменная окружения: TIME_FILESETTINGS_IMAGEWORKERTOTALMEMORY

Начальный шрифт

примечание

Доступно только в On-Premise инсталляции Time.

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

Строка с именем файла шрифта. По умолчанию nunito-bold.ttf.

• Путь к системной конфигурации: N/A
• Переменная среды: TIME_FILESETTINGS_INITIALFONT

Проверка файлов ICAP-серверами

Проверку файлов ICAP-серверами можно настроить отредактировав файл config.json или в переменных окружения. Проверка ICAP может в двух режимах: превентивном и мониторинговом.

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

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

примечание

Настройки у этих двух режимов аналогичные, но разделены на две отдельные секции

Включить отправку файлов в ICAP-сервера

примечание

Для изменения параметра в SaaS инсталляции Time обратитесь в техническую поддержку.

Превентивный режим:

• Переменная среды: TIME_ICAPVERIFIERSETTINGS_ENABLE
• Значения:
  • нет: (По умолчанию) Отключает отправку файлов в ICAP-сервера.
  • да: Включает отправку файлов в ICAP-сервера.

Мониторинговый режим:

• Переменная среды: TIME_ICAPMONITORINGSETTINGS_ENABLE
• Значения:
  • нет: (По умолчанию) Отключает отправку файлов в ICAP-сервера.
  • да: Включает отправку файлов в ICAP-сервера.

Список ICAP-серверов

примечание

Для изменения параметра в SaaS инсталляции Time обратитесь в техническую поддержку.

Разделенный запятыми список ICAP серверов, перечисленных через запятую с указанием ServiceName (обычно это reqmode). В случае указания нескольких серверов проверки выполняются параллельно.

Превентивный режим:

• Переменная среды: TIME_ICAPVERIFIERSETTINGS_ICAPADDRS

Мониторинговый режим:

• Переменная среды: TIME_ICAPMONITORINGSETTINGS_ICAPADDRS

Тайм-аут проверки ICAP серверами

примечание

Для изменения параметра в SaaS инсталляции Time обратитесь в техническую поддержку.

Максимально допустимое время проверки файла ICAP-серверами.

warning

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

Формат ввода: numeric в секундах. По умолчанию: 5 секунд.

Превентивный режим:

• Переменная среды: TIME_ICAPVERIFIERSETTINGS_TIMEOUT

Мониторинговый режим:

• Переменная среды: TIME_ICAPMONITORINGSETTINGS_TIMEOUT

Имя заголовка для передачи request_id в ICAP-сервер

примечание

Для изменения параметра в SaaS инсталляции Time обратитесь в техническую поддержку.

Имя заголовка, используемого для передачи request_id в ICAP-сервер. В случае если был передан в запросе идентичный заголовок, то искомое значение будет находиться последним в списке.

Формат ввода: string

• Переменная среды: TIME_ICAPVERIFIERSETTINGS_CUSTOMREQUESTIDFIELD