SSD Nodes Learn Hosting plans →
Руководства Matt ConnorАвтор: Matt Connor

Как развернуть Octop на своем сервере через Docker

Пошаговое руководство по установке Octop версии v0.9.19 на VPS. Настройте многопользовательский доступ, TLS и OpenAI API без использования небезопасных curl-скриптов.

Что такое Octop и зачем его размещать на собственном сервере

Octop — это AI-ассистент для домашнего использования или небольшой команды, который вы размещаете на собственном сервере. Причина выбора Octop вместо обычного чат-интерфейса заключается в изоляции пользователей друг от друга. Open WebUI предоставляет браузерный интерфейс для работы с моделью, а также поддерживает многопользовательский режим и контроль доступа. Octop объединяет учетные записи с ролью администратора, личным рабочим пространством и набором учетных данных для каждого пользователя, а также библиотекой специализированных агентов, между которыми пользователь может переключаться в зависимости от задачи. Именно это отличие позволяет одному VPS обслуживать пять человек вместо одного.

Проект находится по адресу github.com/TencentCloud/Octop. Это единый процесс, который предоставляет веб-панель управления, интерфейс командной строки, чат-каналы (Feishu, DingTalk, QQ, Discord, WeCom) и планировщик заданий, работающие на базе одной базы данных SQLite в ~/.octop/. Все инструкции ниже написаны для версии v0.9.19, выпущенной 5 августа 2026 года. Если вы все еще выбираете между платформами, сравнение альтернатив Open WebUI для запуска на VPS охватывает более широкий спектр решений.

Важный момент, который стоит прояснить, прежде чем тратить вечер на настройку. На момент написания этого руководства Octop был программным обеспечением версии до 1.0, опубликованным организацией-разработчиком на GitHub. С тех пор 14 сентября 2026 года был выпущен релиз v1.0.0, а по состоянию на 20 ноября 2026 года новейшим тегом является v1.0.3b7, опубликованный 18 ноября 2026 года; репозиторий набрал около 12 300 звезд. Последним стабильным релизом остается v1.0.2, опубликованный 18 октября 2026 года. Приведенные ниже шаги написаны для версии v0.9.19 и не были повторно протестированы на ветке 1.x. Проект развивается быстро, о чем говорят номера версий, и ничто из написанного здесь не является гарантией стабильного пути обновления. Фиксируйте версию (тег), читайте список изменений и делайте резервные копии.

Что необходимо перед началом работы

  • VPS под управлением Ubuntu 24.04 с установленными Docker Engine и плагином Compose. Если вы не знакомы с Compose, начните с основ Docker Compose для VPS.
  • git, так как вы будете клонировать конкретный релиз, а не загружать готовый образ.
  • Доменное имя, указывающее на ваш VPS, так как вам потребуется TLS (transport layer security) перед этим сервисом.
  • Бэкенд модели, поддерживающий API OpenAI: локальный Ollama, self-hosted шлюз или платный ключ доступа.

Сам по себе Octop потребляет мало ресурсов. Это Python-процесс и файл SQLite. Основная нагрузка ложится на бэкенд модели, поэтому, если вы планируете запускать модель на том же сервере, подбирайте конфигурацию оборудования с учетом требований модели.

Почему мы не рекомендуем установщик curl

В файле README версии v0.9.19 первым делом предлагается установка одной командой:

curl -fsSL https://finnie-1258344699.cos.ap-guangzhou.myqcloud.com/octop/install.sh | bash

Мы не рекомендуем передавать вывод команды напрямую в bash на сервере, который вам дорог. Репозиторий содержит scripts/install.sh, поэтому эта копия имеет историю git и защищена тегом. Копия, предоставляемая из бакета Tencent Cloud Object Storage, не зафиксирована в приведенной выше команде. Бакет может завтра отдавать другие байты, а команда всё равно их выполнит. Передача результата напрямую в bash также означает, что машина выполнит скрипт до того, как вы прочитаете хотя бы строку.

