ローカル開発でLaravelをHTTPS化（SSL化）したくて、mkcert + Nginx という構成で試してみました。なぜこの構成を選んだのかという比較や、実際の設定手順、やってみて気づいたことをまとめます。本番環境ではなく、あくまでDocker + Laravel Sailを使ったローカル開発用のSSL化です。
まだまだ改善の余地がある手探り状態ですが、同じように試してみたい方の参考になれば嬉しいです。
1. はじめに
開発中でも HTTPS 化をしておくと、以下のようなメリットがあります。
- 本番環境に近い動作確認ができる
- PWAや一部の API 連携で HTTPS が必須
- ブラウザのセキュリティ機能（Service Worker など）を有効化できる
今回は Laravel 12 + Sail 環境に Nginx を追加し、
mkcert を使ってブラウザ警告なしのローカル証明書を発行しました。
2. 選択肢の比較と理由
2.1 Webサーバー比較（Apache vs Nginx）
| 項目 | Nginx | Apache |
|---|---|---|
| パフォーマンス | イベント駆動で高速 | プロセス/スレッド駆動でやや重い |
| メモリ使用量 | 軽量 | 比較的多い |
| 設定の柔軟性 | シンプルな構成 | モジュール多めで高機能 |
| 静的コンテンツ配信 | 高速 | 相対的に遅い |
| SSL終端処理 | 高性能 | 標準的 |
| 本番採用事例 | 多い（特に高トラフィック環境） | 多い |
今回は以下の理由で Nginx を選びました。
- Sailに簡単に追加できる
- 高速＆軽量で本番環境でもよく使われる
- リバースプロキシ構成との相性が良い
2.2 証明書比較（mkcert vs 自己署名）
| 項目 | mkcert | 自己署名 |
|---|---|---|
| ブラウザ警告 | なし（ローカルCAを信頼） | あり（毎回警告） |
| 開発効率 | 高い | 低い |
| セットアップ | 初回のみ | プロジェクトごとに必要 |
| チーム開発 | 各自がセットアップ | 証明書共有が必要 |
| 信頼性 | ローカルCAで安全 | ブラウザは信頼しない |
今回は以下の理由で mkcert を選びました。
- 複数プロジェクトでも使い回せる
- ブラウザ警告が出ない
- ローカル環境でも安全性を担保できる
3. 環境
- OS: macOS
- Laravel: 12.x
- PHP: 8.4 (Sail デフォルト)
- Docker: 24.x
- Nginx: 1.29.0 (Alpine)
- mkcert: 最新版（brew インストール）
4. 手順
4.1 mkcert インストール
brew install mkcert
mkcert -install
4.2 証明書作成
mkdir -p docker/nginx/ssl
mkcert -key-file docker/nginx/ssl/server.key \
-cert-file docker/nginx/ssl/server.crt \
localhost 127.0.0.1 ::1
4.3 Nginx設定
docker/nginx/nginx.confを作成。
user nginx;
worker_processes auto;
error_log /var/log/nginx/error.log notice;
pid /var/run/nginx.pid;
events {
worker_connections 1024;
use epoll;
multi_accept on;
}
http {
include /etc/nginx/mime.types;
default_type application/octet-stream;
# ログ設定
log_format main '$remote_addr - $remote_user [$time_local] "$request" '
'$status $body_bytes_sent "$http_referer" '
'"$http_user_agent" "$http_x_forwarded_for"';
access_log /var/log/nginx/access.log main;
# パフォーマンス最適化
sendfile on;
tcp_nopush on;
tcp_nodelay on;
keepalive_timeout 65;
types_hash_max_size 2048;
# gzip圧縮
gzip on;
gzip_vary on;
gzip_min_length 1024;
gzip_types text/plain text/css text/xml text/javascript application/javascript application/xml+rss application/json;
# HTTPからHTTPSへのリダイレクト
server {
listen 80;
server_name localhost;
return 301 https://$host$request_uri;
}
# HTTPS設定
server {
listen 443 ssl;
http2 on;
http3 on;
add_header Alt-Svc 'h3=":443"; ma=86400' always;
server_name localhost;
ssl_certificate /etc/nginx/ssl/server.crt;
ssl_certificate_key /etc/nginx/ssl/server.key;
# 開発ではコメントアウト推奨（戻せなくなるの防止）
# add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
client_max_body_size 50m;
location / {
proxy_pass http://laravel.test:80; # ← :80 を明示
proxy_http_version 1.1;
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 https; # ← 明示
proxy_set_header Upgrade $http_upgrade; # WS/HMR
proxy_set_header Connection "upgrade"; # WS/HMR
}
}
}
4.4 docker-compose.yml更新
nginx:
image: nginx:alpine
ports:
- "443:443"
volumes:
- .:/var/www/html:ro
- ./docker/nginx/nginx.conf:/etc/nginx/nginx.conf:ro
- ./docker/nginx/ssl:/etc/nginx/ssl:ro
depends_on:
- laravel.test
4.5 Laravel側設定
app/Providers/AppServiceProvider.php
use Illuminate\Support\Facades\URL;
public function boot(): void
{
if (request()->header('X-Forwarded-Proto') === 'https') {
URL::forceScheme('https');
}
}
5. 動作確認
# Nginx 設定テスト
docker compose exec nginx nginx -t
# HTTPS アクセス確認
curl -Ik https://localhost
ブラウザでhttps://localhostにアクセスし、確認。
まとめ
今回、Docker + Laravel Sail の環境を mkcert と Nginx で SSL 化してみました。最初は「ローカルだしHTTPでいいかな」と思っていたんですが、PWAの検証や外部API連携を考えると、やっぱりHTTPS環境は必須だなと実感しました。