Настройка своего сервера

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

#Переменные окружения

Полный список — в .env.example в репозитории. Основные:

После изменения .env пересоздай контейнер:

docker compose up -d --force-recreate

#Обратный прокси и HTTPS

На VPS держи Eggent на 127.0.0.1 и ставь перед ним прокси с HTTPS. HTTPS нужен не только для безопасности: без него браузер не даст доступ к микрофону, а Telegram не примет вебхук.

Caddy (сертификат получит сам):

eggent.example.com {
    request_body {
        max_size 100MB
    }
    reverse_proxy 127.0.0.1:3000
}

Nginx:

server {
    server_name eggent.example.com;
    client_max_body_size 100m;

    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_buffering off;
        proxy_read_timeout 600s;
    }
}

После настройки прокси пропиши публичный адрес в APP_BASE_URL.

#Telegram на своём сервере

Бот подключается в Настройки → Мессенджеры, как описано в «Telegram». Режим:

• Long Polling — работает без публичного адреса. Подходит для домашней машины. Сообщения обрабатываются по очереди, поэтому то, что ты отправляешь, пока агент занят, — включая /reset и «стоп», — прочитывается, когда этот ход закончится; «замолчавший» ход завершают лимиты EGGENT_TURN_SILENCE_* выше.
• Webhook — нужен публичный HTTPS-адрес (APP_BASE_URL). Быстрее и надёжнее на VPS.

Режим Auto сам выберет вебхук, когда публичный HTTPS-адрес задан.

#Исходящий прокси

Если сервер выходит в интернет только через прокси, задай HTTPS_PROXY (и при необходимости HTTP_PROXY, NO_PROXY). Нужен Node.js 22.23 или новее; в Docker-образе он уже такой.

#Безопасность

• Не открывай порт Eggent в интернет без HTTPS. По умолчанию он слушает только 127.0.0.1 — так и оставь, если стоит прокси.
• Сразу смени логин и пароль по умолчанию.
• Относись к токену внешнего API как к паролю и не используй его в коде браузера.
• Защищай и резервируй папку data/: там чаты, файлы, память, настройки и ключи.
• У агента есть терминал внутри контейнера. Не монтируй в контейнер папки, к которым агенту не нужен доступ.