T-CREATOR

<div />

Mermaid でネットワーク構成図を書く手順: flowchart と architecture-beta の書き方

2026年11月3日
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 の違い

比べることflowchartarchitecture-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ピクセルになり、線が重なってたどれません。

Web サーバー20台とデータベース4台の線が重なった図

まとめて書くと、幅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

注意点

参考文献

著書

とあるクリエイター

フロントエンドエンジニア Next.js / React / TypeScript / Node.js / Docker / AI Coding

とあるクリエイターのプロフィール