FAQ¶
よくある質問と回答。
インストールとデプロイ¶
ワンクリックインストールスクリプトのダウンロードに失敗する?¶
サーバーの外部ネットワーク接続を確認してください。中国国内のネットワーク環境の場合、まず Docker ミラーアクセラレーションを設定してください。
ポートが使用中の場合どうすればよい?¶
インストールスクリプトまたはコンテナオーケストレーションのポートマッピングを変更するか、ポートを占有しているサービスを停止してください。よく使用されるポート:8010、9090、9093、8500、4505/4506。
admin パスワードを忘れた場合どうすればよい?¶
ホスト管理¶
スクリプト実行でホストが選択できないのはなぜ?¶
スクリプト実行、ファイル配布、スケジュールタスクでは管理済みのホストのみ選択できます。まず「ホスト管理」でホストが「管理済み」リストに入っていることを確認してください(管理待ちのホストは選択できません)。
OpsMini ホストがずっと「管理待ち」のまま?¶
Agent は報告済みですが承認されていません。「ホスト管理 - 管理待ち」に移動し、「管理を承認」をクリックしてください。
Token 検証に失敗する?¶
Agent の Token とプラットフォームが一致していません。Agent 設定ファイルの server_token が「システム設定 - 連携 Token」と一致しているか確認してください。
監視とアラート¶
アラートイベントにデータがない?¶
- 「システム設定 - Prometheus 接続」の設定が正しいことを確認
- Prometheus アドレスにアクセス可能で、Basic Auth 認証情報が正しいことを確認
- ホストが管理済みで Consul に登録されていることを確認
AI アシスタント¶
モデルの取得に失敗する?¶
API Key が正しく、Base URL にアクセス可能であることを確認してください。DeepSeek は embeddings インターフェースをサポートしていません(chat completions のみ)。ナレッジベースのベクトル化には別途他のサービスを設定する必要があります。
その他¶
プラットフォームアクセスが 502?¶
ローカルでプロキシ経由でアクセスする場合、プロキシを経由することで 502 が発生することがあります。直接接続を試すか、--noproxy を設定してください。