WordPressとWebアプリの同居

WordPress をベースに Flask と JavaScript アプリを /ntsapps 配下で動かす

はじめに

VPS で WordPress を運用していると、サーバーの余裕があるなら、個人開発の Web アプリも同居させられないかと考えることがあります。

特に、別途サーバーを用意するコストを抑えたいときには、既存の WordPress をそのまま維持しながら、追加したいアプリを同じ VPS 上で安全に運用したいという要件が出てきます。記事運営と個人開発を同じ環境で続けたい――そのようなケースでは、WordPress を / に置きつつ、アプリ群を /ntsapps/ 配下にまとめて置く設計を検討して実施しました。

今回は、WordPress をルートで運用しながら、Flask API を /ntsapps/api/、JavaScript フロントエンドを /ntsapps/photos/ に置く構成を紹介します。記事の公開と個人開発を同じドメインで共存させるための設計と、Nginx / Docker を使った実装の考え方を整理していきます。

今回の前提は次のとおりです。

  • WordPress を現在の構成のまま維持する
  • 追加アプリは /ntsapps/ 配下に配置する
  • API は Flask で /ntsapps/api/ に出す
  • フロントエンドは Vanilla JavaScript で /ntsapps/photos/ に配置する
  • Nginx を入口として、URL ごとに振り分ける
  • Nginx 自体は Docker で動かす
  • WordPress 用の MySQL は別コンテナで管理する
  • Flask 用の MySQL も別コンテナで管理する

構成の全体像

今回の構成は、公開用の入口を Nginx が受け取り、URL に応じて適切なバックエンドへ振り分ける形です。

Internet
   |
   v
Nginx (Docker)
   |-- /                -> WordPress
   |-- /ntsapps/api/    -> Flask API
   |-- /ntsapps/photos/ -> JavaScript frontend

WordPress (Docker)
   +-- wordpress-db (MySQL Docker)

Flask (Docker)
   +-- flask-db (MySQL Docker)

この構成のポイントは、WordPress と追加アプリを URL 空間で分離しながら、1 つのドメインで共存させることです。特に、WordPress 用の MySQL と Flask 用の MySQL をそれぞれ別コンテナに分けている点は、運用の自由度を高めるうえで重要になります。


なぜ /ntsapps/ 配下に置くのか

WordPress は CMS として非常に強力ですが、アプリケーションを追加する場面では URL の競合やパスの衝突を避ける必要があります。

/ntsapps/ を専用の名前空間として使うと、次のようなメリットがあります。

  • WordPress のルート / を壊さずに済む
  • アプリの URL が明快で管理しやすい
  • Nginx でのルーティングが簡潔になる
  • 将来的なアプリ追加にも対応しやすい

特に WordPress の記事ページと、管理画面やデータ閲覧画面が同一ドメインにある場合、URL 設計はとても重要です。/ntsapps/ のような明確なプレフィックスを確保しておくと、仕事としての運用と個人開発としての運用を自然に分離できます。


URL 設計の例

想定する URL は次のとおりです。

  • https://funaori.com/ → WordPress
  • https://funaori.com/ntsapps/ → 追加アプリの入口
  • https://funaori.com/ntsapps/api/ → Flask API
  • https://funaori.com/ntsapps/api/health → Flask のヘルスチェック
  • https://funaori.com/ntsapps/photos/ → JavaScript アプリの入り口
  • https://funaori.com/ntsapps/photos/assets/... → 静的アセット

このようにすると、利用者側からはシンプルなドメインに見えますが、裏側では WordPress とアプリがきちんと分離されています。結局、見た目のシンプルさと、運用のしやすさを両立できる設計です。


Nginx の役割

Nginx はこの構成の最前線です。

  • 全リクエストを受け取る
  • パスごとに振り分ける
  • WordPress は / で処理する
  • Flask API は /ntsapps/api/ で受ける
  • JavaScript アプリは /ntsapps/photos/ を静的ファイルとして配信する

次は、Nginx の設定例です。

