Архивная версия статьи — версия продукта 1.0.3, проверена 28 октября 2026 г.. Инструкции могли устареть.Актуальная статья →
ИИ и языковые модели

Odysseus

Личное рабочее место с ИИ на своем сервере: чат с выбранной моделью, заметки и редактор документов рядом. Развернули 1.0.3 на Fatmetal Cloud Server, замерили память и время запуска, проверили путь от исходной заметки до сохраненного плана.

Проверено на версии v1.0.3, сборка 9d0d372, 28 октября 2026~12 минут чтенияFatmetal Team
Личный ИИ-ассистентAGPL-3.0-or-later4 контейнераДиалог и сохранение проверены

Вердикт

Подходит
  • автору, который обсуждает черновик с моделью и сохраняет готовый текст рядом с перепиской
  • руководителю личного проекта: держать исходные заметки и итоговый план в одном рабочем окне
  • пользователю нескольких моделей, которому нужен свой архив рабочих материалов
Не подходит
  • для поиска ответов по библиотеке без ручной передачи контекста
  • для работы без внешней передачи текста в проверенной конфигурации
  • для тех, кому обязательно русское меню
Рекомендуем: CPU2-RAM4-DISK50Сложность: mediumДо входа: около 9 минутГлавный риск: неверно выбранный контекст моделиПрофиль: один пользователь, внешняя модель
Рабочее место

Что это и какую задачу решает

Odysseus объединяет переписку с моделью, короткие заметки и документы. Когда ответ нужен как рабочий материал, его можно перенести в редактор, назвать и открыть позже из библиотеки.

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

На стенде прошли именно такой путь с учебным проектом «Маяк»: передали факты вручную, получили три пункта плана и сохранили их. Кириллица в заметке, ответе и документе сохранилась.

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

Odysseus: чат с gpt-4o-mini и план учебного проекта по вручную переданным фактам
Дата и ответственная переданы сообщением; модель превратила их в план действий
Сравнение

Чем отличается от платных аналогов

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

ВариантРасходыЧто выбираете
Odysseus на VPS500 ₽/месяц за проверенный тариф, модель отдельноСвой архив, выбор API, обслуживание сервера
Claude Pro20 $/месяц в США, API отдельноГотовый чат и подписочный доступ к моделям
Notion Plus / BusinessНа странице цен: 9,50 € / 19,50 € за местоДокументы и совместная работа в облаке вендора

У Claude стоимость зависит от региона и налогов. Россия отсутствует в списке доступных мест; штатную подписку оформляют из поддерживаемой страны.

Notion ограничивает доступ из России. В его локализованном прайсе указаны карты; показанные суммы не используем для расчета годовых расходов. Дата сверки цен - 28 октября 2026.

VPS оплачивается в рублях. Для выбранной внешней модели понадобится собственный действующий ключ и бюджет API. У Odysseus на стенде английские меню, поэтому русский текст материалов не означает русскую локализацию.

Устройство

Как устроено хранение

Основное приложение работает на Python и FastAPI. Официальный Compose поднимает рядом ChromaDB, SearXNG и ntfy. Приложение хранит свою SQLite-базу и настройки в каталоге data.

Python / FastAPISQLiteChromaDB 1.5.9SearXNG 2026.10.24ntfy 2.32.0Docker Compose

На хосте приложение слушает 127.0.0.1:7011; внутри контейнера остается порт 7000. Caddy принимает запросы по HTTPS и передает их приложению. Вспомогательные порты тоже привязаны к localhost.

Состояние приложения находится в /opt/odysseus/data, журнал - в logs. ChromaDB пишет в именованный том odysseus_chromadb-data, смонтированный в /data. Эти места понадобятся для резервной копии ниже.

Лицензия AGPL-3.0-or-later разрешает запуск своего экземпляра. Если меняете код и предоставляете доступ по сети, учитывайте обязанность предоставить соответствующие исходники пользователям измененной программы.

Новый заход

Что изменилось с прошлого разбора

Номер 1.0.3 остался прежним, но исходники между проверками изменились на 509 коммитов. Поэтому для повторения важен полный тег образа 1.0.3-9d0d372, а не один номер приложения.

МестоРаньшеТеперь
УстановкаЛокальная сборка 934d23cГотовый официальный GHCR-образ
Порт хоста70007011; внутренний порт не меняется
Том ChromaDB/chroma/chroma/data
СтекПрежний набор зависимостейЧетыре сервиса, включая SearXNG и ntfy