Установщик также вносит изменения непосредственно в хост, а не в контейнер. Он использует uv для загрузки Python 3.12 и создания окружения, о котором ваш менеджер пакетов ничего не знает, поэтому последующее удаление будет ручной задачей.

Есть два варианта лучше. Загрузите скрипт, прочитайте его, а затем запустите — это займет у вас тридцать секунд: curl -fsSL <url> -o install.sh, затем less install.sh, затем bash install.sh. Либо используйте Docker, которому посвящена остальная часть этого руководства. Пакет PyPI (pip install octop) — это как минимум версионированный артефакт, который можно зафиксировать на конкретном релизе.

Развертывание Octop с помощью Docker Compose, фиксация версии v0.9.19

Файл Compose, поставляемый в версии v0.9.19, собирает образ из репозитория, поэтому в данном руководстве фиксация версии означает переключение на git-тег. Опубликованные образы существуют. В дереве v0.9.19 уже присутствует рабочий процесс docker-publish.yml, добавленный в версии v0.9.8 от 15 июля 2026 года, который собирает образ и отправляет его в Docker Hub для каждого тега v*. На 20 октября 2026 года проект также публикует образы в реестре контейнеров GitHub (docker pull ghcr.io/tencentcloud/octop:1.0.2). Сборка из проверенного тега является более строгой фиксацией, так как вы компилируете именно тот код, который видите, не полагаясь на тег в реестре. Это требует на один шаг больше, чем большинство self-hosted проектов, поскольку, например, self-hosted рабочее пространство AFFiNE фиксируется на теге опубликованного образа и ничего не собирает на вашем VPS. Процедура клонирования, переключения на тег и сборки, описанная ниже, идентична той, что приведена в руководстве по развертыванию openGym, поэтому, если вы уже выполняли её однажды, структура вам знакома.

git clone https://github.com/TencentCloud/Octop.git
cd Octop
git checkout v0.9.19

Ниже представлен сервис, определенный в файле, с сокращениями до значимых частей:

services:
  octop:
    build:
      context: ..
      dockerfile: docker/Dockerfile
    image: octop:latest
    container_name: octop
    restart: unless-stopped
    ports:
      - "${OCTOP_PORT:-8088}:${OCTOP_PORT:-8088}"
    volumes:
      - ${OCTOP_DATA:-~/.octop}:/data/.octop
    environment:
      - HOME=/data
      - OCTOP_BIND_HOST=0.0.0.0
      - OCTOP_PORT=${OCTOP_PORT:-8088}
      - OCTOP_DEFAULT_PASSWORD=${OCTOP_DEFAULT_PASSWORD:-octop}
      - OCTOP_ADMIN_USERNAME=${OCTOP_ADMIN_USERNAME:-admin}
      - OPENAI_API_KEY=${OPENAI_API_KEY:-}

Обратите внимание на блок build:. image: octop:latest — это имя, которое получает ваша собственная сборка, а не ссылка на реестр, поэтому latest здесь означает то, что вы скомпилировали в последний раз. Укажите путь к данным явно, а не оставляйте его по умолчанию, и задайте пароль для учетной записи администратора до первого запуска. Поместите это в docker/.env:

OCTOP_PORT=8088
OCTOP_ADMIN_USERNAME=admin
OCTOP_DEFAULT_PASSWORD=<a long random password>
OCTOP_DATA=/srv/octop-data

Одна ловушка здесь важнее, чем весь остальной файл. Compose считывает docker/.env только для подстановки плейсхолдеров ${...} в YAML. Ключ, который вы добавляете в этот файл, не попадет в контейнер, если он также не указан в разделе environment: в файле Compose. Добавление OCTOP_ACCESS_TOKEN_TTL только в .env не даст никакого эффекта, причем без вывода ошибок. Альтернатива — записать те же ключи в ~/.octop/env внутри смонтированной директории с данными, которые Octop загружает при старте. В руководстве по env-файлам и секретам в Docker Compose подробно объясняется, почему эти два механизма не являются одним и тем же.

Соберите и запустите проект:

docker compose -f docker/docker-compose.yml up -d --build
docker compose -f docker/docker-compose.yml ps
curl http://127.0.0.1:8088/api/health

