failed (13: Permission denied)の解決方法【2025年最新版】

エラーの概要・症状
このエラーが発生する原因
解決方法1（最も効果的）
解決方法2（代替手段）
解決方法3（上級者向け）
エラーの予防方法
関連するエラーと対処法
まとめ

エラーの概要・症状

「failed (13: Permission denied)」というエラーメッセージは、通常、システムやアプリケーションがファイルやリソースにアクセスしようとした際に、権限が不足しているために発生します。このエラーは、特にLinuxベースのシステムやDocker環境でよく見られます。

このエラーが発生する典型的な状況は、Dockerコンテナを起動しようとしたときや、Webサーバー（NginxやApache）を介してアプリケーションにアクセスしようとしたときです。具体的には、以下のような症状が見られます：

Dockerコマンドを実行した際に「Permission denied」と表示される。
Webアプリケーションが正常に動作せず、403 Forbiddenエラーが返される。
ファイルやディレクトリへのアクセスが拒否される。

これにより、ユーザーはアプリケーションやサービスを正常に利用できず、開発や運用に支障をきたすことになります。特に、DockerやNginxを使用している開発者にとっては、このエラーが非常に厄介で、迅速な対応が求められます。

このエラーが発生する原因

「failed (13: Permission denied)」エラーは、主に以下の原因によって発生します：

ユーザー権限の不足：特定の操作を実行するための適切な権限がユーザーに付与されていない場合、エラーが発生します。例えば、Dockerの操作には通常、dockerグループへの所属が必要です。
ファイルシステムの権限設定：特定のファイルやディレクトリに対して、読み取りや書き込みの権限が不足している場合、アクセスが拒否されます。これには、Dockerのソケットファイル（/var/run/docker.sock）や、Webサーバーの設定ファイルが含まれます。
SELinuxやAppArmorなどのセキュリティモジュール：これらのセキュリティ機能が有効になっている場合、特定のプロセスやユーザーがリソースにアクセスすることを制限することがあります。特に、SELinuxは強力なセキュリティ機能を持ち、適切な設定をしないとアクセスが拒否されることがあります。
グループ設定の不備：ユーザーが必要なグループに正しく追加されていない場合もエラーが発生します。たとえば、Dockerを使用するためには、ユーザーがdockerグループに属している必要があります。
アプリケーション設定の誤り：Webアプリケーションの設定ファイルや、環境変数の設定が不適切である場合にもエラーが発生することがあります。特に、NginxやApacheの設定ファイルに誤りがあると、アクセスが拒否されることがあります。

解決方法1（最も効果的）

手順1-1（具体的なステップ）

最も一般的な解決法は、ユーザーを適切なグループに追加することです。以下の手順に従ってください。

端末を開きます。
次のコマンドを実行して、jenkinsユーザーをdockerグループに追加します。

   sudo usermod -aG docker jenkins

現在のユーザーもdockerグループに追加します。

   sudo usermod -aG docker $USER

グループの変更を反映させるために、端末を再起動するか、ログアウトして再度ログインします。

手順1-2（詳細な操作方法）

上記の手順を実行した後、Dockerコマンドを再度試みてください。以下のコマンドを実行して、エラーが解消されたか確認します。

docker ps

これにより、現在実行中のDockerコンテナの一覧が表示されるはずです。もし表示されない場合は、次のステップに進んでください。

手順1-3（注意点とトラブルシューティング）

dockerグループに追加した後、必ず端末を再起動するか、ログアウト・ログインを行ってください。
それでも問題が解決しない場合は、/var/run/docker.sockの権限を確認してください。次のコマンドを実行します。

   ls -l /var/run/docker.sock

権限がsrw-rw----で、グループがdockerであることを確認してください。もし異なっている場合、以下のコマンドで権限を変更します。

   sudo chmod 660 /var/run/docker.sock

解決方法2（代替手段）

もし上記の方法で解決しない場合、次の手順を試してください。

/var/run/docker.sockの権限を変更します。

   sudo chmod 666 /var/run/docker.sock

これはセキュリティ上のリスクがあるため、一時的な対処としてください。

SELinuxの設定を確認します。SELinuxが有効になっている場合、次のコマンドで設定を変更します。

   sudo setsebool -P httpd_can_network_connect 1

これにより、Webサーバーが外部ネットワークに接続できるようになります。

Nginxの設定を確認し、正しいユーザーが設定されているか確認します。設定ファイル（通常は/etc/nginx/nginx.conf）を開き、userディレクティブを確認します。

   user nginx;

これが正しいユーザーであることを確認してください。

解決方法3（上級者向け）

上級者向けの解決策として、以下の手順を試すことができます。

SELinuxの設定を変更し、必要に応じてポリシーを追加します。

   sudo cat /var/log/audit/audit.log | grep denied | audit2allow -M mynginx
   sudo semodule -i mynginx.pp

これはSELinuxによるアクセス拒否を許可するポリシーを生成し、適用するものです。

Nginxの設定を再読み込みします。

   sudo systemctl reload nginx

設定変更後はNginxを再起動することを忘れないでください。

エラーの予防方法

このエラーを未然に防ぐためには、以下の予防策を講じることが重要です：

**ユーザー管理の徹底**：アプリケーションやサービスを実行するユーザーの権限を定期的に確認し、必要なグループに追加しておくこと。
**定期的な権限確認**：重要なファイル（特にソケットファイルや設定ファイル）の権限を定期的に確認し、適切に設定されているかチェックすること。
**SELinuxの設定確認**：SELinuxやAppArmorの設定を確認し、アプリケーションが正常に動作するためのポリシーが適用されているか確認すること。
**ログの監視**：システムのログを定期的に確認し、エラーが発生していないか監視すること。

まとめ

「failed (13: Permission denied)」エラーは、権限に関連する問題であることが多いです。ユーザーのグループ設定やファイルの権限を確認することで、解決できることが多いです。特にDockerやWebサーバーを使用する際は、権限の管理を徹底し、定期的にチェックを行うことが重要です。今後のトラブルを避けるために、これらのポイントをしっかりと理解し、実施していきましょう。

failed (13: Permission denied)]の解決方法【2025年最新版】