phpfpm/CHANGELOG-8.5.2-a.md

Changelog - Version 8.5.2-a

新機能

リアルIP転送機能の追加

ベアメタルKubernetesクラスターやLoadBalancer環境において、PHP側で訪問者の実IPアドレスを取得できる機能を追加しました。

主な変更点

1. values.yaml

   • nginx.forwardRealIP セクションを追加
   • enabled: リアルIP取得機能の有効/無効
   • header: リアルIPを取得するHTTPヘッダー名（デフォルト: X-Forwarded-For）
   • recursive: 再帰的にリアルIPを検索（多段プロキシ対応）
   • trustedProxies: 信頼するプロキシのネットワーク範囲
   • additionalTrustedProxies: 環境に応じた追加プロキシ設定

2. templates/configmap.yaml

   • Nginx の http セクションにリアルIP設定を追加
   • real_ip_header, real_ip_recursive, set_real_ip_from ディレクティブを実装
   • PHP-FPM へ渡す fastcgi_param にリアルIP情報を追加
   • 既存の customConfig.snippet と競合しない構造

3. README.md

   • リアルIP転送機能の設定パラメータ表を追加
   • 例7としてベアメタル環境でのリアルIP取得の使用例を追加
   • 検証用PHPコード例を追加

4. examples/test-real-ip.php (新規作成)

   • リアルIP転送設定の動作確認用テストスクリプト
   • WebUIで各種IP関連変数を確認可能
   • 診断機能付き

技術詳細

Nginx設定

# HTTP-levelで設定
real_ip_header X-Forwarded-For;
real_ip_recursive on;
set_real_ip_from 10.0.0.0/8;
set_real_ip_from 172.16.0.0/12;
set_real_ip_from 192.168.0.0/16;

# PHP-FPMへ渡すパラメータ
fastcgi_param REMOTE_ADDR $remote_addr;
fastcgi_param HTTP_X_REAL_IP $remote_addr;
fastcgi_param HTTP_X_FORWARDED_FOR $proxy_add_x_forwarded_for;

PHPでの利用

// リアルIPアドレスの取得
$realIP = $_SERVER['REMOTE_ADDR'];

互換性

• 既存の nginx.customConfig.snippet 機能と完全に互換性あり
• デフォルトは enabled: false のため、既存環境への影響なし
• 有効化時のみ、リアルIP取得ロジックが動作

セキュリティ

• trustedProxies には信頼できるプロキシのみを指定してください
• 不正なプロキシを信頼すると、IPスプーフィング攻撃のリスクがあります

使用例

# values.yaml
nginx:
  forwardRealIP:
    enabled: true
    header: "X-Forwarded-For"
    recursive: true
    trustedProxies:
      - "10.0.0.0/8"
      - "172.16.0.0/12"
      - "192.168.0.0/16"
    additionalTrustedProxies:
      - "203.0.113.0/24"  # 外部LoadBalancerのIPレンジ

検証方法

1. examples/test-real-ip.php を /var/www/html/ に配置
2. ブラウザでアクセス: http://your-service/test-real-ip.php
3. REMOTE_ADDR にパブリックIPが表示されることを確認

---

リリース日: 2026-02-10 担当: プロサーバーエンジニア（Claude）