Исправный экземпляр отвечает на проверку работоспособности (health check) JSON-объектом вида {"ok":true,"started_at":...,"db":...,"users_loaded":0,"agents_running":0}. Если ответ иной, изучите docker compose -f docker/docker-compose.yml logs -f octop, прежде чем открывать браузер.

Теперь присвойте собранному образу осмысленное имя, так как следующий --build перезапишет octop:latest, и вы не сможете их различить:

docker image tag octop:latest octop:0.9.19

При первом запуске выполняется octop init, и начальные учетные данные записываются в том данных:

docker exec -it octop cat /data/.octop/credential.txt

Значения по умолчанию — admin / octop, и они применяются только при первой инициализации. Это механизм, объясняющий вопрос, который задают постоянно: изменение OCTOP_DEFAULT_PASSWORD после того, как контейнер уже был запущен, ничего не меняет, так как учетная запись уже существует. Измените пароль в панели управления.

Не публикуйте порт 8088

Строка ports: выше привязывает контейнер ко всем сетевым интерфейсам VPS. В момент запуска контейнера панель управления оказывается доступна из публичного интернета в открытом виде. Значение по умолчанию OCTOP_BIND_HOST в Octop — 127.0.0.1; файл Compose переопределяет его на 0.0.0.0, так как процесс должен принимать трафик извне своего сетевого пространства имен. Это переопределение корректно. Именно публикация порта делает сервис доступным извне.

Отредактируйте строку ports: в файле docker/docker-compose.yml, чтобы привязка осуществлялась только к loopback-интерфейсу:

    ports:
      - "127.0.0.1:${OCTOP_PORT:-8088}:${OCTOP_PORT:-8088}"

Не пытайтесь исправить это с помощью обычного файла переопределения. Compose объединяет списки ports из нескольких файлов, а не заменяет их, поэтому в итоге вы получите публикацию обоих портов, и второй не сможет занять адрес. Если вы хотите оставить исходный файл без изменений, используйте тег !override для последовательности — это документированный способ замены, а не добавления. В пояснении о том, как Compose объединяет несколько файлов описаны остальные правила слияния.

Привязка к loopback также решает проблему, с которой вы иначе столкнулись бы при настройке межсетевого экрана. Docker записывает правила для опубликованных портов в таблицу nat перед цепочками, которыми управляет ufw, поэтому ufw deny 8088 не блокирует опубликованный порт контейнера. В Docker Engine версии 28.0.0 и новее порт, привязанный к 127.0.0.1, недоступен извне независимо от настроек ufw, поэтому данный метод является правильным решением, а не компромиссным. Более старые версии Engine позволяют хостам в том же L2-сегменте (например, другим машинам на коммутаторе вашего провайдера) обращаться к портам, опубликованным на localhost, поэтому выполните docker version и обновитесь, если сервер сообщает о версии ниже 28.

Настройка TLS с помощью обратного прокси-сервера

Caddy — самый простой путь, так как он самостоятельно запрашивает сертификат через ACME (automatic certificate management environment) и проксирует WebSockets без дополнительной настройки:

octop.example.com {
    reverse_proxy 127.0.0.1:8088
}

nginx требует более тщательной настройки, так как Octop передает чат через WebSocket:

server {
    listen 443 ssl;
    server_name octop.example.com;

    ssl_certificate     /etc/letsencrypt/live/octop.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/octop.example.com/privkey.pem;

    location / {
        proxy_pass http://127.0.0.1:8088;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        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 3600s;
    }
}

