SSD Nodes Learn Hosting plans →
ガイド Matt Connor著者 Matt Connor

OctopをVPSに自己ホストする方法:Docker Compose構築

Octop v0.9.19をDocker Composeのtag固定でVPSへ構築します。ユーザー分離、OpenAI互換モデル、TLSの設定と、curlインストーラーを避ける理由を解説します。

Octop とは何か、なぜ自己ホストするのか

Octop は、家庭や小規模チーム向けの自己ホスト型 AI アシスタントです。単なるチャットフロントエンドではなく Octop を自己ホストする理由は、ユーザー同士を分離できることにあります。Open WebUI は、モデルの前段で動作するブラウザーインターフェースを提供し、複数ユーザーとアクセス制御にも対応します。Octop は、管理者ロールを含むアカウント、ユーザーごとのプライベートワークスペースと認証情報セット、さらにタスクごとに切り替えられる専門エージェントのライブラリを組み合わせます。この違いにより、1 台の VPS で 1 人ではなく 5 人が利用できます。

プロジェクトは github.com/TencentCloud/Octop にあります。1 つのプロセスで Web ダッシュボード、コマンドラインインターフェース、チャネル(Feishu、DingTalk、QQ、Discord、WeCom)、スケジュールジョブを提供し、すべてが ~/.octop/ 配下の単一の SQLite データベースに保存されます。以下の内容はすべて、2026 年 8 月 5 日にリリースされた tag v0.9.19 を前提にしています。プラットフォームをまだ選定中であれば、VPS で実行できる Open WebUI 代替製品の比較で、より広い選択肢を確認できます。

作業に時間をかける前に、1 点明確にしておきます。このガイドの執筆時点で、Octop はベンダーの GitHub 組織から公開されている pre-1.0 ソフトウェアでした。その後、2026 年 9 月 14 日に v1.0.0 が tag 付けされ、2026 年 11 月 20 日時点の最新 tag は v1.0.3b7 です。これは 2026 年 11 月 18 日に公開され、リポジトリの star 数は約 12,300 です。最新の安定版リリースは、2026 年 10 月 18 日に公開された v1.0.2 のままです。以下の手順は v0.9.19 を前提に作成されており、1.x では再テストしていません。開発の進行は速く、バージョン番号にも表れています。ここで安定したアップグレード経路を保証するものではありません。tag を固定し、changelog を確認し、バックアップを保持してください。

開始前に必要なもの

  • Docker Engine と Compose plugin を実行できる Ubuntu 24.04 の VPS。Compose を初めて使う場合は、VPS 向け Docker Compose の基本から始めてください。
  • git。イメージを pull するのではなく、release tag を checkout するために必要です。
  • VPS を指すドメイン名。前段に TLS(transport layer security)を配置するために必要です。
  • OpenAI API に対応するモデルバックエンド。ローカルの Ollama、セルフホストの gateway、または有料の key を使用できます。

Octop 自体は軽量です。Python プロセスと SQLite ファイルで構成されています。負荷の大部分はモデルバックエンドが担います。そのため、同じホストでモデルを実行する場合は、モデルに合わせてホストのスペックを決めてください。

curl インストーラーを推奨しない理由

v0.9.19 の README では、1 行のインストールコマンドを先頭に示しています。

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

管理対象のサーバーで、このコマンドをそのまま bash にパイプすることは推奨しません。リポジトリには scripts/install.sh も含まれているため、そのコピーには git の履歴があり、タグで特定できます。一方、Tencent Cloud Object Storage バケットから配信されるコピーは、上記のコマンドでは固定されていません。バケットが翌日に別の内容を配信しても、コマンドはそのまま実行します。結果を直接 bash にパイプすると、内容を 1 行も読む前にマシン上でスクリプトが実行される点にも注意が必要です。

このインストーラーは、コンテナではなくホストに書き込みます。uv を使用して Python 3.12 を取得し、パッケージマネージャーが把握できない環境を構築するため、後で削除する作業は手動になります。

