できない.dev

zsh「compinit: insecure directories」の原因と直し方

zsh compinit: insecure directories は、compaudit が示す場所の書き込み権限を絞れば直る。
補完の関数を置くディレクトリが、他人も書き込める状態か他人の所有になっているためだ。

公開: 更新:

症状できない · exit 1
zsh -c "autoload -Uz compaudit; compaudit"
There are insecure directories:
/usr/local/share/zsh/site-functions
解決後できた · exit 0
zsh -c "autoload -Uz compaudit; compaudit"

2026-11-09 に debian:bookworm-slim(Zsh 5.9) で実際に打って取った出力。検証環境の詳細

要約

compinit は補完の仕組みを有効にする関数で、読み込む前に補完の関数を置くディレクトリ(fpath)を検査する。
他人が書き換えられるディレクトリを見つけると、対話シェルの起動時に次の確認を出す。

zsh compinit: insecure directories, run compaudit for list.
Ignore insecure directories and continue [y] or abort compinit [n]?

n と答えると compinit: initialization aborted となり、補完は有効にならない。
Debian bookworm の zsh 5.9 で /usr/local/share/zsh/site-functions に chmod go+w を付け、.zshrc で compinit を呼ぶと、この確認が出た。
compaudit が挙げるディレクトリの権限を絞れば、確認は出なくなる。

実行例

debian:bookworm-slim の zsh 5.9 で、fpath のディレクトリに chmod go+w を付けると、対話シェルの起動で確認が出て、n と答えると compinit が中断された。
compaudit | xargs chmod go-w で権限を外し、別ユーザー所有のディレクトリは chown root で直すと、compaudit は終了コード 0 になった。

$ zsh --version
zsh 5.9 (x86_64-debian-linux-gnu)
$ zsh -i -c 'echo started'
zsh compinit: insecure directories, run compaudit for list.
Ignore insecure directories and continue [y] or abort compinit [n]? ncompinit: initialization aborted
started
$ zsh -c "autoload -Uz compaudit; compaudit"
There are insecure directories:
/usr/local/share/zsh/site-functions
$ echo $?
1
$ compaudit | xargs chmod go-w
There are insecure directories:
$ zsh -c "autoload -Uz compaudit; compaudit"
$ echo $?
0
$ zsh -i -c 'echo started'
started
$ ls -ld /opt/comp/a
drwxr-xr-x 2 nobody root 4096 Nov  8 22:04 /opt/comp/a
$ zsh -c "autoload -Uz compaudit; compaudit"
There are insecure directories:
/opt/comp/a
$ echo $?
1
$ chown root /opt/comp/a
$ zsh -c "autoload -Uz compaudit; compaudit"
$ echo $?
0
$ zsh -i -c 'echo started'
started

— 2026-11-09 時点の出力

検証環境Zsh 5.9 / 2026-11-09 検証
検証日
実行環境
debian:bookworm-slim Debian GNU/Linux 12 (bookworm)
バージョン
  • Zsh 5.9

この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。

解決策

1. compaudit で場所を確かめて権限を外す

compaudit は compinit と同じ検査をして、危ないディレクトリを 1 行に 1 つずつ出す。
危ないものがあれば終了コード 1 で終わる。

autoload -Uz compaudit
compaudit

挙がったディレクトリから、group と other の書き込み権限を外す。
root の持ち物なら sudo を付けて実行する。

compaudit | xargs chmod go-w

この後の compaudit は何も出さずに終了コード 0 で終わり、対話シェルも確認を出さずに起動した。
Homebrew のシェル補完の説明(新しいタブで開く)も、compaudit が挙げたディレクトリだけを直し、prefix 全体の権限を再帰的に変えないよう求めている。

2. 所有者を自分か root にする

所有者が原因なら、権限を変えても compaudit から消えない。
chown で所有者を自分か root に変える。

sudo chown root /opt/comp/a

別のユーザーの所有だった /opt/comp/a は、所有者を root に変えると compaudit に挙がらなくなった。

確認を出さない -i と -u

compinit -i は危ないディレクトリを黙って除いて続け、compinit -u は危ないものも含めてすべて読み込む。
-i では確認が出ずに終了コード 0 になったが、除かれたディレクトリの補完は使えない。
-u は他人が書き換えた関数も読み込むので、権限を直すまでのつなぎにとどめる。

よくある原因

zsh のマニュアル(新しいタブで開く)によると、compinit は次の 2 つを危ないと判断する。

  1. group か other に書き込み権限があるディレクトリが fpath に入っている。
    chmod 777 にしたディレクトリはこれに当たる。
  2. root でも自分でもないユーザーが所有するディレクトリが fpath に入っている。
    権限が 755 でも、別のユーザーの所有なら compaudit に挙がった。