Апстрим также добавил проверку адресов внешних моделей против SSRF: запросов к внутренним ресурсам по подставленному адресу. Эти изменения включены в выбранный коммит.

Старый каталог данных не удаляйте при переходе. Особенно проверьте том ChromaDB: прежний путь монтирования не сохраняет данные нынешнего образа. Ниже приведена установка нового экземпляра, без переноса старой базы.

Ресурсы

Какой сервер взять

Для проверенного личного рабочего места берите CPU2-RAM4-DISK50: два ядра, 4 ГБ памяти и 50 ГБ диска. В этой конфигурации модель отвечает через внешний API.

Память контейнеров в простое1883 МиБ
Наблюдавшийся максимум1932 МиБ
Минимальный остаток доступной памяти ОС1359 МиБ
Занято на системном диске7,3 ГиБ
Распакованные образы вместе3,5 ГиБ

Больше всего памяти занимает само приложение: 1756 МиБ в простое. На проверенной машине не было ни нехватки памяти с завершением процессов, ни использования подкачки.

Установка дошла до работающей страницы входа примерно за девять минут. Зарезервируйте время еще на подключение своего ключа и первую задачу; навыки нужны обычные: SSH, редактирование файлов и Docker Compose.

В маркетплейсе Fatmetal

Не хотите ставить руками?

Этот стек есть в маркетплейсе Fatmetal - можно не повторять установку из этого разбора вручную. Заказываете сервер, за пару минут получаете рабочий домен, валидный TLS и файл с доступами.

Рекомендуемая конфигурация: CPU2-RAM4-DISK50

В маркетплейс →
Установка

Развертывание на Fatmetal Cloud Server

  1. Установите Docker и Caddy

    Войдите по SSH, выполните sudo -i и оставайтесь в одной root-сессии. Команды рассчитаны на чистую Ubuntu 24.04 x86-64. Docker берем из его официального репозитория; Caddy будет принимать HTTPS.

    apt-get update
    apt-get install -y ca-certificates curl git caddy
    install -m 0755 -d /etc/apt/keyrings
    curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
    echo 'deb [arch=amd64 signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu noble stable' > /etc/apt/sources.list.d/docker.list
    apt-get update
    apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
    systemctl enable --now docker
  2. Возьмите Compose проверенной сборки

    Клонируйте официальный репозиторий и выберите коммит 9d0d372. Его Compose согласован с образом ниже. Сборка приложения из исходников не понадобится.

    git clone https://github.com/odysseus-dev/odysseus.git /opt/odysseus
    cd /opt/odysseus
    git checkout --detach 9d0d372
  3. Задайте домен и создайте пароль

    Замените ваш-домен своим именем: его A-запись должна указывать на IPv4 сервера. Уберите ошибочную AAAA-запись, откройте входящие TCP 80 и 443. Не закрывайте SSH. Пароль сохранится в файле, доступном только root.

    DOMAIN=ваш-домен
    ADMIN_PASSWORD=$(openssl rand -hex 24)
    umask 077
    printf 'Admin user: admin\nAdmin passphrase: %s\n' "$ADMIN_PASSWORD" > /root/odysseus-credentials.txt
    cat > .env <<ENV
    ODYSSEUS_IMAGE=ghcr.io/odysseus-dev/odysseus:1.0.3-9d0d372
    APP_BIND=127.0.0.1
    APP_PORT=7011
    AUTH_ENABLED=true
    LOCALHOST_BYPASS=false
    ODYSSEUS_ADMIN_USER=admin
    ODYSSEUS_ADMIN_PASSWORD=$ADMIN_PASSWORD
    SEARXNG_SECRET=$(openssl rand -hex 32)
    ALLOWED_ORIGINS=https://$DOMAIN
    SECURE_COOKIES=true
    OAUTH_REDIRECT_BASE_URL=https://$DOMAIN
    ODYSSEUS_TTS_CACHE_MAX_BYTES=524288000
    ENV
  4. Защитите форму входа

    В этой сборке форме нужен явный метод POST: иначе ранний клик по Sign In может отправить пароль в адресной строке. Создайте отдельную исправленную копию, чтобы не менять исходный файл.

    sed 's/<form id="authForm" autocomplete="on">/<form id="authForm" autocomplete="on" method="post">/' static/login.html > config/login-safe.html
    chmod 644 config/login-safe.html
  5. Подключите исправление и прокси для моделей

    Прокси к внешним API входит в VPS Fatmetal: отдельно его заказывать не надо. NO_PROXY оставляет внутренние обращения к соседним контейнерам прямыми. Провайдера и ключ модели выбираете вы.

    cat > compose.override.yml <<'COMPOSE'
    services:
      odysseus:
        volumes:
          - ./config/login-safe.html:/app/static/login.html:ro
        environment:
          HTTPS_PROXY: http://api-proxy.fatmetal.net:8080
          HTTP_PROXY: http://api-proxy.fatmetal.net:8080
          NO_PROXY: localhost,127.0.0.1,10.0.0.0/8,172.16.0.0/12,odysseus,chromadb,searxng,ntfy,host.docker.internal
    COMPOSE
  6. Включите HTTPS и запустите контейнеры

    Caddy получит сертификат для указанного имени. Compose автоматически прочитает compose.override.yml; флаг --no-build запрещает случайно начать локальную сборку вместо готового образа.

    printf '%s {\n encode zstd gzip\n reverse_proxy 127.0.0.1:7011\n}\n' "$DOMAIN" > /etc/caddy/Caddyfile
    systemctl enable --now caddy
    systemctl reload caddy
    docker compose pull
    docker compose up -d --no-build
    docker compose ps

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