より適切な方法は 2 つあります。スクリプトを取得して内容を確認してから実行する方法です。30 秒程度で済みます。curl -fsSL <url> -o install.sh、次に less install.sh、最後に bash install.sh を実行します。もう 1 つは Docker を使用する方法で、このガイドの残りで説明します。PyPI パッケージ (pip install octop) は少なくともバージョン付きの成果物なので、リリースに固定できます。

Docker Compose で Octop をデプロイし、v0.9.19 に固定する

v0.9.19 で提供された Compose ファイルはリポジトリからイメージをビルドするため、このガイドでバージョンを固定するとは、git tag をチェックアウトすることを意味します。公開済みのイメージも存在します。v0.9.19 のツリーには、docker-publish.yml workflow がすでに含まれています。これは 15 July 2026 に v0.9.8 で追加されたもので、すべての v* tag についてイメージをビルドし、Docker Hub に push します。20 October 2026 時点では、プロジェクトは GitHub の container registry(docker pull ghcr.io/tencentcloud/octop:1.0.2)にも公開しています。それでも、チェックアウトした tag からビルドするほうが厳密に固定できます。registry tag を信頼するのではなく、確認したコードそのものをコンパイルするためです。これは、ほとんどの self-hosted プロジェクトが求める手順より 1 つ多い作業です。たとえば self-hosted AFFiNE workspace では、公開済みのイメージ tag を固定するだけで、VPS 上でビルドすることはありません。以下の clone、checkout、build の手順は、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: block に注意してください。image: octop:latest は自分でビルドしたイメージの名前であり、registry reference ではありません。そのため、ここでの latest は直近にコンパイルした内容を指します。データパスはデフォルトに任せず、明示した場所に設定してください。また、初回起動前に admin account に実際のパスワードを設定してください。これを 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 内の ${...} placeholder を展開する目的でだけ読み込みます。このファイルに追加した key は、Compose file の environment: にも記載しない限り container には渡りません。OCTOP_ACCESS_TOKEN_TTL だけを .env に追加しても、何も起こりません。しかも、エラーは表示されません。別の方法として、同じ key を mount した data directory 内の ~/.octop/env に記述できます。Octop は起動時にこのファイルを読み込みます。Docker Compose の env file と secret に関するガイドでは、この 2 つの仕組みが同じではない理由を説明しています。

ビルドして起動します。

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

正常な instance は、{"ok":true,"started_at":...,"db":...,"users_loaded":0,"agents_running":0} のような JSON object を返して health check に応答します。それ以外の場合は、browser に触れる前に docker compose -f docker/docker-compose.yml logs -f octop を確認してください。

ここで、ビルドしたばかりのイメージに意味のある名前を付けます。次の --build によって octop:latest が上書きされるため、名前を付けないと 2 つを区別できなくなります。

docker image tag octop:latest octop:0.9.19

初回起動では octop init が実行され、data volume に初期 credentials が書き込まれます。

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

デフォルト値は admin / octop です。これらが適用されるのは 初回の init 時だけ です。これは、よくある質問の理由でもあります。container を一度起動した後で OCTOP_DEFAULT_PASSWORD を変更しても、account はすでに存在するため何も変わりません。パスワードは dashboard で変更してください。

ポート 8088 を公開しない

上記の ports: の行は、VPS 上のすべてのインターフェイスにバインドします。コンテナが起動した瞬間に、ダッシュボードが暗号化されていない状態でインターネットに公開されます。Octop 自体の OCTOP_BIND_HOST のデフォルト値は 127.0.0.1 です。Compose ファイルでは 0.0.0.0 に上書きされています。これは、プロセスが自身のネットワーク名前空間の外部からのトラフィックを受け入れる必要があるためです。この上書きは正しい設定です。公開ポートが、システムを外部にさらしている部分です。