Каждая строка здесь выполняет свою задачу. Чат работает через WS /api/agents/{id}/chat/ws, поэтому nginx должен пересылать два заголовка upgrade и использовать HTTP/1.1 для апстрима; proxy_http_version 1.1 делает это явно и необходимо для версий nginx до 1.29.7. Без успешного обновления (upgrade) панель управления загружается нормально, но чат не может подключиться; версия v0.9.19 завершает состояние потоковой передачи после неудачного рукопожатия, вместо того чтобы оставлять сообщение «висеть» бесконечно. proxy_buffering off важен, так как эндпоинт возобновления с участием человека возвращает text/event-stream, а SSE (server-sent events), удерживаемые в буфере прокси, приходят одним пакетом в конце вместо потоковой передачи. proxy_read_timeout учитывает длительные паузы без данных от апстрима: значение по умолчанию в 60 секунд может привести к разрыву WebSocket и записи в лог upstream timed out (110: Connection timed out), но версия v0.9.19 продолжает выполнение задачи агента после разрыва соединения. Явная отмена останавливает задачу.

Как работает JWT-аутентификация за прокси

Octop выполняет аутентификацию с помощью bearer-токена, а не cookie. POST /api/auth/login возвращает {access_token, token_type, expires_in, user}, а последующие вызовы содержат Authorization: Bearer <access_token>. Для reverse proxy это преимущество: нет домена cookie, флага Secure или правила SameSite, которые можно настроить неверно, поэтому сессия, работающая на http://127.0.0.1:8088, ведет себя так же на https://octop.example.com.

Перед тем как предоставлять доступ реальным пользователям, стоит учесть два последствия.

WebSocket передает токен в URL. Конечная точка — WS /api/agents/{id}/chat/ws?token=<jwt>, так как JavaScript в браузере не может установить заголовок Authorization при рукопожатии WebSocket. TLS защищает этот токен при передаче. Однако он не защищает его от ваших собственных логов: по умолчанию nginx записывает полную строку запроса, включая строку параметров, в access_log, поэтому рабочий токен реального пользователя попадает в текстовый файл на сервере. Логируйте путь без аргументов. $uri — это нормализованный путь с уже удаленной строкой параметров, поэтому добавьте его в блок http и ссылайтесь на него из конфигурации сервера:

log_format octop_noargs '$remote_addr [$time_local] '
                        '"$request_method $uri $server_protocol" '
                        '$status $body_bytes_sent';
access_log /var/log/nginx/octop.log octop_noargs;

Выход из системы не отзывает токен в версии v0.9.19. OCTOP_ACCESS_TOKEN_TTL по умолчанию равен 86400, поэтому токен остается действительным в течение 24 часов после входа. Единственный документированный способ аннулировать его — octop admin rotate-jwt-secret, который обновляет ключ подписи, хранящийся в ~/.octop/secrets/jwt_secret, и немедленно делает недействительными все существующие токены для всех пользователей. Поэтому, когда кто-то покидает команду, порядок действий следующий: удалите пользователя, обновите секрет, а затем попросите остальных пользователей войти снова. Если это кажется слишком сложным, сократите время жизни токена, не забыв добавить переменную в список environment:, а также в .env:

OCTOP_ACCESS_TOKEN_TTL=28800

Защита от перебора реализована: OCTOP_LOGIN_MAX_ATTEMPTS по умолчанию допускает 5 неудачных попыток, а OCTOP_LOGIN_LOCKOUT_SECONDS составляет 900 секунд, поэтому заблокированный пользователь просто ждет пятнадцать минут, а не сталкивается с нерабочей установкой. У Octop есть собственное хранилище пользователей, и в версии v0.9.19 нет документированной поддержки OIDC, поэтому, если вам нужен полноценный single sign-on, установите перед ним аутентифицирующий прокси, для чего предназначен самостоятельно развернутый сервер Authentik. Встроенная поддержка OIDC появилась в версии v0.9.24 от 15 августа 2026 года.

Настройка Octop для работы с бэкендом моделей

Провайдеры настраиваются для каждого агента в панели управления, а octop provider list показывает текущие параметры. Octop поставляется с предустановками для API, совместимых с OpenAI, DashScope (Qwen) и Ollama. Учетные данные хранятся в таблице providers вашей собственной базы данных SQLite. Выбор провайдера влияет на стоимость использования и на то, какие данные покидают ваш сервер.