cd /opt/odysseus
docker compose logs --tail=80 odysseus
curl -fsS -o /dev/null -w '%{http_code}\n' https://ваш-домен/login

Ответ 200 по HTTPS означает, что можно открыть адрес в браузере. Для входа используйте admin и пароль из sudo cat /root/odysseus-credentials.txt. Сам файл не публикуйте.

Первая задача

Подключите модель и сохраните результат

Откройте Settings → Add Models, выберите провайдера и введите свой ключ. На стенде использовали OpenRouter: адрес https://openrouter.ai/api/v1, кнопки Test и Add.

В списке моделей явно выберите openai/gpt-4o-mini через поиск. Не отправляйте первый запрос с автоматически выбранной моделью: после подключения приложение может выбрать дорогую позицию из списка.

Через Notes создайте заметку с датой, ответственным и задачами. Для примера: запуск «Маяка» 15 ноября, отвечает Анна; до старта нужны резервная копия и оповещения.

Скопируйте эти сведения в новый чат, включите Chat и попросите три пункта плана. На стенде полный ответ пришел за 4,4 секунды; стоимость и скорость зависят от выбранного API.

Заметка с вымышленными исходными данными Маяка рядом с чатом Odysseus
Notes хранит исходные сведения отдельно от переписки

Откройте Library, создайте документ и перенесите ответ в редактор. Двойным щелчком по названию вкладки задайте понятное имя. Дождитесь Saved, затем откройте документ из библиотеки заново.

Редактор Odysseus: сохраненный план запуска Маяка рядом с ответом модели
Итоговый план сохранен как отдельный документ, а не только сообщение
Замеры

Что происходит при работе с материалами

Библиотека приняла Markdown-регламент объемом 247 КиБ за 0,7 секунды. Вместе с копией в сессии, сообщениями и журналом SQLite рабочие данные выросли на 2,3 МиБ.

После этого опыта память контейнеров составила 1927 МиБ. Это полезный ориентир для личных текстовых материалов: в данном сценарии основную память занимает запущенное приложение, а не один импортированный файл.

Страница входа отвечала снаружи примерно за 45 мс. После обычного перезапуска четырех уже подготовленных контейнеров локальный и публичный адреса снова ответили примерно через 26 секунд.

Первое создание контейнера отличается от перезапуска: подготовка файлов может занять несколько минут. Поэтому не переносите время теплого старта на новую установку и ориентируйтесь на журнал приложения.

Библиотека Odysseus с поиском Маяк: импортированный регламент и сохраненный план
Штатный поиск в Library находит сохраненные материалы по названию

Проверено на версии v1.0.3, сборка 9d0d372, 28 октября 2026. На новых версиях результаты могут отличаться.

Грабли

Где может сломаться

Sign In отправляет пароль в URL

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

Решение. Копия login-safe.html и монтирование из инструкции задают POST. Если пароль уже попал в адрес, смените его через Settings → Account → Change Password.

Контейнер Running, но Caddy показывает 502

Причина. При создании контейнера процесс еще меняет владельцев файлов и готовит приложение. Открытого порта пока нет.

Решение. Выполните docker compose logs -f odysseus, дождитесь запуска Uvicorn и повторите запрос к /login. Не обрывайте работающую подготовку.