docker/docker-compose.yml の ports: の行を編集し、マッピングが loopback のみで待ち受けるようにします。

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

単純な override ファイルでこの問題を解決しようとしないでください。Compose は複数のファイルにある ports のリストを置き換えずに連結します。そのため、両方のマッピングが公開され、2 番目のマッピングはバインドに失敗します。upstream のファイルを変更せずに使用する場合は、シーケンスに !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(自動証明書管理環境)経由で証明書を自動取得し、特別な設定なしで WebSocket をプロキシするためです。

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 は 2 つの upgrade ヘッダーを転送し、上流との通信に HTTP/1.1 を使用する必要があります。proxy_http_version 1.1 によりこれを明示できます。また、nginx 1.29.7 より前のバージョンではこの設定が必要です。upgrade が正常に完了しないと、ダッシュボードは通常どおり表示されますが、チャットは接続できません。v0.9.19 では、ハンドシェイクに失敗した場合にストリーミング状態を終了するため、メッセージが永遠に停止したままになりません。proxy_buffering off も重要です。human-in-the-loop の再開エンドポイントは text/event-stream を返し、SSE(server-sent events)がプロキシのバッファーに保持されると、ストリーミングされず最後にまとめて到着するためです。proxy_read_timeout は、上流からデータが長時間届かない場合に対応します。60 秒のデフォルト値では WebSocket が切断され、upstream timed out (110: Connection timed out) がログに記録されることがあります。ただし、v0.9.19 では切断後もエージェントのタスクが実行されます。明示的にキャンセルするとタスクは停止します。

プロキシ配下でのJWT認証の動作

Octopはcookieではなくbearer tokenで認証します。POST /api/auth/loginは{access_token, token_type, expires_in, user}を返し、その後のリクエストにはAuthorization: Bearer <access_token>が付加されます。リバースプロキシにとって、これは好都合です。cookie domain、Secureフラグ、誤設定しやすいSameSiteルールがないため、http://127.0.0.1:8088で機能していたセッションはhttps://octop.example.comでも同じように動作します。

実際のユーザーに提供する前に、2つの点を理解しておく必要があります。

WebSocketはURLにtokenを含めます。 エンドポイントはWS /api/agents/{id}/chat/ws?token=<jwt>です。ブラウザーのJavaScriptはWebSocketハンドシェイクにAuthorization headerを設定できないためです。TLSは通信中のtokenを保護します。ただし、独自のログへの記録までは防ぎません。nginxはデフォルトで、query stringを含む完全なrequest lineをaccess_logに書き込むため、実際のユーザーに有効なtokenがサーバー上の平文ファイルに残ります。引数を除いたpathをログに記録してください。$uriはquery stringがすでに除去された正規化済みのpathです。これをhttpブロックに記述し、serverから参照します。

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では、logoutしてもtokenは無効化されません。 OCTOP_ACCESS_TOKEN_TTLのデフォルト値は86400であるため、login後もtokenは24時間有効です。tokenを無効化する文書化された唯一の方法はoctop admin rotate-jwt-secretです。これは~/.octop/secrets/jwt_secretに保存された署名keyをローテーションし、発行済みのすべてのtokenを全ユーザーについて直ちに無効化します。したがって、チームからユーザーが離れた場合は、ユーザーを削除し、secretをローテーションしてから、残りのユーザーに再度loginするよう伝えます。これが重い場合は、有効期間を短くしてください。その際、変数をenvironment:のリストだけでなく.envにも追加することを忘れないでください。

OCTOP_ACCESS_TOKEN_TTL=28800