Локальная модель с Ollama. Данные не покидают сервер, а платой за использование становится оперативная память, а не токены. Важный нюанс: контейнер не может обратиться к Ollama на хосте по адресу 127.0.0.1:11434, так как этот адрес является loopback-интерфейсом самого контейнера. Добавьте запись host gateway в сервис:

    extra_hosts:
      - "host.docker.internal:host-gateway"

Затем установите базовый URL провайдера на http://host.docker.internal:11434/v1 — это путь Ollama, совместимый с OpenAI. В поле API key введите любую непустую строку: Ollama игнорирует это поле, но клиенты OpenAI не отправляют запросы с пустым ключом. Чтобы это заработало, Ollama должна принимать соединения не только через loopback, что требует установки OLLAMA_HOST=0.0.0.0:11434 в юните systemd. Это создает риски: локальный API Ollama не требует аутентификации, поэтому открытый порт 11434 на публичном IP-адресе делает ваш сервер доступным для любого, кто его просканирует. Разрешите доступ только из частной подсети Docker sudo ufw allow from 172.16.0.0/12 to any port 11434 proto tcp, а остальные запросы блокируйте. В статье Запуск Ollama на VPS описан подбор размера моделей, а в сравнении Ollama и vLLM указано, когда Ollama перестает быть оптимальным решением.

Еще одно предупреждение касательно локальных моделей: ситуация, которая выглядит как ошибка в Octop, на самом деле ею не является. Агенты работают через вызов инструментов, поэтому системный промпт, определения инструментов и история переписки формируют большой объем данных. Размер контекстного окна Ollama по умолчанию теперь зависит от VRAM: 4k при объеме менее 24 GiB, 32k при объеме от 24 GiB до менее 48 GiB и 256k при объеме 48 GiB и более. Текущие рекомендации советуют использовать не менее 64 000 токенов для агентов и инструментов разработки. Установите num_ctx так, чтобы рабочая нагрузка соответствовала поддерживаемому контексту модели и доступной памяти, а также выберите модель, которая эффективно справляется с вызовом функций. Если ответ обрывается на полуслове — это другая проблема, связанная с настройкой num_predict. Если ответы приходят обрезанными, стоит проверить, где задан num_predict и что сообщает done_reason, прежде чем винить агента. Если вы хотите начать с конкретной модели, а не с короткого списка, попробуйте Nemotron 3.5 Lightning; в этом руководстве указан точный тег для загрузки, требования к RAM и информация о том, справится ли система только на CPU.

Самостоятельно развернутый шлюз. Установите самостоятельно развернутый шлюз LiteLLM между Octop и остальными сервисами. Вы получите единый базовый URL, отдельные ключи для каждого пользователя, лимиты расходов и централизованный лог. Вы также сможете менять модель на бэкенде, не внося изменений в Octop.

Платный API. Обеспечивает наилучшее качество, но требует компромисса: содержание диалогов покидает ваш сервер и передается провайдеру, что противоречит основной цели самостоятельного хостинга. Ключ вводится в docker/.env как OPENAI_API_KEY, что уже предусмотрено в файле Compose.

Независимо от выбора, файл Compose также передает OCTOP_LANGFUSE_ENABLED, LANGFUSE_PUBLIC_KEY, LANGFUSE_SECRET_KEY и LANGFUSE_BASE_URL. Это позволяет отправлять трассировки в ваш собственный экземпляр Langfuse и видеть реальные действия агентов, а не пытаться угадать их по окну чата.

Пользователи, роли и общая библиотека агентов

Учетная запись администратора, созданная при первом запуске, управляет остальными пользователями. Каждый пользователь получает собственные агенты, рабочее пространство и учетные данные; изоляция обеспечивается токеном, который хранится в браузере. В системе также присутствуют предустановленные экспертные шаблоны и пакеты навыков уровня экземпляра. Возможность делиться своими агентами с другими пользователями появилась в версии v0.9.24, которая вышла позже указанной здесь версии.

