サービスポートマップ
外部に開いているのはひとつだけです
AI スタックで ホストの 80 / 443 を掴むのは plantpulse-proxy(nginx) だけです。
チャット画面も、管理コンソールも、各 API もすべて このプロキシを通して入ります。
2026-08 より前は、AI Chat Web が 80:8080 で直接発行していました。いまは発行せず、
コンテナ内部でのみ(expose: 8080)開きます。露出ポイントをひとつに集め、ファイアウォール・監査・TLS を
ひとところで処理するためです。古いドキュメントを見てアプリコンテナの 80 を探していたのなら、
プロキシを見てください。
ホスト名で振り分けられます
プロキシは Host ヘッダを見て、バックエンドを選びます。そのため、DNS にこれら の名前をプロキシ IP に
登録しておく必要があります。それぞれのサービスに到達できます。
| ホスト | バックエンド | 内容 |
|---|---|---|
| その他すべて（デフォルト） | copliot-web:8080 | AI Chat Web — チャット画面 |
admin.* | admin-web:80 | 管理コンソール |
llm.* | litellm-proxy:4000 | LLM ゲートウェイ(OpenAI互換) |
rag.* | rag-api:7115 | RAG 検索 API |
timeseries.* | insight-api:8970 | 時系列インサイト API |
parser.* | document-understanding-api:7120 | ドキュメント解析 API |
vision.* | vision-api:7130 | ビジョン API |
プロキシは 443 も聞きますが、フロント別途のロードバランサ・リバースプロキシを置くデプロイでは、そこで
TLS が終端され、プロキシには平文で入ります。フロント終端を無視する設定にすると無限リダイレクトになります。
どの形態か先に確認してください。
LAN に直接開いているポート
プロキシを通さず、ホストに直接発行されるポートです。127.0.0.1 バインドではなく
すべてのインターフェースに開いています — 社内ネットワーク外からアクセスできないよう、ファイアウォールでブロックしてください。
| ポート | サービス | なぜ開いているか |
|---|---|---|
| 80 / 443 | plantpulse-proxy | 唯一のユーザタッチポイント |
| 4000 | LiteLLM | LLM ゲートウェイ直結(llm.* 経由でも接続可能) |
| 7115 | RAG API | MCP クライアント(Claude Desktop など)直結用 |
| 8970 | TimeSeries Insight API | MCP クライアント直結用 |
| 9080 | 管理コンソール(admin-web) | オペレータ用。admin.* 経由でも接続可能 |
| 7474 | Neo4j Browser | グラフ DB 管理 UI |
| 7687 | Neo4j Bolt | グラフ DB クエリプロトコル |
プロファイルを有効にすると起動するもの
デフォルト起動には含まれず、該当する compose プロファイルで起動したときだけ開きます。
| ポート | サービス | プロファイル |
|---|---|---|
| 6006 | Arize Phoenix — トレース UI | observability |
| 5000 | ローカルイメージレジストリ | registry |
| 5080 | レジストリ管理 UI | registry |
| 9090 | 旧 Copilot Web | archived |
2026-07 の改編時にデフォルトスタックから外れたのみで、observability プロファイルで復活できます。
管理コンソールからもプロキシ経由で見られます。同じ改編で外れた Langflow(7860)·
Jupyter(3500) は本当に削除されており、復活できません。
内部専用（発行していない）
compose ネットワーク内でサービス名でのみ到達できます。ホストから nc -z で叩いても応答が
ないのは正常です。
| サービス | 内部アドレス | 役割 |
|---|---|---|
| AI Chat Web | copliot-web:8080 | チャット画面(プロキシデフォルトバックエンド) |
| 管理コンソールバックエンド | admin-api | 認証正本。admin-web の nginx が転送 |
| ドキュメント解析 API | document-understanding-api:7120 | parser.* バックエンド |
| ビジョン API | vision-api:7130 | vision.* バックエンド |
| LightRAG | lightrag:9621 | RAG エンジン。ドキュメント管理 WebUI(/webui) |
| Qdrant | qdrant:6333 | ベクトル DB |
| Docling | docling-serve:5001 | ドキュメント変換 |
| vLLM(生成) | vllm-llm:8000 | ローカル LLM 推論 |
| vLLM(埋め込み) | vllm-emb:8000 | 埋め込み |
| vLLM(リランク) | vllm-rerank:8000 | リランキング |
| 時系列推論 | timeseries-inference:8980 | インサイトモデルサービング |
| DCGM Exporter | dcgm-exporter | GPU メトリクス |
plantpulse-mcp-server(50000) と plantpulse-ontology(8888) は独立したサービスとして存在しません。
MCP・オントロジーツールはプラットフォーム server-web 統合 MCP(/api/v5/mcp、api_key 認証)が提供します。
プラットフォームから借用しているもの
PostgreSQL(5432) · Cassandra(9042) · Redis/Valkey(6379) · MinIO(9000/9001) は AI スタックが 起動しません。 PlantPulse プラットフォームのインストールを共用しています。これらのポートのファイアウォール・アカウントは プラットフォーム側のセキュリティ設定に従います。
ポート状態の確認
全体の状態確認
cd /home/kopens/plantpulse-ai/bin
./status.sh
health.sh は各サービスのヘルスエンドポイントまで叩きます。コンテナが起動していることと
実際に応答することは別なので、障害調査ではこちらを使ってください。
個別ポート確認
# 특정 포트 리스닝 확인
nc -z 127.0.0.1 <port> && echo "OK" || echo "DOWN"
# 포트 사용 프로세스 확인
ss -tlnp | grep <port>
ファイアウォールで開くポート
| 対象 | 開くポート |
|---|---|
| 全ユーザ | 80 / 443(プロキシ) |
| オペレータ(社内ネットワーク) | 9080 管理コンソール、7474 Neo4j Browser |
| MCP クライアント(社内ネットワーク) | 7115 RAG、8970 TimeSeries |
その他のポートは、社内ネットワーク内でも開く理由がありません。データベースポート(5432 · 9042 · 6333 · 6379 · 7687 · 9000) は いかなる場合も外部に露出させないでください。