Конфигурация

Программа Eonza не требует установки и распространяется в виде единственного запускаемого файла. При первом запуске она создает все необходимые директории и файлы.

  • log - директория для хранения лога программы и запускаемых скриптов.
  • users - директория для хранения пользовательских настроек.
  • eonza(.exe) - программа Eonza.
  • eonza.eox - двоичный файл с данными. Он содержит создаваемые пользователем скрипты и общие настройки.
  • eonza.yaml - файл конфигурации.
  • eonza.eon - двоичный файл с уведомлениями и прочей служебной информацией. Удаление этого файла не влияет на работоспособность программы.

Файл конфигурации

Главные настройки программы вынесены в YAML файл конфигурации eonza.yaml. Ниже представлен пример файла конфигурации, который создается по умолчанию.

 1version: 1.1.0+1
 2mode: default
 3assetsdir: ""
 4extsdir: ""
 5log:
 6  dir: ""
 7  mode: file
 8  level: info
 9users:
10  dir: ""
11http:
12  host: localhost
13  port: 3234
14  open: true
15  theme: default
16  jwtkey: s5c82473epey
17playground:
18  dir: ""
19  summary: 0
20  files: 0
21  size: 0
22whitelist: []
  • version - версия Eonza.
  • mode - режим работы программы. Если не указан, то программа будет работать в режиме по умолчанию. Возможны следующие варианты:
    • default - режим по умолчанию.
    • develop - режим разработчика.
    • playground - режим безопасной "песочницы".
  • assetsdir - по умолчанию, файлы для фронтенда (html, js, png) упакованы в исполняемый файл. Вы можете указать директорию к этим файлам в распакованном виде. Это позволяет использовать модифицированные версии файлов.
  • extsdir - директория для установки расширений. Каждое расширение устанавливается в отдельную поддиректорию.
  • whitelist - если вы установили Eonza на удаленном сервере (хостинге), то мы рекомендуем указать "белый список" ip-адресов в дополнении к защите по паролю. В этом параметре укажите массив подсетей, откуда возможно подключение к программе. Если запрос к Eonza придёт от ip-адреса, который не входит ни в одну из указанных сетей, то будет отправлена ошибка - Доступ запрещен. При определении "белого списка" обязательно добавьте в него следующие подсети: ::1/128, 127.0.0.0/31.
1whitelist:
2  - ::1/128
3  - 127.0.0.0/31
4  - 192.168.0.0/24

Раздел логирования

  • dir - путь к директории с лог-файлами. Если равна пустой строке, то используется поддиректория log в директории с файлом конфигурации.
  • mode - тип логирования. Может быть комбинацией file и/или stdout. Если не указан, то логирование отключено. Например, mode: file stdout.
  • level - уровень логирования. Может быть disable, error, warn, info.

Раздел пользователей

  • dir - путь к директории с данными пользователей. Если равна пустой строке, то используется поддиректория users в директории с файлом конфигурации.

HTTP настройки

Eonza запускает веб-сервер для отображения программы в браузере. Здесь перечислены настройки относящиеся к работе веб-сервера.

  • host - имя хоста (домена) по которому можно получить доступ к Eonza. По умолчанию, равен localhost. Если вы устанавливайте Eonza на хостинге, то укажите имя домена. В этом случае, следует установить пароль, указать параметры cert и priv. Также рекомендуется определить "белый список" IP-адресов для доступа.
  • port - порт, который использует веб-сервер. По умолчанию, 3234.
  • localport - порт для системного localhost сервера. Если не указан или равен 0, то используется port + 1.
  • open - укажите false, если вы не хотите автоматически открывать вкладку в браузере при запуске программы. Игнорируется, если host не равен localhost.
  • theme - зарезервировано.
  • jwtkey - секретный ключ для создания JWT токенов авторизации. Он необходим в том случае, если вы используйте пароль. Ключ генерируется автоматически при создании файла конфигурации, но вы в дальнейшем можете изменить его.

Eсли host не равен localhost, то в этом случае используется только https соединение. Поэтому вы должны указать полный путь к SSL сертификату и приватному ключу.

  • cert - SSL сертификат.
  • priv - приватный ключ.
1http:
2  host: www.eonza.org
3  port: 3234
4  theme: default
5  jwtkey: s5c82473epey
6  cert: "/etc/letsencrypt/live/eonza.org/fullchain.pem"
7  priv: "/etc/letsencrypt/live/eonza.org/privkey.pem"

Настройки режима "песочницы"

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

  • dir - путь к директории для записи и чтения файлов. Если не указан, то будет будет создана поддиректория во временной директории.
  • summary - суммарный размер файлов. По умолчанию, 10 MB.
  • files - максимальное количество файлов. По умолчанию, 100.
  • size - максимальный размер файла. По умолчанию, 5 MB.
  • tasks - максимальное количество одновременно работающих скриптов. По умолчанию, 2.
1mode: playground
2...
3playground:
4    dir: "/tmp/eonza/playground"
5    summary: 20000000
6    files: 250
7    size: 3000000
8    tasks: 3
Онлайн-демо
Скачать Документация Скрипты Поддержка Pro версия
Русский
English