Docker Composeを使用してONLYOFFICE Docs Enterpriseをインストールする方法

ONLYOFFICE Docs Enterpriseは、公式リポジトリを使用してDocker Composeデプロイメントとして実行できますDocker-DocumentServer。重要なのは、まずEnterprise専用のComposeファイルから始め、永続ストレージ、安定したJWTシークレット、およびライセンスファイルを設定してから、サーバーを本番環境に対応させることです。これにより、オンライン編集サービスであるDocsがインストールされますが、ONLYOFFICE Workspaceポータル全体はインストールされません。

以下の手順は、2026年10月6日にONLYOFFICEのエンタープライズDockerガイドおよび公式リポジトリで検証済みです。リポジトリのデフォルトブランチは変更される可能性があるため、長期運用サーバーの場合は、承認済みのリリースまたはタグをチェックアウトし、そのバージョンをデプロイメントノートに保管してください。

要件チェックリスト（クイックチェックリスト）

ONLYOFFICEの最新のエンタープライズガイドには、これらのホスト要件が記載されています。同時接続ユーザー数、ドキュメントの複雑さ、および統合機能が増えるにつれて必要な容量も増加するため、ベンダーが提示する基準値は、サイジングの保証ではなく、あくまで出発点として捉えてください。

1. Docker Composeをインストールし、公式のデプロイメントファイルを取得します。

Docker Engineが既にDockerのパッケージリポジトリからDebianまたはUbuntuにインストールされている場合は、以下のコマンドでComposeプラグインをインストールしてください。

sudo apt-get update
sudo apt-get install docker-compose-plugin
docker compose version

別のLinuxディストリビューションの場合は、そのディストリビューション向けのDockerの最新のインストール手順に従ってください。現在のプラグインはスペース付きコマンドを使用していますdocker compose。古いスタンドアロンコマンドはdocker-compose後方互換性のために維持されており、ここに示されているONLYOFFICEのEnterpriseコマンドで使用されるパスではありません。

ONLYOFFICEのリポジトリをクローンし、そのディレクトリに移動します。変更管理ポリシーで固定バージョンが必要な場合は、クローン後、ファイルを編集する前に、承認済みのリリースタグをチェックアウトしてください。

git clone https://github.com/ONLYOFFICE/Docker-DocumentServer.git
cd Docker-DocumentServer
# Optional: select the approved release tag for your deployment
git checkout <release-tag>

チェックアウトしたリビジョンに が含まれていることを確認してくださいdocker-compose.enterprise.yml。docker-compose.ymlこのリポジトリのコミュニティ版 Compose ファイルである を代入しないでください。

2. 機密情報、データストレージ、およびライセンスを準備する

初回起動前に、 を確認してくださいdocker-compose.enterprise.yml。現在の公式ファイルでは、アプリケーションと PostgreSQL サービスがサンプル データベース パスワードを使用しており、JWT の行はコメントアウトされています。アプリケーションのDB_PWD設定と PostgreSQL の両方で、サンプル データベース パスワードを強力な値に置き換えてくださいPOSTGRES_PASSWORD。これらは一致している必要があります。 のコメントを解除するか、 を追加してJWT_ENABLED=true、長く一意な を設定してくださいJWT_SECRET。Docs と統合するアプリケーションまたはコネクタには、同じ JWT シークレットを使用してください。

ログインパスワードを再利用するのではなく、秘密鍵を生成してください。たとえば、コマンドを実行しopenssl rand -hex 32て出力をプライベート環境ファイルに保存し、Compose ファイルから と として参照します${JWT_SECRET}。${DB_PASSWORD}環境ファイルは他のホストユーザーから保護し、Git にコミットしないでください。キーの設定は概念的に次のようになります。

# In a private .env file beside the Compose file
JWT_SECRET=replace_with_a_long_random_value
DB_PASSWORD=replace_with_a_different_long_random_value

両方のデータベースパスワードエントリを更新して、 を参照するようにし${DB_PASSWORD}、サーバー環境エントリを と に設定しますJWT_ENABLED=true。JWT_SECRET=${JWT_SECRET}アップストリームの Compose ファイルは、内部の PostgreSQL、RabbitMQ、および Redis サービスを既に定義しています。カスタマイズする場合は、関連するサービス名と依存関係をまとめておいてください。

重要なアプリケーションデータをホスト上に永続化します。サービス内で、およびのonlyoffice-documentserver匿名ボリュームエントリを、次のようなバインドマウントに置き換えます。/var/www/onlyoffice/Data/var/log/onlyoffice

volumes:
  - ./data:/var/www/onlyoffice/Data
  - ./logs:/var/log/onlyoffice

公式ファイルで定義されている他のボリュームエントリと名前付きPostgreSQLボリュームは、変更する正当な理由がない限りそのままにしておいてください。ホストディレクトリを作成し、受け取ったライセンスをマウントされたデータディレクトリにコピーしてください。

mkdir -p data logs
cp /secure/path/license.lic data/license.lic

コンテナがライセンスを読み取り、データパスとログパスに書き込めることを確認してください。ファイルの所有権要件はイメージとホストによって異なる場合があります。権限エラーが発生した場合は、広範な権限を適用するのではなく、実行中のコンテナのユーザーと公式リポジトリの手順を確認してください。ライセンスと機密情報は、公開Webルートやソース管理から除外してください。

3. エンタープライズサービスを検証して起動する

リポジトリディレクトリからComposeの設定を検証し、Enterpriseスタックを起動します。

docker compose -f docker-compose.enterprise.yml config
docker compose -f docker-compose.enterprise.yml up -d

