本文へスキップ
サーバー設定

NginxとApacheでM3U8のCORSを設定する方法

オリジン間リソース共有(CORS)のエラーは、ブラウザーでHLSを再生できない主な原因の一つです。M3U8マニフェスト、TS/fMP4セグメント、WebVTT字幕を配信するためのNginxとApacheの設定を説明します。

ブラウザーでM3U8ストリームを再生するとき、hls.jsやVideo.js、HTML5動画プレーヤーは非同期のHTTPリクエスト(XHRまたはFetch API)でマニフェストとメディアセグメントを取得します。動画ファイルのドメイン、サブドメイン、ポートのいずれかがプレーヤーのあるページと異なる場合、ブラウザーのセキュリティ制約によりCORS(オリジン間リソース共有)のチェックを通過する必要があります。

HLSで起こるCORSの問題

適切なCORSヘッダーがないと、ブラウザーはJavaScriptプレーヤーによるM3U8ファイルの読み取りをブロックします。URLをアドレスバーに貼り付ければファイルをダウンロードできても、Webプレーヤーでは次のようなコンソールエラーが出ます。

Access to XMLHttpRequest at 'https://cdn.example.com/stream.m3u8' from origin 'https://www.yoursite.com' has been blocked by CORS policy: No 'Access-Control-Allow-Origin' header is present on the requested resource.

解決するには、配信サーバーまたはCDNから所定のHTTPヘッダーを返し、プレーヤーのドメインによるファイルの読み取りを明示的に許可します。

必要なCORSヘッダー

安定した再生のために、サーバーは`.m3u8`、`.ts`、`.mp4`、`.m4s`、`.vtt`、`.key`の各ファイルを配信する際、次のヘッダーを返す必要があります。

  • Access-Control-Allow-Origin:アクセスできるオリジンを指定します。公開ストリームなら*、限定公開ならhttps://www.yoursite.comのように正確なオリジンを指定します。
  • Access-Control-Allow-Methods:許可するHTTPメソッド(例:GET, HEAD, OPTIONS)を指定します。
  • Access-Control-Allow-Headers:許可するリクエストヘッダーを指定します。HLSプレーヤーはカスタムヘッダーのほか、RangeやAcceptなどを送ることがあります。
  • Access-Control-Expose-Headers:任意ですが推奨されます。Content-LengthやDateなどのレスポンスヘッダーをプレーヤーから読めるようにします。

HLS向けのNginx設定

Nginxは動画配信のエッジサーバーやキャッシュ層として広く使われています。次はHLSコンテンツ配信向けの設定例です。serverまたはlocationブロック内に配置できます。

location /hls/ {
    # Define the directory where your media files live
    alias /var/www/hls/;
    
    # Optional: Enable byte-range requests for seeking
    add_header Accept-Ranges bytes;

    # CORS configuration
    if ($request_method = 'OPTIONS') {
        add_header 'Access-Control-Allow-Origin' '*';
        add_header 'Access-Control-Allow-Methods' 'GET, HEAD, OPTIONS';
        # Allow the 'Range' header, crucial for HLS segment fetching
        add_header 'Access-Control-Allow-Headers' 'DNT,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Range';
        # Max cache time for the preflight request (20 days)
        add_header 'Access-Control-Max-Age' 1728000;
        add_header 'Content-Type' 'text/plain; charset=utf-8';
        add_header 'Content-Length' 0;
        return 204;
    }
    
    if ($request_method = 'GET') {
        add_header 'Access-Control-Allow-Origin' '*';
        add_header 'Access-Control-Allow-Methods' 'GET, HEAD, OPTIONS';
        add_header 'Access-Control-Allow-Headers' 'DNT,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Range';
        add_header 'Access-Control-Expose-Headers' 'Content-Length,Content-Range';
    }
    
    if ($request_method = 'HEAD') {
        add_header 'Access-Control-Allow-Origin' '*';
        add_header 'Access-Control-Allow-Methods' 'GET, HEAD, OPTIONS';
        add_header 'Access-Control-Allow-Headers' 'DNT,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Range';
        add_header 'Access-Control-Expose-Headers' 'Content-Length,Content-Range';
    }
}

Nginxのプリフライト(OPTIONS)

カスタムヘッダーを使う場合、ブラウザーはOPTIONSリクエスト(プリフライト)を実際のGETより前に送ることがあります。このNginx設定では、許可するCORS条件を含むHTTP 204レスポンスを直ちに返して対応します。

HLS向けのApache設定

Apacheでは、.htaccessまたは仮想ホストの設定にCORSヘッダーを追加できます。mod_headersが有効であることを確認してください(a2enmod headers)。

設定に次のディレクティブを追加します。

<IfModule mod_headers.c>
    <FilesMatch "\.(m3u8|ts|mp4|m4s|vtt|key)$">
        # Enable CORS for public access
        Header set Access-Control-Allow-Origin "*"
        
        # Define allowed methods
        Header set Access-Control-Allow-Methods "GET, HEAD, OPTIONS"
        
        # Define allowed headers (Crucial for HLS players)
        Header set Access-Control-Allow-Headers "DNT,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Range"
        
        # Expose specific headers to the Javascript client
        Header set Access-Control-Expose-Headers "Content-Length,Content-Range"
    </FilesMatch>
</IfModule>

このApache設定ではFilesMatchでHLSに関係する拡張子だけを対象にするため、HTMLやPHPなど無関係なファイルにCORSポリシーを適用せずに済みます。

よくあるCORSの問題を解決する

1. 「Access-Control-Allow-Originが複数ある」エラー

レスポンスにAccess-Control-Allow-Originの値が複数あるというエラーは、ヘッダーが重複して追加されていることを示します。Node.jsやPHPなどのアプリケーションとNginx/Apacheの両方でCORSを設定した場合や、CloudflareやCloudFrontなどのCDNも同じヘッダーを追加する場合に起こります。ヘッダーを追加する層を一つに絞ってください。

2. OPTIONSリクエストを処理していない

HLSストリームで認証が必要で、Authorization: Bearer ...などのカスタムヘッダーでトークンを送る場合、ブラウザーはプリフライトのOPTIONSリクエストを送ります。サーバーがこのOPTIONSに401 Unauthorizedや403 Forbiddenを返すと、後続のGETは実行されません。認証を要求せずにOPTIONSを処理し、許可するよう設定してください。

3. 古いCORSヘッダーがキャッシュされている

NginxやApacheの設定を更新しても、中間キャッシュやCDNに古いレスポンスが残ることがあります。CORS設定を変更したらCDNのキャッシュを削除し、シークレットモードやDevToolsのキャッシュ無効化を使ってブラウザーのキャッシュを避けて確認してください。

設定を確認する

設定を適用したら、コマンドラインからcurlで確認できます。

curl -I -H "Origin: https://freem3u8.com" https://your-server.com/hls/stream.m3u8

レスポンスヘッダーにAccess-Control-Allow-Origin: *があることを確認します。表示されれば、この公開ストリーム向けの設定が応答に反映されています。ブラウザープレーヤーでの再生も確認してください。