Odysseusv1.0.3
Личный ИИ-ассистент для работы с текстами: обсуждение материалов с моделью, заметки и документы в одном интерфейсе.
Обсудите черновик с выбранной моделью и сохраните готовый текст рядом с исходными заметками. Переписка и документы остаются в вашем рабочем пространстве: можно открыть прежний разговор, вернуться к материалу и продолжить работу. Факты из заметки передаются в чат вручную, а полезный ответ сохраняется отдельным документом.
После создания сервера Odysseus разворачивается автоматически из готового официального образа: локальная сборка не нужна. Установка запускает четыре сервиса, создает администратора и открывает приложение по HTTPS на адресе из IP сервера. В проверенном заказе до готовности прошло около восьми минут; время зависит от загрузки пакетов и образов. О начале установки, ее ходе и готовности придут письма.
Что внутри
- Odysseus 1.0.3, сборка
9d0d372 - чат с выбранной моделью, заметки, редактор документов и задачи; переписка и настройки хранятся в SQLite внутри приложения.
- ChromaDB 1.5.9
- хранит векторные индексы приложения; данные вынесены в отдельный том, смонтированный в
/data. - SearXNG
2026.10.24-ef0ec03da - поисковая служба для инструментов Odysseus.
- ntfy 2.32.0
- внутренние уведомления приложения.
- Docker Engine 29.9.2 и Compose 5.6.1
- запускают четыре сервиса с закрепленными образами; приложение слушает
127.0.0.1:7011, внутренний порт -7000. - Caddy
2.6.2-6ubuntu0.24.04.3из Ubuntu 24.04 - открывает приложение по HTTPS, выпускает и автоматически продлевает сертификат Let's Encrypt.
Безопасность
- Администратор создан до открытия приложениялогин
adminполучает пароль сервера; установщик проверяет вход, обход авторизации для localhost выключен. - Регистрация закрытапосторонний не создаст учетную запись, даже зная адрес приложения; попытка регистрации без входа отклоняется.
- fail2ban для SSHпять неудачных попыток входа за десять минут приводят к блокировке адреса на час.
- HTTPS и закрытые внутренние портынаружу приложение доступно через Caddy, а порты Odysseus, ChromaDB, SearXNG и ntfy привязаны к
127.0.0.1. - Пароль не попадает в адрес страницыформа входа отправляет его методом POST, в том числе до загрузки обработчика JavaScript.
- Собственные секретысекрет SearXNG генерируется при установке, файл с реквизитами
/root/odysseus-credentials.txtдоступен только root. - Телеметрия ChromaDB выключенавекторное хранилище не отправляет анонимную статистику использования.
Как войти
Возьмите IPv4 сервера из панели, замените точки на дефисы и добавьте
.fatmetal.net: например, для45.15.156.34адрес будетhttps://45-15-156-34.fatmetal.net. Он также указан в письме о готовности и в подсказке при входе по SSH.Откройте приложение по HTTPS. Логин
admin, пароль - первоначальный пароль этого сервера из личного кабинета Fatmetal, тот же, что для входа по SSH. Администратор уже создан установкой, регистрироваться не нужно.Откройте выбор модели над полем сообщения и нажмите Add Models. В разделе Add API Models выберите своего провайдера, введите API-ключ, нажмите Test, затем Add. Если нужная модель не появилась, обновите страницу и снова откройте выбор модели.
Выберите модель, переключитесь в Chat и отправьте первый запрос. Для работы со своими материалами создайте запись в Notes, перенесите ее факты в сообщение, а ответ сохраните отдельным документом через Library.
Важно
Подключите свой ключ провайдера моделей через Add Models. Расходы на запросы вы оплачиваете провайдеру отдельно; ключ и модель не входят в установку. Прокси Fatmetal к внешним API уже настроен в приложении и входит в VPS без отдельной оплаты. При отправке запроса текст сообщения и переданный вами контекст уходят выбранному провайдеру.
Интерфейс на английском; заметки, запросы и документы с русским текстом сохраняются. Если создаете задачу в Tasks, закройте вкладку Odysseus для ее фонового выполнения: планировщик уступает активной работе в браузере.
Перед хранением важных материалов настройте резервное копирование /opt/odysseus, /etc/odysseus-mp, /etc/caddy/Caddyfile и томов odysseus_chromadb-data, odysseus_searxng-data, odysseus_ntfy-cache. Для согласованной копии сначала остановите стек: cd /opt/odysseus && sudo docker compose stop. После копирования запустите его из того же каталога командой sudo docker compose start. Каталог приложения содержит настройки и ключи вместе с данными - копию храните с ограниченным доступом.
Если установка остановилась, откройте журнал командой sudo tail -n 80 /var/log/odysseus-mp.log: в нем указана причина. Файл /root/odysseus-credentials.txt содержит адрес, реквизиты и подсказки по настройке.
Лицензия
AGPL-3.0-or-later.
Свой домен
Выданным адресом можно пользоваться без собственного домена. Чтобы подключить свой:
- Направьте
A-запись своего домена на публичный IPv4 сервера. - Проверьте адрес:
ping ваш.домендолжен показывать IP сервера. Пока адрес не совпадает, дождитесь обновления DNS. - Подключитесь к серверу по SSH, выполните
sudo nano /etc/odysseus-mp/params.envи задайтеDOMAIN=ваш.домен. - Выполните
sudo bash /opt/odysseus-mp/install.shи дождитесь сообщенияOdysseus readyв/var/log/odysseus-mp.log. Рецепт обновит адрес приложения, а Caddy выпустит сертификат для нового имени; пароль и данные сохранятся. - Откройте
https://ваш.домени войдите какadminс прежним паролем приложения. При установке он равен паролю сервера из личного кабинета Fatmetal.
Требования
Тариф CPU2-RAM4-DISK50 рассчитан на личное рабочее пространство: один пользователь, чат с внешней моделью, заметки и документы. На стенде четыре контейнера занимали 1883 МиБ RAM в простое; наблюдавшийся максимум во время работы - 1932 МиБ. Если планируете одновременно запускать больше инструментов и нужен больший запас памяти, выбирайте CPU4-RAM8-DISK100.