Windows 11＋DockerでMySQL起動｜A5:SQL Mk-2接続手順 | Snow System

Windows 11のWSL2環境でDockerコンテナを動かし、データベースとしてMySQLを構築してWindows側のGUIツールから操作したいケースは非常に多くあります。

GUIクライアントとして長年定番の「A5:SQL Mk-2」を利用する場合、初期のWindows 10や初期WSL2環境では「localhostで接続できない」「eth0のIPアドレスを調べる必要がある」といった特有のネットワークトラブルが発生しがちでした。

本記事では、最新のWindows 11＋WSL2環境をベースに、Docker Composeを使ってMySQL（最新のMySQL 8.0/8.4対応）をコンテナとして立ち上げ、Windows側にインストールしたA5:SQL Mk-2から快適に直接接続する手順を分かりやすく解説します。

WSL2＋Docker＋A5:SQL Mk-2の環境構成
事前準備と前提条件
Docker ComposeでMySQLコンテナを起動する
Windows側のA5:SQL Mk-2から接続する手順
トラブルシューティング：接続できない場合のチェックポイント
まとめ：Windows 11とWSL2の組み合わせで快適なDB開発環境を作る
参考情報
次に読むおすすめ記事

WSL2＋Docker＋A5:SQL Mk-2の環境構成

今回の構築イメージは以下の通りです。

WSL2のLinuxディストリビューション（Ubuntu等）上でDocker Engineを動かし、MySQLコンテナのポートをホストにマッピングします。

Windows 11のWSL2では、デフォルトでローカルループバックアドレス（localhost / 127.0.0.1）の自動ポートフォワーディングが機能するため、Windows上で動作するA5:SQL Mk-2から localhost:3306（または任意の指定ポート）で直接接続できます。

事前準備と前提条件

本手順を進める前に、以下の環境が整っていることを確認してください。

Windows 11マシンでWSL2が有効化されていること
WSL2上のUbuntuにDocker EngineおよびDocker Composeが導入されていること
Windows側にA5:SQL Mk-2がダウンロード・展開されていること

Docker EngineやComposeがまだインストールされていない場合は、後述の関連ガイドを参考にセットアップを済ませてください。

Docker ComposeでMySQLコンテナを起動する

MySQLコンテナの起動には、設定ファイル1つでコンテナの定義やデータ永続化を一元管理できるDocker Compose（Compose v2）を利用します。

1. 作業ディレクトリとcompose.yamlの作成

WSL2のホームディレクトリ配下に任意の作業用フォルダを作成し、その中に compose.yaml を作成します。

mkdir -p ~/docker-mysql
cd ~/docker-mysql
nano compose.yaml

ファイルの内容として以下を記述します。

services:
  mysql_test:
    image: mysql:8.0
    container_name: mysql_test
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: your_root_password
      MYSQL_DATABASE: mydb
      MYSQL_USER: testuser
      MYSQL_PASSWORD: testpassword
    ports:
      - "3306:3306"
    volumes:
      - db_data:/var/lib/mysql

volumes:
  db_data:

設定項目のポイントは以下の通りです。

image: 最新の安定版である mysql:8.0（または mysql:8.4）を指定します。
environment: ルートパスワードや作成したい初期データベース名、一般ユーザー名とパスワードを環境変数で定義します。
ports: "3306:3306" でホストマシンの3306番ポートとコンテナの3306番ポートを紐付けます。もしWindows側ですでにローカルMySQLが3306番を使っている場合は、"9999:3306" などの別ポートに変更してください。
volumes: db_data ボリュームを定義し、コンテナを再起動・破棄してもデータが消去されないように永続化します。