総当たり攻撃への対策もあります。OCTOP_LOGIN_MAX_ATTEMPTSのデフォルト値は5回の失敗、OCTOP_LOGIN_LOCKOUT_SECONDSは900です。そのため、ロックアウトされたユーザーは壊れたインストールを確認するのではなく、単に15分待つことになります。Octopには独自のユーザーストアがあり、v0.9.19時点で文書化されたOIDCサポートはありません。実際のシングルサインオンが必要な場合は、認証プロキシを前段に配置します。自己ホスト型のAuthentikサーバーはそのためのものです。組み込みのOIDCサポートは2026年8月15日のv0.9.24で追加されました。

モデルバックエンドをOctopに指定する

プロバイダーはダッシュボードでエージェントごとに設定し、octop provider list で設定内容を確認できます。Octopには、OpenAI互換API、DashScope (Qwen)、Ollama用のプリセットが用意されています。認証情報は、自分のSQLiteデータベースにある providers テーブルへ保存されます。選択によって、費用とサーバー外へ送信されるデータが変わります。

Ollamaを使ったローカルモデル。 データはサーバー外へ出ず、トークンではなくRAMを消費します。注意が必要なのは、コンテナからホストのOllamaを 127.0.0.1:11434 で利用できない点です。このアドレスはコンテナ自身のループバックを指すためです。サービスにホストゲートウェイのエントリを追加します。

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

次に、プロバイダーのベースURLを http://host.docker.internal:11434/v1 に設定します。これはOllamaのOpenAI互換パスです。APIキー欄には空でない任意の文字列を入力します。Ollamaはこの値を無視しますが、OpenAIクライアントは空のキーを送信しないためです。これを動作させるには、Ollamaもループバック以外で待ち受ける必要があります。そのため、systemd unitに OLLAMA_HOST=0.0.0.0:11434 を設定します。ここがリスクのある部分です。OllamaのローカルAPIには認証がないため、パブリックIPで11434番ポートを公開すると、最初にスキャンした誰でも利用できるモデルサーバーになります。Dockerのプライベート範囲である sudo ufw allow from 172.16.0.0/12 to any port 11434 proto tcp だけを許可し、それ以外は拒否してください。VPSでOllamaを実行するではモデルサイズを説明し、OllamaとvLLMの比較では、Ollamaを使うべきでなくなるタイミングを説明しています。

ローカルモデルについて、もう1つ注意があります。Octopのバグに見えますが、そうではありません。エージェントはツールを呼び出して動作します。システムプロンプト、ツール定義、履歴を合わせると、大きなプロンプトになります。Ollamaのデフォルトのコンテキストウィンドウは、現在はVRAM容量に依存します。24 GiB未満では4k、24 GiB以上48 GiB未満では32k、48 GiB以上では256kです。現在のガイダンスでは、エージェントとコーディングツールに少なくとも64,000トークンを推奨しています。num_ctx を設定し、モデルがサポートするコンテキストと利用可能なメモリの範囲内で、このワークロードに対応できるようにします。また、関数呼び出しに実際に適したモデルを選んでください。文の途中で応答が止まる場合は、反対の問題であり、別の設定 num_predict が関係します。回答が途中で切れる場合は、エージェントを疑う前に、num_predictの設定場所とdone_reasonの内容を確認するとよいでしょう。候補を絞り込むより特定のモデルから始めたい場合は、Nemotron 3.5 Lightningを試す価値があります。この記事では、取得する正確なタグ、必要なRAM、CPUのみで実用的な速度を維持できるかどうかを説明しています。

セルフホストゲートウェイ。 セルフホストのLiteLLMゲートウェイをOctopと他のすべてのサービスの間に置くと、1つのベースURL、ユーザーごとの個別キー、利用額の上限、単一のログを利用できます。Octopを編集せずに、ゲートウェイの背後にあるモデルを交換することもできます。

有料API。 品質は最も高くなりますが、明確なトレードオフがあります。会話の内容はサーバー外へ出てプロバイダーに届きます。これは、セルフホストを選んだ主な理由と相反する点です。キーは docker/.env に OPENAI_API_KEY として設定します。Composeファイルがすでにこの値を渡しています。

