メインコンテンツへスキップ
見出し画像
Photo byaicolumnwriter

WordPressのローカル開発環境、DBだけNASに置いたら複数Mac問題が全部解決した

    複数Macで開発するときのジレンマ

    フリーランスや小規模な制作会社でよくある話です。自宅のMacと外出先のMacBook、どちらでも同じWordPress環境で作業したい。でも、LocalやMAMPでローカル環境を作ると、DBのデータが片方のMacにしかない。

    毎回エクスポート・インポートするのも面倒だし、「どっちが最新だっけ?」問題も起きる。

    今回はこの問題を、DBだけSynology NASに置くという方法で解決しました。ファイルはDropboxで同期、サーバーはLaravel Herdというシンプルな構成です。

    使用環境

    • Mac:MacBook Air(Apple Silicon)

    • ローカルサーバー:Laravel Herd / PHP 8.4

    • ファイル管理:Dropbox

    • NAS:Synology DS923+ / DSM 7.3.2

    • DB:MariaDB 10.11(NAS上)

    • ルーター:NTT NSD-G3000T

    • 外部アクセス:DDNS(Synology提供)

    「NASにWordPressごと入れればいいのでは?」

    真っ先に出てくる意見です。SynologyのWeb Stationを使えば確かにNAS上でWordPressを動かせます。レンタルサーバーも同様です。

    でも、あえてDBだけNASに置いてファイルはMacローカルに持ちます。その理由はローカルにファイルがあることの開発体験が全然違うからです。

    VS Codeで直接編集できる
    NAS上のファイルをエディタで編集しようとすると、SFTPやネットワークドライブ経由になりレスポンスが遅くなりがちです。ローカルならVS Codeで即座に開いて、保存した瞬間にブラウザに反映されます。

    ターミナルからwp-cliを直接実行できる
    プラグインのインストール、ユーザー管理、DB操作など、wp-cliのコマンドをそのままターミナルから実行できます。NAS上のWordPressだとSSH経由の操作になり、地味に手間がかかります。

    オフラインでもファイル作業ができる
    DBへの接続が必要な操作はできませんが、テンプレートの編集やCSSの調整など、ファイルだけで完結する作業はネットワーク不要で行えます。新幹線の中でも作業できます。

    AIエージェントとの相性がいい
    Claude CodeなどのAIエージェントはローカルファイルを直接読み書きしてコードを生成・修正します。ファイルがローカルにあることで、AIとの協働開発がそのままできます。

    構成の全体像

    WordPressのファイル一式はDropboxに置き、Herdがそのフォルダをローカルサーバーとして配信します。DBへの接続先はNASのIPアドレスまたはDDNSを指定するだけです。新しいMacでも、DropboxとHerdを入れて herd link コマンドを実行すれば、すぐに同じ環境が立ち上がります。

    STEP 1|NASのMariaDBを準備する

    MariaDB 10のインストール

    DSM → パッケージセンター → 「MariaDB 10」をインストールして起動。インストール後はrootパスワードを必ず設定しておきます。

    画像

    phpMyAdminでDB・ユーザーを作成

    SynologyにはphpMyAdminパッケージがあり、GUIで操作できます。DDNSがあれば外部からもアクセス可能です。

    画像

    データベース作成時の注意点として、照合順序は必ず utf8mb4_unicode_ci を選ぶこと。デフォルトの utf8mb3 だと絵文字や一部の特殊文字が保存できません。最初から utf8mb4 にしておくことをおすすめします。

    ユーザー作成では、ホスト名を %(すべてのホスト)にします。接続元の制限はSynologyのファイアウォール側でまとめて管理する方針にした方がシンプルです。作成後、対象のDBに対してすべての権限を付与しておきます。

    画像

    STEP 2|HerdにサイトをLinkする

    Herdとは

    Laravel Herdは、Mac向けのローカル開発環境ツールです。nginxとPHPをネイティブで動かすので、Dockerより軽快で設定も少ない。.test ドメインが自動で使えるのも便利です。

    Dropbox内のフォルダを登録する

    Herdはデフォルトの ~/Herd/ 以外のフォルダも登録できます。

    bash
    cd /path/to/public_html
    herd link mysite

    これだけで https://mysite.test が使えるようになります。登録済みサイトの確認は herd links で行えます。

    STEP 3|WordPressをインストールする

    wp-cliのdownloadコマンドはDropboxフォルダのパスに日本語が含まれるとエラーになることがあります。curlで直接ダウンロードする方が安定していました。

    bash
    curl -L https://ja.wordpress.org/latest-ja.zip -o /tmp/wp.zip && 
    unzip /tmp/wp.zip -d /tmp/ && 
    mv /tmp/wordpress/* . && 
    rm -rf /tmp/wordpress /tmp/wp.zip

    STEP 4|外部からDBに接続する(2つの方式)

    外出先のMacからNASのMariaDBに接続する方法は2つあります。

    方式A:DDNS直接接続(VPN不要)

    SynologyのDDNSを使い、3306番ポート経由でDBに直接接続します。VPN不要なので手軽です。

    wp-config.phpのDB_HOSTには your-ddns.synology.me:3306 を指定します。

    セキュリティ対策は必須です。 3306番ポートをインターネットに直接公開するため、Synologyのファイアウォールで接続元IPを絞ります。

    画像

    NSD-G3000Tの管理画面(http://192.168.x.1)→ 接続設定 → ポートマッピング設定から、TCPの3306番ポートをNASのIPに転送する設定を追加します。

    画像
    画像

    次にDSM → コントロールパネル → セキュリティ → ファイアウォール → 編集で、以下の順番でルールを追加します。

    1. TCPの3306番、自宅のグローバルIPからの接続を「許可」

    2. TCPの3306番、会社のグローバルIPからの接続を「許可」

    3. TCPの3306番、すべてのIPからの接続を「拒否」

    ルールの順番が重要です。上から順に評価されるので、許可ルールを先に置いてください。自宅のグローバルIPは

    curl ifconfig.me

    で確認できます。

    NuroなどIPが変動しにくい回線なら、この方式で十分実用的です。IPが変わったときだけファイアウォールのルールを更新すればOKです。

    方式B:VPN経由接続(よりセキュア)

    Synology VPN Serverを使ってL2TP/IPSec VPNを構築します。macOSが標準対応しているため、Mac側に追加アプリは不要です。

    画像

    NSD-G3000TのポートマッピングでUDPの500、4500、1701番をそれぞれNASに転送します。Mac側はシステム設定 → ネットワーク → VPN構成を追加 → L2TP over IPSecを選択して、サーバアドレス(DDNSのドメイン)・アカウント名・パスワード・事前共有キーを入力します。

    画像

    ハマりポイント: 「すべてのトラフィックをVPN接続経由で送信」にチェックを入れないと、VPN接続しているのにNASに到達できません。必ずチェックを入れてください。

    画像

    この方式のwp-config.phpはDB_HOSTにNASのローカルIPを指定します。

    どちらを選ぶかについては、IPが変動しにくい回線(NuroやNTT光など)であれば方式Aのシンプルさが魅力です。IPが頻繁に変わる環境や、複数の外出先から接続する場合は方式BのVPNの方が安定します。

    参考:Laravel Herd 主要コマンド

    日常的によく使うコマンドをまとめておきます。

    サイト管理

    • herd link [名前]:現在のフォルダをサイトとして登録

    • herd unlink [名前]:サイトの登録を解除

    • herd links:登録済みサイトの一覧表示

    • herd open:現在のサイトをブラウザで開く

    • herd secure:現在のサイトをHTTPS化

    • herd unsecure:HTTPSを解除

    サービス管理

    • herd start:すべてのサービスを起動

    • herd stop:すべてのサービスを停止

    • herd restart:すべてのサービスを再起動

    PHP管理

    • herd use php@8.4:グローバルのPHPバージョンを変更

    • herd isolate php@8.1:現在のサイトのみPHPバージョンを変更

    • herd unisolate:サイト個別のPHPバージョン指定を解除

    herd isolate はクライアント案件で古いWordPressを扱うときに特に便利です。PHP 8.1のサイトとPHP 8.4のサイトを同時に動かせます。

    ログ確認

    • herd log:nginxのアクセスログをリアルタイム表示

    • herd log --type=php:PHPのエラーログをリアルタイム表示

    • herd log --type=nginx-error:nginxエラーログをリアルタイム表示

    エラーが出たときは herd log --type=php でリアルタイム監視しながらデバッグするのが効率的です。

    新規プロジェクト追加のチェックリスト

    慣れてしまえば、新規プロジェクトの追加は15〜20分で完了します。

    1. Dropbox に public_html フォルダ作成

    2. phpMyAdmin で新しいDB作成・wp_user に権限付与

    3. herd link 新サイト名 でHerdに登録

    4. curl でWordPressダウンロード

    5. wp config create で wp-config.php 作成

    6. ブラウザでWordPressインストール完了

    まとめ

    「複数Macで同じDB」という課題をNAS上のMariaDBで解決し、ファイルはDropbox+Herdでローカル管理するという構成は、Web制作フリーランスにとってかなり実用的な選択肢だと思います。

    NASにWordPressごと乗せてしまう方法と比べると手間はかかりますが、VS Codeで直接編集・wp-cliをそのまま使える・AIエージェントとも連携できる、というローカル開発ならではの快適さはやはり手放せません。

    初回構築さえ乗り越えれば、あとは同じ手順の繰り返しです。NASをお持ちのWeb制作者の方はぜひ試してみてください。

     
     
    株式会社マジカルリミックス 代表取締役CEO 専門学校デジタルアーツ仙台 非常勤講師、仙台商工会議所窓口専門家、エキスパート・バンク登録専門家、みやぎ産業産業振興機構 登録専門家 クレジットカード70枚持ち。

    あなたへのおすすめ