После Copy to Session документ называется Untitled

Причина. В проверенной сборке копирование передает текст, но теряет название.

Решение. В Library раскройте карточку и нажмите Open, затем переименуйте активную вкладку двойным щелчком и дождитесь Saved.

Эксплуатация

Резервная копия и восстановление

Останавливайте весь стек на время копирования: SQLite использует дополнительные файлы журнала, а ChromaDB хранится отдельно. Архив включает настройки, ключи приложения и все три именованных тома.

cd /opt/odysseus
docker compose stop
tar -czf /root/odysseus-backup.tgz -C / \
  opt/odysseus/data opt/odysseus/logs opt/odysseus/config \
  opt/odysseus/.env opt/odysseus/docker-compose.yml opt/odysseus/compose.override.yml \
  etc/caddy/Caddyfile var/lib/docker/volumes/odysseus_chromadb-data/_data \
  var/lib/docker/volumes/odysseus_searxng-data/_data \
  var/lib/docker/volumes/odysseus_ntfy-cache/_data
docker compose start

Храните архив вне этой машины с закрытым доступом: в нем есть секреты. Восстановление ниже заменяет текущее состояние на снимок; выполняйте его на той же сборке и с прежними именами томов.

cd /opt/odysseus
docker compose stop
tar --recursive-unlink -xzf /root/odysseus-backup.tgz -C /
docker compose up -d --no-build
systemctl reload caddy

Для новой машины сначала повторите установку этой сборки, затем остановите контейнеры и восстановите архив. Если меняете домен, исправьте DOMAIN-зависимые адреса в .env и имя в /etc/caddy/Caddyfile до запуска.

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

Поддержка

Как повторно развернуть проверенную сборку

Один номер 1.0.3 не определяет содержимое образа: апстрим публикует разные сборки с тем же номером. Оставляйте суффикс коммита в ODYSSEUS_IMAGE, чтобы запуск был воспроизводимым.

cd /opt/odysseus
docker compose pull
docker compose up -d --no-build
docker compose ps
docker compose logs --tail=80 odysseus

Эти команды повторно запускают закрепленную сборку. Перед переходом на другой тег сделайте копию, возьмите соответствующий ему Compose и заново проверьте исправление формы входа.

Не заменяйте один лишь образ на latest: рядом лежат конфигурация SearXNG и скрипт ее подготовки из той же версии репозитория. Для отката нужны и прежние файлы, и копия данных.

  • Caddy принимает публичный HTTPS; приложение и базы остаются на localhost.
  • Внешний API модели подключается через Settings; его ключ не нужно вписывать в общедоступный Compose.
  • Резервный архив сохраняет материалы и конфигурацию вместе, чтобы пересоздание контейнеров не стало потерей рабочего места.
Ограничения

Когда это НЕ ваш выбор

Нужны ответы по всей библиотеке без ручной подготовки

Открытый регламент сам не стал надежным контекстом: модель выдумала даты и ответственного. Выделение текста вызвало запрос разрешения на правку. Точные ответы получили, вручную передав нужный фрагмент в новый Chat.

Текст не должен покидать ваш сервер

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

Нужна программа с русским меню

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

FAQ

Частые вопросы

Как узнать, ту ли сборку запустили?

В .env должен стоять тег 1.0.3-9d0d372. На стенде /api/version показывает version 1.0.3 и build 0.20.19; номер на экране входа относится к build.

Где взять пароль при первом входе?

На сервере выполните sudo cat /root/odysseus-credentials.txt. Пользователь - admin; пароль генерируется командами установки, общего пароля для всех экземпляров нет.

Где лежат заметки и история?

В /opt/odysseus/data. Сохраняйте весь каталог, включая скрытые файлы и журналы SQLite, вместе с конфигурацией и томами из команды резервного копирования.

Как сохранить ответ отдельным материалом?

Создайте документ в Library, вставьте текст ответа, переименуйте вкладку и дождитесь Saved. Проверка сохранения - повторно открыть его из Library.

Оплата сервера включает запросы к модели?

Прокси к внешним API входит в VPS. Расход выбранной модели оплачивается отдельно по условиям провайдера; ее ключ добавляется через Settings → Add Models.

Итог

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

Анонсы новых разборов в Telegram-канале Новые гайды и карточки в маркетплейсе первыми @fatmetal_channel →

Этот стек у нас запущен на тарифе CPU2-RAM4-DISK50. Нашли баг в гайде - напишите, поправим в течение дня.