Mermaid でネットワーク構成図を書く手順: flowchart と architecture-beta の書き方
Mermaid でネットワーク構成図を書く手順をメモしました。Mermaid にはネットワーク図専用の書き方がないので、flowchart の subgraph でネットワークの区切りを表し、線のラベルにポート番号を書きます。
経緯
ネットワーク構成図を Mermaid で書こうとしたところ、専用の書き方がありませんでした。アイコンの付く architecture-beta に日本語のラベルを書くと、VS Code のプレビューでは表示されましたが、このブログ(Mermaid 11.12.2)では Parsing failed: unexpected character になりました。
環境
- Mermaid 11.12.2(このブログで使っているバージョン)
- Mermaid 11.17.2(VS Code 1.144.0 に入っているバージョン)
手順
flowchart で書く基本の形
インターネット、DMZ、社内のネットワークの3つに分けた構成は、次のように書きます。
mermaidflowchart LR
Internet((インターネット))
subgraph DMZ
LB[ロードバランサー]
end
subgraph Private[プライベート]
Web1[Web 1]
Web2[Web 2]
DB[(データベース)]
end
Internet -->|443| LB
LB -->|8080| Web1
LB -->|8080| Web2
Web1 -->|3306| DB
Web2 -->|3306| DB
ここからの例は、Mermaid プレビューに貼りながら読むと、図の変わり方をその場で確かめられます。
ポート番号が線の上に出るので、通信の許可を見直すときの図としても使えます。
アイコンはありませんが、括弧の書き方で形を変えられます。
| 書き方 | 形 | 使い方の例 |
|---|---|---|
A[文字] | 四角 | サーバー、ファイアウォール |
A((文字)) | 円 | インターネット |
A[(文字)] | 円柱 | データベース |
flowchart と architecture-beta の違い
| 比べること | flowchart | architecture-beta |
|---|---|---|
| 記法 | 安定 | ベータ |
| アイコン | なし | あり |
| ポート番号のラベル | 書ける | 書ける |
| 日本語のラベル | 11.12.2 でも通る | 11.12.2 ではエラー |
| ハイフンを含むラベル | 通る | 11.12.2 ではエラー |
社内の文書やブログなど、表示する環境の Mermaid を選べない場所では flowchart を使います。architecture-beta は、アイコン付きの見た目が欲しくて、表示する環境の Mermaid のバージョンが分かっているときに使うのが良いと思います。
IP アドレスや VLAN を書く
subgraph の名前にネットワークのアドレスを、ノードの中に <br/> で IP アドレスを書きます。記号を含む名前は " で囲みます。
mermaidflowchart TB
Internet((インターネット))
FW[ファイアウォール]
subgraph DMZ["DMZ 10.0.1.0/24"]
LB[ロードバランサー<br/>10.0.1.10]
end
subgraph APP["VLAN 20 アプリ 10.0.20.0/24"]
Web1[Web 1<br/>10.0.20.11]
Web2[Web 2<br/>10.0.20.12]
end
subgraph DATA["VLAN 30 データ 10.0.30.0/24"]
DB[(DB<br/>10.0.30.21)]
end
Internet -->|443| FW
FW -->|443| LB
LB -->|8080| Web1
LB -->|8080| Web2
Web1 -->|3306| DB
Web2 -->|3306| DB
冗長構成を書く
点線で待機系の経路を、<-.-> で機器同士の通信を表します。
mermaidflowchart LR
Internet((インターネット))
subgraph LBs[ロードバランサー]
LB1[LB 稼働系]
LB2[LB 待機系]
end
Web[Web サーバー × 20]
subgraph DBs[データベース]
DB1[(プライマリ)]
DB2[(レプリカ × 3)]
end
Internet --> LB1
Internet -.-> LB2
LB1 <-.->|VRRP| LB2
LB1 --> Web
LB2 -.-> Web
Web --> DB1
Web --> DB2
DB1 -->|レプリケーション| DB2
横向きの LR で列が増えると、全体が縮小されて文字が小さくなります。この図は幅784ピクセル、高さ108ピクセルまで縮みました。読みにくいときは TB にするか、まとめる単位を増やします。
台数が多い構成を書く
1つにまとめて台数を書きます。Web サーバー20台、データベース4台を1台ずつ線でつなぐと、幅784ピクセルに対して高さが約1,400ピクセルになり、線が重なってたどれません。
まとめて書くと、幅640ピクセル、高さ309ピクセルに収まります。
mermaidflowchart LR
LB[LB]
subgraph W[Web サーバー × 20]
W1[Web 1]
Wn[Web 20]
end
subgraph D[DB × 4]
D1[(DB 1)]
Dn[(DB 4)]
end
LB --> W
W --> D
architecture-beta で書く
Mermaid 11.1.0 以降で使える図で、まだベータです。記法は後方互換なしに変わることがあります。
mermaidarchitecture-beta
group private(cloud)[Private]
service internet(internet)[Internet]
service lb(server)[LB]
service web(server)[Web] in private
service db(database)[DB] in private
internet:R --> L:lb
lb:R --> L:web
web:R --> L:db
標準のアイコンは cloud、database、disk、internet、server です。線をつなぐ向きは R(右)、L(左)、T(上)、B(下)で指定します。
線のラベルは -[443]-> のように書きます。
textarchitecture-beta
service a(server)[A]
service b(server)[B]
a:R -[443]-> L:b
1つのノードから複数に分けるときは junction を使います。
textarchitecture-beta
group vpc(cloud)[VPC]
service lb(server)[LB] in vpc
service web1(server)[Web1] in vpc
service web2(server)[Web2] in vpc
junction j in vpc
lb:R --> L:j
j:T --> B:web1
j:B --> T:web2
注意点
参考文献
著書
使い方Claude Code が書いた Mermaid の図を表示する方法: ファイルに書かせて、VS Code で開く
使い方Mermaid CLI(mmdc)のインストールと使い方: 10枚の図は、1つの Markdown にまとめると4倍速く書き出せた
使い方Mermaid のシーケンス図の書き方: 非同期の処理は、矢印を -) に変えるだけで書き分けられる
検証・比較Mermaid と PlantUML の違い: 同じ図を両方で書くと、行数はほぼ同じ。差は準備と書き出しに出た
使い方VS Code で Mermaid の図をプレビューする手順: 1.121 以降は拡張機能なしで表示できる
使い方Mermaid でネットワーク構成図を書く手順: flowchart と architecture-beta の書き方
使い方OpenCode を Ollama のローカル LLM で動かす設定: コードを外に送らずに、テストまで通った
使い方OpenCode の使い方と料金: ログインなしで、無料のモデルが動いた。Go と Zen の違い
使い方Claude Code が書いた Mermaid の図を表示する方法: ファイルに書かせて、VS Code で開く
挙動Codex の履歴の確認と削除: 消したあとも、頼みごとの文は別のファイルに残っていた
使い方MCP サーバーを入れる前のセキュリティチェック: 何ができるサーバーかは、つなぐ前に見られる
使い方Codex CLI の使い方: 入れてから最初の作業まで。codex exec が止まって見える理由