Соблюдайте осторожность при работе с инструментами. Octop поддерживает подтверждение использования инструментов и защитные механизмы для команд оболочки. Эти функции работают, однако агент, выполняющий команды shell, запускает их внутри контейнера Octop, к которому подключен ваш том с данными. Защитные механизмы ограничивают последствия неосторожных запросов. Они не являются полноценной «песочницей», поэтому оставляйте подтверждение использования инструментов включенным для всех, кому вы не доверили бы прямой доступ к командной оболочке. Если вы сравниваете это решение с другими, обзор self-hosted AI агентов поможет понять, как каждый из них решает подобные задачи.

Обновление проекта с высокой частотой релизов

ГрафикDays between Octop releases, v0.9.16 to v0.9.19 (repository tags, 7 August 2026)
Данные, на которых построен график
[
  {
    "version": "v0.9.16",
    "days_since_previous_release": 2
  },
  {
    "version": "v0.9.17",
    "days_since_previous_release": 3
  },
  {
    "version": "v0.9.18",
    "days_since_previous_release": 1
  },
  {
    "version": "v0.9.19",
    "days_since_previous_release": 3
  }
]

Это даты тегов из репозитория по состоянию на 7 августа 2026 года. За девять дней было выпущено 4 релизов, при этом минимальный интервал между ними составил 1 день, а версия v0.9.19 вышла через 3 дня после предыдущего тега. Такая частота — хороший показатель для проекта, но плохой повод для запуска latest. Изучите изменения перед их применением:

cd Octop
git fetch --tags
git tag --sort=-creatordate | head
NEW_TAG=$(git tag --sort=-creatordate | head -1)
git log --oneline "v0.9.19..$NEW_TAG"

Проверьте, что именно содержит $NEW_TAG, прежде чем переключаться на него, так как проект помечает бета-версии (например, v1.0.2b9) наравне со стабильными релизами. По состоянию на 20 ноября 2026 года новейшим тегом является v1.0.3b7, опубликованный 18 ноября 2026 года; последним стабильным релизом остается v1.0.2, опубликованный 18 октября 2026 года. Переход с v0.9.19 включает в себя релиз v1.0.0 от 14 сентября 2026 года, поэтому лог изменений велик и требует внимательного прочтения.

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

docker compose -f docker/docker-compose.yml stop
sudo tar czf octop-backup-$(date +%F).tgz -C /srv octop-data
docker compose -f docker/docker-compose.yml start

Затем переключитесь на новый тег и выполните пересборку с помощью docker compose -f docker/docker-compose.yml up -d --build. Если что-то пойдет не так, возврат к старому тегу и пересборка восстановят код, но только архив с резервной копией позволит восстановить базу данных.

Этот архив содержит octop.db, config.json, секретный ключ для подписи JWT и credential.txt, поэтому он так же критически важен, как и сам сервер. Установите для него права доступа 600 и храните копию вне сервера. Для более крупных инсталляций проект также поставляет docker/docker-compose.postgres.yml, который использует PostgreSQL с расширением pgvector вместо SQLite.

Режимы сбоев и соответствующие им сообщения

Проверка работоспособности не дает ответа. curl http://127.0.0.1:8088/api/health зависает или выдает отказ. Ознакомьтесь с docker compose -f docker/docker-compose.yml logs -f octop. Контейнер, который завершает работу во время первой инициализации, обычно не может записать данные в каталог; проверьте права доступа к пути, который вы указали в OCTOP_DATA.

Панель управления загружается, но чат не подключается. Ошибка при установке соединения WebSocket прерывает потоковую передачу в версии v0.9.19. Откройте консоль браузера и найдите неудачное подключение к wss://octop.example.com/api/agents/.../chat/ws. Убедитесь, что прокси-сервер корректно передает запрос на обновление соединения. Добавьте proxy_http_version 1.1, а также заголовки Upgrade и Connection.

Весь ответ появляется сразу, с задержкой в несколько секунд. Потоковая передача работает, но включена буферизация. Установите proxy_buffering off.

bind: address already in use. Порт 8088 уже занят другим процессом. sudo ss -tlnp | grep 8088 укажет, какой именно процесс его использует. Эта же ошибка возникает, если вы добавили вторую запись ports в файл переопределения вместо редактирования исходного файла.