どの方式を選んでも、Composeファイルには OCTOP_LANGFUSE_ENABLED、LANGFUSE_PUBLIC_KEY、LANGFUSE_SECRET_KEY、LANGFUSE_BASE_URL も含まれています。そのため、自分のLangfuseインスタンスへトレースを送信し、チャット画面から推測するのではなく、エージェントが実際に行っている処理を確認できます。

ユーザー、ロール、共有エージェントライブラリ

初回起動時に作成される admin アカウントが、他のユーザーを作成・管理します。各ユーザーには専用のエージェント、ワークスペース、認証情報が割り当てられます。この分離は、ブラウザーが保持する token によって維持されます。これとは別に、組み込みの専門家テンプレートと、インスタンス単位の skill パッケージがあります。自分のエージェントを他のユーザーと共有する機能は v0.9.24 で追加されました。ここで固定しているバージョンより後の変更です。

tooling の扱いには注意してください。Octop は tool approval と shell command guardrails を提供しており、どちらも実際に機能します。ただし、shell command を実行するエージェントは、データボリュームがマウントされた Octop コンテナ内でコマンドを実行します。Guardrails により、不注意な prompt で実行できる操作は制限されます。しかし、これは sandbox の境界ではありません。そのため、shell を直接渡さない相手に対しては、tool approval を有効にしておいてください。他の選択肢と比較する場合は、セルフホスト 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
  }
]

これは、2026 年 8 月 7 日時点でリポジトリから取得したタグの日付です。9 日間に 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 を checkout する前に、そこに何が含まれているかを確認してください。このプロジェクトは、安定版リリースと並行して v1.0.2b9 のようなベータ版にもタグを付けています。2026 年 11 月 20 日時点で最新のタグは v1.0.3b7 で、2026 年 11 月 18 日に公開されています。最新の安定版リリースは、2026 年 10 月 18 日に公開された v1.0.2 のままです。v0.9.19 から更新すると、2026 年 9 月 14 日の v1.0.0 リリースをまたぐため、ログは長くなります。内容を注意深く確認してください。

毎回、最初にバックアップを取得してください。起動時にデータベースマイグレーションが実行されるため、この速度でリリースされるプロジェクトでは、マイグレーションに失敗した場合の切り分けを自分で行う必要があります。

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

次に、新しいタグを checkout して、docker compose -f docker/docker-compose.yml up -d --build で再ビルドします。問題が発生した場合、古いタグを checkout して再ビルドすればコードは元に戻せます。ただし、データベースを元に戻せるのは tarball だけです。

その tarball には octop.db、config.json、JWT 署名 Secret、credential.txt が含まれるため、サーバー自体と同じように慎重に扱う必要があります。mode 600 を設定し、サーバー外にもコピーを保管してください。規模の大きい構成向けには、PostgreSQL を SQLite の代わりに pgvector とともに実行する docker/docker-compose.postgres.yml も提供されています。

障害のパターンと表示される文字列

ヘルスチェックが応答しない。 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 への接続失敗を確認してください。プロキシが upgrade を転送していることを確認します。proxy_http_version 1.1 と Upgrade および Connection ヘッダーを追加してください。

返信全体が数秒遅れて一度に表示される。 ストリーミングは動作していますが、バッファリングが有効です。proxy_buffering off を設定してください。

bind: address already in use。 8088 をすでに使用しているプロセスがあります。sudo ss -tlnp | grep 8088 でそのプロセスを特定できます。これは、元の ports エントリを編集せず、override ファイルに 2 つ目の ports エントリを追加した場合にも発生します。

正しいパスワードが拒否される。 5 回の誤った試行で 900 秒間ロックアウトされます。再インストールせず、解除されるまで待ってください。

.env の新しいパスワードが反映されない。 これらの認証情報は初回初期化時にのみ適用されます。ダッシュボードで変更してください。

