クイックデプロイガイド（Docker Compose）

はじめに

このガイドの対象者

• qOntology を初めて試す方
• 環境の設定、データベースの初期化、各サービスの起動を手動で行いたくない方
• スクリプトでプラットフォーム全体を起動したい方

事前確認

• Docker イメージの取得にはインターネット接続が必要です。イメージレジストリに接続できることを確認してください。
• 中国本土のネットワークでは、利用可能な Docker レジストリミラーを事前に設定してください。
• Windows の Docker Desktop は Linux Containers モードに切り替えてください。

Docker イメージのアーキテクチャ

同梱設定の MySQL 5.7 は amd64（x86_64） イメージです。arm64 ホストで実行するにはエミュレーションが必要です。Docker の対応機能が有効であることを確認してください。

デプロイパッケージには次の内容が含まれています。

• ✅ フロントエンドの静的リソース（ビルド済みの dist フォルダー）
• ✅ qOntology バックエンドサービス
• ✅ MySQL、Redis、Neo4j
• ✅ Nginx とファイルプレビューサービス
• ✅ 設定済みの .env ファイル
• ✅ ディレクトリ構成、Docker Compose 設定、起動スクリプト

フロントエンドのビルドや手動でのデータベース初期化は不要です。Docker をインストールし、パッケージを展開して、対応するスクリプトを実行します。

手順 1：Docker と Docker Compose のインストール

qOntology は Docker コンテナーで動作します。最初に Docker をインストールして起動してください。

• Docker：≥ v20.10
• Docker Compose：≥ v2.20.2

🖥️ Windows / macOS

Docker Desktop をインストールしてください。Docker Compose は同梱されています。

🐧 Linux

Docker 公式ドキュメントに従い、Docker Engine と Docker Compose Plugin をインストールしてください。

インストール後、次のコマンドで確認します。

docker version
docker compose version

手順 2：デプロイパッケージの取得

🔗 Baidu Netdisk：https://pan.baidu.com/s/1Lw8a4GX2G0m2c7u9CfAC9g

🔑 アクセスコード：QQ グループに参加し、グループ内のファイルで確認してください。👉 QQ グループに参加

パッケージを展開し、その中の docker フォルダーでスクリプトを実行します。

手順 3：スクリプトの実行

3.1 Linux / macOS

qontology.sh で起動またはアンインストールを行います。

コマンド	動作
sh qontology.sh start	環境とイメージを確認し、qOntology と関連サービスを起動する
sh qontology.sh uninstall	コンテナーとネットワークを削除し、ボリュームとマウント済みデータは保持する

起動

docker フォルダーでターミナルを開き、次を実行します。

# qOntology を起動
sh qontology.sh start

アンインストール

sh qontology.sh uninstall

確認メッセージに従って DELETE QONTOLOGY と入力します。

警告

アンインストールではコンテナーとネットワークが削除されます。ボリュームとマウント済みデータは保持されますが、必要なデータは事前にバックアップしてください。

3.2 Windows

次の 2 つのスクリプトを使用します。

スクリプト	用途	動作
start-all.bat	qOntology の起動	環境確認、データベース初期化、プラットフォームと関連サービスの起動
uninstall.bat	qOntology の削除	コンテナー、ネットワーク、ボリューム、実行時データ、他のコンテナーが使用していない関連イメージの削除

実行方法

パッケージの docker フォルダーを開き、必要な .bat ファイルをダブルクリックします。

PowerShell または CMD からも実行できます。

# qOntology を起動
.\start-all.bat

# アンインストール
.\uninstall.bat

スクリプトの選び方

• qOntology の起動：start-all.bat をダブルクリックします。
• qOntology の完全削除：uninstall.bat をダブルクリックします。

削除時は確認メッセージに従って DELETE QONTOLOGY と入力します。Windows の完全削除ではコンテナー、ネットワーク、ボリューム、実行時データが削除されます。必要なデータは事前にバックアップしてください。

デプロイ完了！🎉

次のアドレスからアクセスできます。

• 🌐 qOntology オントロジーエンジニアリングプラットフォーム
  
  http://<SERVER_IP>:8897
  
  ユーザー名：qOntology
  
  パスワード：qOntology123

🔑 <SERVER_IP> はホストのパブリック IP またはプライベート IP に置き換えてください。ポートはパッケージの .env にある EXPOSE_NGINX_PORT、認証情報は初期化データに従います。

💡 確認事項

• 初回起動後は、すべてのコンテナーの初期化が終わるまで 1～2 分待ってください。
• docker ps でコンテナーの状態を確認できます。
• アクセスできない場合、ホストのファイアウォールで 8897（または設定したポート）が許可されているか確認してください。