ブラウザーで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: *があることを確認します。表示されれば、この公開ストリーム向けの設定が応答に反映されています。ブラウザープレーヤーでの再生も確認してください。