エージェントは応答するが、ツールを実行しない。 ローカルモデルのコンテキスト割り当てと、function calling のサポートを確認してください。Ollama は現在、エージェントの処理に少なくとも 64,000 tokens を推奨しています。対応するモデルとメモリ容量を選択してください。

FAQ

Octop は Open WebUI の代替ですか?

Octop の追加機能が必要な場合に限ります。Open WebUI も複数ユーザー、ロール、アクセス制御に対応しています。Octop は、アカウントと管理者ロール、ユーザーごとのワークスペースと認証情報、切り替え可能な専門エージェントのライブラリを組み合わせています。そのため、複数人で同じサーバーを使っても、履歴を共有せずに済みます。1 つのアカウントで問題なければ、Open WebUI のほうがシンプルで、成熟度も高い選択肢です。

Octop の curl インストールスクリプトを使うべきでない理由は何ですか?

v0.9.19 のワンライナーは、内容を git のタグやコミットに固定せず、Tencent Cloud Object Storage のバケットからスクリプトを取得します。リポジトリには scripts/install.sh にバージョン管理されたコピーもありますが、リモートから取得した内容を bash にパイプすると、内容を読む前に実行してしまいます。また、パッケージマネージャーの管理外にある独自の Python 3.12 環境を使って、ホストへインストールします。スクリプトをダウンロードしてから内容を確認するか、チェックアウトしたタグから Docker Compose でデプロイしてください。

Octop は有料 API の代わりにローカルモデルを使えますか?

はい。Octop は OpenAI 互換 API に対応し、Ollama のプリセットも提供しています。そのため、コンテナに extra_hosts: ["host.docker.internal:host-gateway"] を追加し、ホストで OLLAMA_HOST=0.0.0.0:11434 を設定すれば、http://host.docker.internal:11434/v1 を指定して動作させられます。Ollama のローカル API には認証がないため、Docker のアドレス範囲に対してファイアウォールでポート 11434 を制限してください。割り当てられたコンテキストウィンドウを確認してください。Ollama のデフォルト値は現在 VRAM によって異なります。現在のガイダンスでは、エージェント処理に少なくとも 64,000 トークンを推奨しています。ただし、モデルが対応するコンテキスト長と利用可能なメモリの範囲内に収めてください。

リバースプロキシは必要ですか。それともポート 8088 を開放できますか?

プロキシが必要です。Octop が提供する Compose ファイルは、TLS なしで全インターフェースにポート 8088 を公開します。そのため、パスワードや bearer token がインターネット上を平文で通過します。公開ポートを 127.0.0.1:8088:8088 に変更し、Caddy または nginx を証明書付きで前段に置いてください。nginx を使う場合は、WebSocket のアップグレードヘッダーを転送し、proxy_buffering off を設定してください。アップグレードに失敗するとチャットに接続できません。また、バッファリングによって HITL の再開ストリームに遅延が生じます。v0.9.19 では、ハンドシェイクに失敗するとストリーミング状態が終了します。切断しても、実行中のエージェントタスクはキャンセルされません。

Octop は本番運用に対応していますか?

2026 年 8 月時点では 1.0 未満で、週に複数回のタグ付きリリースを出していました。2026 年 9 月 14 日に v1.0.0 のタグを付け、その後、安定版 v1.0.2 を 2026 年 10 月 18 日にリリースするまで、1.0.2 のベータタグを続けて公開しました。2026 年 11 月 20 日時点で最新のタグは、2026 年 11 月 18 日に公開された v1.0.3b7 です。一方、最新の安定版は v1.0.2 のままです。この開発ペースは依然として速いため、完成した製品ではなく、有望な段階のものとして扱ってください。正確なタグを固定し、アップグレード前に毎回コミットログを確認し、再構築前にデータボリュームをバックアップすれば、家庭や小規模な社内チームでの利用には対応できます。latest では実行せず、まだ顧客データを保存しないでください。

この記事は役に立ちましたか?