ALBでドメイン統合！URL・ホストヘッダー書き換えをTerraformコードで設定してみた

2026年1月4日2026年1月7日

Contents

1 はじめに
2 背景
3 フローチャート
4 前提条件
5 Terraformコード
6 EC2側設定（Apache）
7 利点
8 欠点
9 まとめ

はじめに

2025年10月のアップデートにより、ALBでURLとホストヘッダーの書き換えが可能となりました。

今回は、アップデートされた機能を使用したTerraformコードをもとに、どのような点で便利になったのか解説します。

背景

解説を進めていく中で解決したい課題を先に提示した方がわかりやすいため、背景として先に解決したい課題を記載します。

SEO評価（ドメインパワー）の維持と最大化
- 別ドメイン（example.net）のコンテンツを、評価の高い既存ドメイン（example.com）のサブディレクトリとして公開することで、既存のSEO資産を有効活用したい。
ユーザー体験（UX）の統一
- コンテンツの実体が別ドメインであっても、ユーザーのブラウザ表示URLを固定し、サイト移動による違和感を与えたくない。

※わかりにくいので補足

ユーザーから見えるサイトアドレス
- example.com/example-path
裏側での処理
- example.com/example-path → example.net/example-pathへホストヘッダーを変換します。
- ユーザーには、example.com/example-pathのアドレスでexample.net/example-pathサイトを表示します。

フローチャート

簡単なフローチャートを用意しました。
参考になれば幸いです。

前提条件

「ALBでURLとホストヘッダーの書き換え」についてのTerraformコード部分のみ抜粋するため、Terraformの基礎的な知識がある前提としています。
AWS各コンポーネントの周辺知識は、解説しません。
EC2側でApacheを利用しており、ヘッダー書き換え部分のみの紹介にとどめ、周辺知識の解説はしません。

Terraformコード

Terraformを使用してAWS Application Load Balancer（ALB）のリスナールールを設定する例です。

特定のドメイン名やパスに一致するリクエストを検知し、転送先のターゲットグループへ書き換え処理（URL・ホスト名のリライト）を定義する内容になっています。

警告

Terraform AWSプロバイダーバージョン6.19.0以降で利用可能となっています。

試す際には、Terraform AWSプロバイダーのバージョンを確認するようにしてください。

# ALBリスナールールの例: 特定ホスト/パスへのリクエストを別ドメイン・パスへ書き換えて転送
resource "aws_lb_listener_rule" "example_rule" {
  # 適用するリスナーのARNと評価順序を指定
  listener_arn = aws_lb_listener.example.arn
  priority     = 50

  # 転送アクション: マッチしたリクエストを指定ターゲットグループへフォワード
  action {
    type             = "forward"
    target_group_arn = aws_lb_target_group.example.arn
  }

  # 条件1: Hostヘッダーが example.com / www.example.com に一致
  condition {
    host_header {
      regex_values = ["^(www\\.)?example\\.com$"]
    }
  }

  # 条件2: パスが /example-path から始まるものに一致
  condition {
    path_pattern {
      regex_values = ["^\\/example-path"]
    }
  }

  # 変換1: Hostヘッダーを書き換え (例: example.com -> example.net)
  transform {
    type = "host-header-rewrite"

    host_header_rewrite_config {
      rewrite {
        regex   = "^(www\\.)?example\\.com$"
        replace = "example.net"
      }
    }
  }

  # 変換2: パスを書き換え (例: /example-path* -> /example-path*)
  transform {
    type = "url-rewrite"

    url_rewrite_config {
      rewrite {
        regex   = "^\\/example-path"
        replace = "/example-path"
      }
    }
  }
}