最初のコマンドは、Composeがファイルを解析し、変数を解決できるかどうかを確認します。解決されたシークレットを出力する可能性があるため、プライベートターミナルで実行し、その出力を公開ログやサポートスレッドに貼り付けないでください。2番目のコマンドは、Enterpriseファイルで記述されているサービスを構築または起動します。公式の定義には、ドキュメントサーバーとその依存関係であるPostgreSQL、RabbitMQ、およびRedisが含まれます。

サービスの状態と最近のメッセージを確認してください。

docker compose -f docker-compose.enterprise.yml ps
docker compose -f docker-compose.enterprise.yml logs --tail=100 onlyoffice-documentserver

再起動中または異常な状態のままになっているコンテナ、データベース認証の失敗、ライセンスメッセージの欠落、または権限エラーがないか確認してください。「稼働中」と表示されているサービスは、コンテナプロセスが実行されていることを示す有用な証拠ですが、それだけでブラウザ編集や外部統合が正常に機能していることを証明するものではありません。

4. サービスをHTTPSで保護し、アクセスを制限する

本番環境への展開では、DNS名（例：）をdocs.example.comサーバーに向け、運用している証明書方式（信頼できるリバースプロキシ、またはONLYOFFICEのドキュメントに記載されている証明書設定）を使用してHTTPSを提供してください。コマンドと統合設定にあるサンプルホスト名を、ご自身の名前に更新してください。通常の利用のために、プレーンなHTTPエディタエンドポイントをパブリックインターネットに公開しないでください。

公式の Enterprise Compose ファイルでは、ドキュメント サーバー用にポート 80 と 443 が公開されています。データベース、Redis、および RabbitMQ サービスは内部依存関係であり、パブリック ネットワークに公開すべきではありません。ファイアウォールとクラウド セキュリティ グループを確認し、必要な受信トラフィックのみがホストに到達するようにしてください。ポート 80 と 443 を別のリバース プロキシが既に所有している場合は、Compose のポート マッピングをホスト オンリーまたは未使用のポートに変更し、プロキシがそのローカル エンドポイントに転送するように構成してください。プロキシは、ドキュメント編集で使用される WebSocket トラフィックをサポートしている必要があります。

HTTPSとJWTは保護対象が異なります。HTTPSはクライアントとサーバー間の通信を暗号化します。JWTはDocsと接続されたプラットフォーム間で交換されるリクエストを検証します。JWTは有効にしたまま、コネクタまたはプラットフォームでまったく同じシークレットを設定してください。統合テストをパスさせるためだけにJWTを無効にしないでください。シークレット、ヘッダー、またはURLの不一致を修正してください。

5. サービスを確認し、統合をテストする

公式の Compose ファイルでは、ドキュメント サーバー コンテナ内でのヘルス チェックが定義されていますhttp://localhost:8000/info/info.json。サービスが正常状態になったことを確認するdocker compose ... psには、 を使用してください。また、ブラウザを使用して公開 HTTPS ホスト名を開くこともできます。実行中の Docs ウェルカム ページは、Web サービスが応答していることを示しますが、ストレージ プラットフォームからのドキュメント コールバックはテストされません。

チェックを完了するには、公開されている Docs URL と同一の JWT シークレットを使用して、互換性のあるプラットフォームに接続します。テスト用の DOCX ファイルを開き、少し編集して保存し、プラットフォームから再度開きます。これにより、プラットフォームが Docs にアクセスでき、Docs が保存された変更をストレージ サービスに返せることが確認されます。ページは読み込まれるもののエディターが開かない場合は、ブラウザのコンソール、プロキシ WebSocket の設定、JWT の合意、およびサーバー ログを確認してください。テスト用ドキュメントは使い捨てのものを使用し、初期設定中は機密情報を使用しないでください。

操作およびトラブルシューティングに関する注意事項

• ライセンスが検出されませんでした。license.licが実際に にマウントされているホストディレクトリにあることを確認して/var/www/onlyoffice/Dataから、コンテナのログを確認してください。
• JWTエラー：サーバーとコネクタのシークレット、ヘッダー、URLを比較します。再起動後もシークレットは安定して保持してください。
• データベースの起動に失敗した場合は、 PostgreSQL環境とドキュメントサーバー環境の両方でデータベースのパスワードが一致していることを確認してください。
• 再作成後にデータが消失する場合： Enterprise Compose ファイルが引き続きデータに対してバインド マウントを使用し、名前付き PostgreSQL ボリュームを保持していることを確認してください。アップグレード前に両方をバックアップしてください。
• エディタは開くが保存できない場合：プラットフォームのコールバック URL が Docs コンテナからアクセス可能であること、およびプロキシが WebSocket 接続を通過させることを確認してください。

エンタープライズ固有の更新パスを使用し、イメージのバージョンを変更する前にリリースノートを確認してください。Composedocker compose down -vで管理されているボリュームを削除する場合を除き、このオプションは使用しないでください。このオプションを使用すると、名前付きPostgreSQLデータボリュームが削除される可能性があります。アップグレード前に、データディレクトリ、必要に応じてログ、およびデータベースをバックアップしてください。

公式資料

バージョン固有の詳細については、ONLYOFFICEのエンタープライズDockerインストールガイド、ライセンス認証手順、および公式のエンタープライズComposeファイルを参照してください。リポジトリのREADMEには、Composeコマンドとコンテナパラメータが記載されています。DockerのComposeプラグインインストールガイドにはLinuxへのインストール方法が記載されています。Dockerがインストールされていない場合は、お使いのディストリビューションに対応したDocker Engineの手順に従ってください。