Верный пароль отклоняется. Пять неудачных попыток приводят к блокировке на 900 секунд. Дождитесь окончания блокировки вместо переустановки.

Новый пароль в .env не применился. Эти учетные данные используются только при первой инициализации. Измените пароль в панели управления.

Агент отвечает, но не запускает инструменты. Проверьте выделение контекста для локальной модели и поддержку вызова функций (function calling). Ollama теперь рекомендует выделять не менее 64,000 токенов для задач агента; выберите модель и объем памяти, которые соответствуют этим требованиям.

FAQ

Является ли Octop заменой Open WebUI?

Только если вам нужны функции, которые он добавляет. Open WebUI также поддерживает работу с несколькими пользователями, ролями и управлением доступом. Octop объединяет учетные записи с ролью администратора, рабочие пространства и учетные данные для каждого пользователя, а также переключаемую библиотеку специализированных агентов, поэтому несколько человек могут использовать один сервер, не разделяя общую историю. Если вам достаточно одной учетной записи, Open WebUI — более простой и зрелый выбор.

Почему не стоит использовать скрипт установки Octop через curl?

Команда в одну строку для версии v0.9.19 загружает скрипт из бакета Tencent Cloud Object Storage без привязки его содержимого к git-тегу или коммиту. В репозитории есть версионная копия по адресу scripts/install.sh, но передача удаленной копии в bash запускает её до того, как вы успеете прочитать код. Кроме того, скрипт устанавливает ПО на хост в собственное окружение Python 3.12, минуя ваш системный менеджер пакетов. Сначала скачайте и изучите скрипт или разверните приложение с помощью Docker Compose из проверенного тега.

Может ли Octop использовать локальную модель вместо платного API?

Да. Octop поддерживает API, совместимые с OpenAI, и содержит предустановку для Ollama, поэтому указание на http://host.docker.internal:11434/v1 будет работать после добавления extra_hosts: ["host.docker.internal:host-gateway"] в контейнер и настройки OLLAMA_HOST=0.0.0.0:11434 на хосте. Настройте брандмауэр на порт 11434 для диапазона адресов Docker, так как локальный API Ollama не требует аутентификации. Проверьте выделенное окно контекста: значения по умолчанию в Ollama теперь зависят от объема VRAM, а текущие рекомендации советуют использовать не менее 64,000 токенов для рабочих нагрузок агентов в пределах поддерживаемого моделью контекста и доступной памяти.

Нужен ли мне reverse proxy или можно открыть порт 8088?

Вам нужен прокси. Файл Compose, поставляемый с Octop, публикует порт 8088 на всех интерфейсах без TLS, поэтому пароли и bearer-токены будут передаваться через интернет в открытом виде. Измените опубликованный порт на 127.0.0.1:8088:8088 и установите перед ним Caddy или nginx с сертификатом. В nginx настройте пересылку заголовков WebSocket upgrade и установите proxy_buffering off: сбой обновления не позволит чату подключиться, а буферизация задержит поток возобновления HITL. В версии v0.9.19 неудачное рукопожатие завершает состояние потоковой передачи, а разрыв соединения не отменяет активную задачу агента.

Готов ли Octop к промышленной эксплуатации?

До версии 1.0 проект выпускал несколько тегированных релизов в неделю по состоянию на август 2026 года. Тег v1.0.0 был присвоен 14 сентября 2026 года, затем последовала серия бета-тегов 1.0.2 перед выходом стабильной версии v1.0.2 18 октября 2026 года. По состоянию на 20 ноября 2026 года новейшим тегом является v1.0.3b7, опубликованный 18 ноября 2026 года, в то время как v1.0.2 остается последним стабильным релизом. Темп разработки остается высоким, поэтому рассматривайте проект как перспективный, а не как устоявшийся. Это приемлемо для семьи или небольшой внутренней команды, если вы фиксируете конкретный тег, читаете журнал коммитов перед каждым обновлением и делаете резервную копию тома данных перед каждой пересборкой. Не запускайте его на latest и пока не размещайте в нем данные клиентов.

Была ли эта статья полезной?