server {
    listen 80;
    server_name funaori.com;

    location /ntsapps/api/ {
        proxy_pass http://flask:5000/;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }

    location /ntsapps/photos/ {
        alias /usr/share/nginx/html/photos/;
        try_files $uri $uri/ /ntsapps/photos/index.html;
        index index.html;
    }

    location / {
        proxy_pass http://wordpress:80;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

location / が広い範囲を持つため、より具体的な /ntsapps/... を先に定義しておく必要があります。/ntsapps/api や /ntsapps/photos が WordPress 側へ流れてしまうと、意図した分離ができません。


Flask をサブディレクトリ配下で動作させるためのポイント

Flask でアプリをサブディレクトリ配下で動かす場合、公開 URL と Flask 内部のルートを分離して扱うことが必要です。今回の構成では、API を /ntsapps/api 配下で動かすために、Blueprint を登録する際に url_prefix を指定しています。

# ntsapp/__init__.py
app.register_blueprint(routes_bp, url_prefix="/ntsapps/api")

この設定により、ntsapp/routes.py に定義されたルートはすべて /ntsapps/api/ の下で公開されます。

たとえば次のようなルートがあったとします。

# ntsapp/routes.py
@routes_bp.route('/health')
def health():
    return jsonify({"status": "ok"})

この場合、実際のアクセス先は次のようになります。

https://funaori.com/ntsapps/api/health

重要なポイント

  • Blueprint を url_prefix="/ntsapps/api" で登録する
  • Flask の内部ルートは通常の /health のまま定義できる
  • Nginx 側で /ntsapps/api/ を Flask に転送する
  • 外部 URL と内部ルートの責務が分離されるため、運用しやすい

この設計は、WordPress と同じドメイン上で API を運用したい場合に特に有効です。Nginx が /ntsapps/api/ を Flask に転送し、Flask がその内部パスを解釈することで、URL とアプリの責務が自然に分離されます。


フロントエンドは静的ファイルとして配信する

今回の構成では、フロントエンドは Vanilla JavaScript アプリとして扱い、ビルド後の静的ファイルを Nginx から配信します。特別なフレームワークを使わずに済むので、個人開発の小さなアプリにはとても向いています。

構成例は次のとおりです。

/ntsapps/photos/
├── index.html
├── main.js
├── styles.css
└── assets/
    └── images/

index.html は通常次のような形になります。

<!DOCTYPE html>
<html lang="ja">
<head>
  <meta charset="UTF-8" />
  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
  <title>Photos App</title>
  <script defer src="./main.js"></script>
</head>
<body>
  <div id="app"></div>
</body>
</html>

JavaScript 側から Flask API を呼び出すイメージは次のとおりです。

fetch('/ntsapps/api/health')
  .then(response => response.json())
  .then(data => {
    document.getElementById('app').textContent = data.status;
  })
  .catch(error => {
    console.error('API error:', error);
  });

このようにしておくと、フロントエンドはサーバーサイドのテンプレートエンジンを使わず、API との連携に集中できます。


Flask API の設計

Flask は API サーバーとして動かし、WordPress とは分離された層として設計します。API では、画像一覧の取得、検索、アップロード処理、メタデータ取得などを担当させると、運用しやすくなります。

例: Flask アプリの最小構成は次のようになります。

from flask import Flask, jsonify

app = Flask(__name__)

@app.route('/health')
def health():
    return jsonify({"status": "ok"})

@app.route('/api/photos')
def list_photos():
    return jsonify({
        "items": [
            {"id": 1, "name": "sample.jpg"}
        ]
    })

if __name__ == '__main__':
    app.run(host='0.0.0.0', port=5000)

Flask には WordPress のテンプレートやテーマのロジックは持たせず、純粋に API とデータ処理に集中させるのがよいです。


Docker での構成例

今回は、各コンポーネントを Docker で分離して管理する構成を想定します。WordPress 用の MySQL と Flask 用の MySQL は、それぞれ別の Docker コンテナとして持つ構成です。

version: '3.9'

services:
  nginx:
    image: nginx:latest
    ports:
      - "80:80"
    volumes:
      - ./nginx/conf.d:/etc/nginx/conf.d:ro
      - ./ntsapps/photos:/usr/share/nginx/html/photos:ro
    depends_on:
      - wordpress
      - flask

  wordpress:
    image: wordpress:latest
    environment:
      WORDPRESS_DB_HOST: wordpress-db
      WORDPRESS_DB_NAME: wordpress
      WORDPRESS_DB_USER: wordpress
      WORDPRESS_DB_PASSWORD: wordpresspass
    volumes:
      - ./wordpress:/var/www/html
    depends_on:
      - wordpress-db

  wordpress-db:
    image: mysql:8.0
    environment:
      MYSQL_DATABASE: wordpress
      MYSQL_USER: wordpress
      MYSQL_PASSWORD: wordpresspass
      MYSQL_ROOT_PASSWORD: rootpass
    volumes:
      - wordpress_db_data:/var/lib/mysql

  flask:
    build:
      context: ./ntsapps/api
    environment:
      FLASK_ENV: production
      DATABASE_URL: mysql+pymysql://app:<password>@flask-db/app
    depends_on:
      - flask-db

  flask-db:
    image: mysql:8.0
    environment:
      MYSQL_DATABASE: app
      MYSQL_USER: app
      MYSQL_PASSWORD: apppass
      MYSQL_ROOT_PASSWORD: rootpass
    volumes:
      - flask_db_data:/var/lib/mysql

volumes:
  wordpress_db_data:
  flask_db_data:

この構成のメリットは、WordPress と Flask のデータや設定が分離されている点です。特に wordpress-db と flask-db を別コンテナにしていることで、WordPress 側の DB 改修やバックアップ、Flask 側のデータ管理が互いに干渉しにくくなります。


WordPress と共存するときの注意点

1. ルート / の WordPress を壊さない

WordPress のトップページ、記事ページ、管理画面はルートで運用されるため、/ntsapps などの追加用パスを確保しておくことが重要です。

2. location の設定順序を固定する

Nginx はパスの一致順に影響されます。location / が先に来ると、アプリ用の /ntsapps/... が WordPress 側へ流れてしまう可能性があるため、より具体的なパスを先に定義する設計にします。

3. 相互接続の設計を明確にする

JavaScript から API を呼ぶとき、相対パスと絶対パスのどちらを使うかで、運用やデプロイ時にトラブルが出ます。/ntsapps/api/... のように固定パスにしておくのが簡潔です。

4. ファイルやデータの保存先を分ける

Flask が扱うデータと WordPress のデータは、責務ごとに分離して管理するのが安全です。特に、画像やアップロードデータを WordPress 側にまとめて依存させると、管理が複雑になりやすいため、API で扱うデータは API 側で整理しておくとよいです。


運用上の設計思想

この構成では、責務ごとに役割を分けることが重要です。

  1. WordPress は記事とサイト本体の管理に専念する
  2. Flask は API とデータ処理に専念する
  3. JavaScript は画面表示と API 呼び出しに専念する
  4. Nginx は公開入口として統制する
  5. データの保存先は用途ごとに分けて管理する

責務がはっきりしているほど、アップデートや障害時の影響範囲が見えやすくなります。


まとめ

WordPress をそのまま残しながら、追加アプリを /ntsapps/ 配下で運用する構成は、既存サイトを壊さずに機能を拡張したいときに現実的な選択肢です。特に VPS で運用している場合、別途専用サーバーを用意しなくても、既存の環境を活かして個人開発の Web アプリを同居させられます。

今回の構成では次の方針で設計されています。

  • / → WordPress
  • /ntsapps/api/ → Flask API
  • /ntsapps/photos/ → Vanilla JavaScript フロントエンド
  • Nginx → パスベースの振り分け
  • Docker → 各サービスの分離運用
  • MySQL → WordPress と Flask 用に分離
  • データの責務を分離して管理する

WordPress の運用を保ちながら、アプリ本体を安全に追加し、保守性と拡張性を両立できる構成です。


さいごに

サブディレクトリ配下で Web アプリを運用する設計は、既存 WordPress サイトにとって非常に現実的かつ拡張性のある選択肢です。Nginx を入口に置き、WordPress と Flask と JavaScript を責務ごとに分けることで、将来的な機能追加や保守が容易となる構成にできたとおもっております。