Odysseus
Личный ИИ-ассистент на своем сервере: чат с выбранной моделью, заметки и редактор документов рядом. Развернули 1.0.3 на Fatmetal Cloud Server, замерили память и время запуска, проверили путь от исходной заметки до сохраненного плана.
Вердикт
- автору, который обсуждает черновик с моделью и сохраняет готовый текст рядом с перепиской
- руководителю личного проекта: держать исходные заметки и итоговый план в одном рабочем окне
- пользователю нескольких моделей, которому нужен свой архив рабочих материалов
- для поиска ответов по библиотеке без ручной передачи контекста
- для работы без внешней передачи текста в проверенной конфигурации
- для тех, кому обязательно русское меню
Что это и какую задачу решает
Odysseus - личный ИИ-ассистент на своем сервере: чат с выбранной моделью, короткие заметки и редактор документов в одном интерфейсе.
Notion закрыл доступ пользователям из России. Собственный экземпляр Odysseus дает место для личных заметок и документов, с которыми вы работаете вместе с ИИ.
Это не полная замена базам и командной работе Notion. Доступ к внешней модели и ее оплата остаются отдельным вопросом: понадобятся действующий ключ провайдера и бюджет API.
Нужные факты из заметки вы вручную передаете модели в чате. Итоговый текст можно перенести в редактор, назвать и сохранить отдельным документом, чтобы открыть позже из библиотеки.
Заметки, переписка и документы сохраняются после перезапуска. Вы можете вернуться к исходным сведениям, посмотреть обсуждение и открыть готовый результат, не собирая его заново из сообщений.
Чем отличается от платных аналогов
Сравнивайте отдельные задачи: переписку, документы и хранение материалов. Сумма подписок на разные продукты не превращается в экономию, если вы пользуетесь только одним чатом.
| Вариант | Расходы | Что выбираете |
|---|---|---|
| Odysseus на VPS | 500 ₽/месяц за проверенный тариф, модель отдельно | Свой архив, выбор API, обслуживание сервера |
| Claude Pro | 20 $/месяц в США, API отдельно | Готовый чат и подписочный доступ к моделям |
| Notion Plus / Business | На странице цен: 9,50 € / 19,50 € за место | Документы и совместная работа в облаке вендора |
У Claude стоимость зависит от региона и налогов. Россия отсутствует в списке доступных мест; штатную подписку оформляют из поддерживаемой страны.
В локализованном прайсе Notion указаны карты; показанные суммы не используем для расчета годовых расходов. Дата сверки цен - 28 октября 2026.
VPS оплачивается в рублях. Для выбранной внешней модели понадобится собственный действующий ключ и бюджет API. У Odysseus на стенде английские меню, поэтому русский текст материалов не означает русскую локализацию.
Как устроено хранение
Основное приложение работает на Python и FastAPI. Официальный Compose поднимает рядом ChromaDB, SearXNG и ntfy. Приложение хранит свою SQLite-базу и настройки в каталоге data.
На хосте приложение слушает 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-образ |
| Порт хоста | 7000 | 7011; внутренний порт не меняется |
| Том 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 и файл с доступами.
Рекомендуемая конфигурация:
2 vCPU · 4 ГБ RAM · 50 ГБ NVMe от 585 ₽/мес
Развертывание на Fatmetal Cloud Server
Установите 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Возьмите Compose проверенной сборки
Клонируйте официальный репозиторий и выберите коммит 9d0d372. Его Compose согласован с образом ниже. Сборка приложения из исходников не понадобится.
git clone https://github.com/odysseus-dev/odysseus.git /opt/odysseus cd /opt/odysseus git checkout --detach 9d0d372Задайте домен и создайте пароль
Замените ваш-домен своим именем: его 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Защитите форму входа
В этой сборке форме нужен явный метод 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Подключите исправление и прокси для моделей
Прокси к внешним 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Включите 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.
Откройте Library, создайте документ и перенесите ответ в редактор. Двойным щелчком по названию вкладки задайте понятное имя. Дождитесь Saved, затем откройте документ из библиотеки заново.
Что происходит при работе с материалами
Библиотека приняла Markdown-регламент объемом 247 КиБ за 0,7 секунды. Вместе с копией в сессии, сообщениями и журналом SQLite рабочие данные выросли на 2,3 МиБ.
После этого опыта память контейнеров составила 1927 МиБ. Это полезный ориентир для личных текстовых материалов: в данном сценарии основную память занимает запущенное приложение, а не один импортированный файл.
Страница входа отвечала снаружи примерно за 45 мс. После обычного перезапуска четырех уже подготовленных контейнеров локальный и публичный адреса снова ответили примерно через 26 секунд.
Первое создание контейнера отличается от перезапуска: подготовка файлов может занять несколько минут. Поэтому не переносите время теплого старта на новую установку и ориентируйтесь на журнал приложения.
Проверено на версии v1.0.3, сборка 9d0d372, 28 октября 2026. На новых версиях результаты могут отличаться.
Где может сломаться
Причина. Обработчик формы подключается после нескольких сетевых запросов. До этого браузер использует GET, если метод не указан.
Решение. Копия login-safe.html и монтирование из инструкции задают POST. Если пароль уже попал в адрес, смените его через Settings → Account → Change Password.
Причина. При создании контейнера процесс еще меняет владельцев файлов и готовит приложение. Открытого порта пока нет.
Решение. Выполните docker compose logs -f odysseus, дождитесь запуска Uvicorn и повторите запрос к /login. Не обрывайте работающую подготовку.
Причина. В проверенной сборке копирование передает текст, но теряет название.
Решение. В 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.
Текст не должен покидать ваш сервер
В проверенной конфигурации отправленные сообщения и фрагменты получает внешний провайдер модели. Собственный сервер хранит рабочие материалы, но сам по себе не делает такую обработку изолированной.
Нужна программа с русским меню
Проверенный интерфейс английский, переключателя языка в настройках нет. Если английские названия действий мешают повседневной работе, это существенное ограничение еще до установки.
Частые вопросы
Как узнать, ту ли сборку запустили?
В .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 удобен как личный стол для работы с текстом: заметка дает исходные сведения, чат помогает их обработать, документ сохраняет принятый результат. Начните с одной такой задачи и модели с понятной ценой запроса.
Рекомендуемая конфигурация для установки:
2 vCPU · 4 ГБ RAM · 50 ГБ NVMe
Не хотите устанавливать вручную?
Запустите Odysseus на этой конфигурации автоматически - от 585 ₽/мес.
Этот стек у нас запущен на тарифе CPU2-RAM4-DISK50. Нашли баг в гайде - напишите, поправим в течение дня.