はじめに
Laravel Breeze で Vue を使った認証機能を導入しようとした際、Ubuntu（Laravel Sail）上で npm install を実行すると、謎の権限エラーが発生。
ところが、同じコマンドを Windows 環境で実行すると何の問題もなく成功。
この体験から、ホストOSとDockerコンテナ間のファイル・権限の違いについて学んだことが多かったので、備忘録としてまとめておきます。
実行したコマンド一覧
# Breezeパッケージのインストール
./vendor/bin/sail composer require laravel/breeze --dev
# Vue版の Breeze をインストール
./vendor/bin/sail artisan breeze:install vue
# フロントエンドの依存パッケージインストール
./vendor/bin/sail npm install
# 開発用ビルド
./vendor/bin/sail npm run dev
①Ubuntu（Sail）環境で発生したエラー
npm install 実行時に、以下のようなエラーが大量に表示されました。
npm ERR! code EPERM
npm ERR! syscall chmod
npm ERR! path /var/www/html/node_modules/◯◯
npm ERR! Error: EPERM: operation not permitted, chmod ...
npm WARN cleanup EACCES: permission denied, rmdir ...
②しかしWindows環境では成功
同じプロジェクトフォルダを Windows 側で開いて、VSCodeのターミナルで以下を実行：
npm install
npm run dev
→エラーなしで成功
③原因の考察：ホストOSとDockerの権限の違い
結論:
- node_modules がホスト（Windows）と Docker（Ubuntu）間で共有され、権限エラーが発生していた
詳細:
対策1: dockerignore に node_modules を追加する（推奨）
# .dockerignore に追記
node_modules
これにより、ホストとコンテナの間でnode_modules が共有されなくなり、Docker内でのみ管理されるようになる。
# 再実行
rm -rf node_modules package-lock.json
./vendor/bin/sail npm install
./vendor/bin/sail npm run dev
対策2:ファイル所有者の修正（応急処置）
./vendor/bin/sail shell
# コンテナ内で実行
chown -R sail:sail /var/www/html
権限が root などになっていると npm install 時に書き込めないため、sailユーザーに所有権を戻す。
対策3:npm install をホスト側（Windows）で行う
npm install
npm run dev
Vue側のビルドは、Laravel本体とは別にホストOS上で完結させる方法もあり。
④教訓：Sail（Docker）＋npm は環境差に要注意！
⑤まとめ
- npm install は意外とOSとファイルシステムの影響を受けやすい
- Laravel Breeze + Vue を Docker（Sail）で使うなら、権限・マウント・ignore設定をしっかり意識する
- .dockerignoreに node_modules を入れるのは地味だけど超重要！