WARNING: UNPROTECTED PRIVATE KEY FILE:Permissions are too open(Mac 上被忽略的 SSH 私钥)
Frank Zhang
- 8 分钟阅读 - 3704 字TL;DR
当前用户拥有的私钥只要带组位或其他用户位,客户端就会跳过它。先用 ls -l 看模式,再 chmod 600,然后重试原来的命令。
先对屏幕上的英文,再决定要不要生成新钥匙、要不要把 .pub 贴到任何地方。Mac 的 Terminal 会打出这段警告,git、scp、sftp、ssh-add,以及这个 Mac 上的图形客户端,打出来的也是这段。Linux 上的 OpenSSH 客户端同样会打。要改的是消息里点名的那个文件。中文检索里的「ssh 私钥权限」对不上这句警告,排的时候以粘贴出来的英文为准。
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@ WARNING: UNPROTECTED PRIVATE KEY FILE! @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
Permissions 0644 for 'PATH' are too open.
It is required that your private key files are NOT accessible by others.
This private key will be ignored.
PATH 是这次打开的文件。八进制是这个文件的模式。人们贴出来的常常是 0644。OpenSSH 拒绝使用这一把私钥,是因为当前用户拥有它,同时组或其他用户的权限位有一位是开的。钥匙被忽略,文件不会被改写,也不会被删掉。ssh 可以再试下一把身份。ssh-add 不会把这个文件加进去。一把都没被接受时,会话常常停在 Permission denied (publickey)。后一句有自己的一篇。
先看模式,再改这个路径。路径里有空格时加上引号。
ls -l 'PATH'
ls -ld ~/.ssh
chmod 600 'PATH'
chmod 700 ~/.ssh
ls -l 'PATH'
chmod 600 之后,私钥那一行应是 -rw-------。然后重试原来的 ssh、ssh-add、git、scp 或 sftp。不要从生成新钥匙、chmod 777,或「忽略这条警告」开始。
下面的命令没有为这篇在 Mac 上重跑。旗标来自手册。警告原文来自写作时读到的 OpenSSH authfile.c 里的 sshkey_perm_ok,日期是 2026-11-19。下面其他 OpenSSH 链接是同一次阅读。链接指向当时的 master。Mac 自带自己的那一份 OpenSSH。你机器上的 man 不一致时,以你的手册为准。
这篇对的是哪几句
对上 @ 横幅、WARNING: UNPROTECTED PRIVATE KEY FILE、Permissions … are too open 和 This private key will be ignored。Permissions 0644 for 'PATH' are too open,以及更短的 permissions 0644 are too open,都是这句。ssh、ssh-add、scp、sftp,以及走 SSH 的 git,会在 OpenSSH 客户端去读私钥时打出它。
写作时读到的 authfile.c 里,函数对已打开的文件描述符做 fstat,然后判断:
if ((st.st_uid == getuid()) && (st.st_mode & 077) != 0) {
这一支打印横幅,并返回 SSH_ERR_KEY_BAD_PERMISSIONS。Permissions 0%3.3o for '%s' are too open. 里的八进制是 st.st_mode & 0777。检查上面的注释写明:钥匙属于另一个用户时,这一项检查不做。这篇停在这句注释上,不建议改用别人拥有的钥匙文件。
ssh(1) 的 FILES,2026-11-19 读到的原文是:默认私钥文件 “contain sensitive data and should be readable by the user but not accessible by others (read/write/execute).”。同一段写 ssh “will simply ignore a private key file if it is accessible by others.”。
「permissions are too open」也会出现在 netplan 里。那是另一个程序,不在这篇里。
GitHub 的 Error: Permission denied (publickey) 在 2026-11-19 取到的页面上,没有 UNPROTECTED PRIVATE KEY FILE 这一节。这把钥匙被忽略之后,会话仍可能停在那一句上。GitHub 那一页和本站的 publickey 笔记,解释的是后一句。
有人会再贴一行,里面写着 0644,并建议 0600。写作时读过的 OpenSSH 文件里没有那种写法。能通过上面这项检查的模式是 0600 和 0400。
这句警告在说什么
sshkey_load_private_type 先调用 sshkey_perm_ok,在 sshkey_load_private_type_fd 读钥匙之前就返回。口令提示在后面,而且只针对已经通过这项检查的文件。下表是其他层。
| 屏幕上的原文 | 在这篇里怎么读 | 去哪里 |
|---|---|---|
WARNING: UNPROTECTED PRIVATE KEY FILE、Permissions … are too open、This private key will be ignored | 这个客户端忽略了这一把私钥。 | 对消息里的路径做 ls -l |
Permission denied (publickey) | 服务器拒绝了递出去的钥匙。 | publickey 那篇 |
Too many authentication failures | 这一次连接递出的钥匙太多。 | Too many authentication failures 那篇 |
ssh: connect to host … port 22: Connection refused | TCP。钥匙还没试。 | Connection refused 那篇 |
WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED | 主机密钥。 | host key 那篇 |
Bad configuration option: UseKeychain | PATH 上的 ssh 是哪一个。 | UseKeychain 那篇 |
Bad owner or permissions on ~/.ssh/config | 客户端停掉。另一项检查。 | 下面那一节 |
隧道的地址和端口一直在变,是 一次ssh排错经历。
写作时读到的 sshconnect2.c 里,加载失败会再打一行,然后不返回钥匙。error_r 的格式是 Load key "%s"。ssherr.c 把 SSH_ERR_KEY_BAD_PERMISSIONS 映射成 bad permissions。log.c 在后面加上 : 。客户端 stderr 上的那一行是:
Load key "PATH": bad permissions
还没有载入公钥时,这个身份不会被送出,客户端继续往下试。公钥已经在手里时,日志可以先出现 Offering public key,然后才为签名打开私钥。identity_sign 随后返回 SSH_ERR_KEY_NOT_FOUND,sign_and_send_pubkey 把这个返回值当成软失败,签名不会发出去。ssh-add.c 调用 sshkey_perm_ok 后直接返回,所以 ssh-add 打出来的就是那段横幅,并且不会加入这个文件。磁盘上的文件保持原样。
先读路径和模式
对引号里的路径做 ls -l。这个路径可以不在 ~/.ssh 下面。Downloads 里或桌面上的 .pem,就是消息可以点名的那种路径。chmod 600 给那把私钥。chmod 700 给 ~/.ssh。Downloads 和家目录保持它们现在的模式。
0644 在 ls -l 里是 -rw-r--r--:所有者可读写,组和其他用户可读。掩码 077 是全部组位和全部其他用户位,只读那一位就足以失败。0640(-rw-r-----)、0660(-rw-rw----)、0777(-rwxrwxrwx)同样失败。0600 是 -rw-------。0400 是 -r--------。两者都能通过 sshkey_perm_ok。优先 chmod 600。chmod 400 也能通过。它不是必须的。
私钥变成 0644 的常见来路是一般指导。这里没有记下其中某一次复制。保存到桌面或 Downloads、从 zip 里拷出来、从 FAT 或 exFAT 卷拷出来、在典型的 022 umask 下重定向,或者从 git 里检出一个普通文件(模式 100644),都可能落到 0644。警告里的八进制就是检查当时看见的模式。这篇不写 iCloud、TCC 或 FileVault。
旁边的 .pub 是公钥。ssh(1) FILES 写明公钥文件 “are not sensitive and can (but need not) be readable by anyone.”。要 chmod 的是警告里点名的私钥。.pub 可以继续让所有人可读。
改模式,然后重试
ls -l 'PATH'
ls -ld ~/.ssh
chmod 600 'PATH'
chmod 700 ~/.ssh
ls -l 'PATH'
PATH 换成消息里的路径。确认是 -rw------- 之后,再跑打出警告的那一条命令。警告再次出现时,对新消息里的路径再做一次 ls -l。
chmod 700 ~/.ssh 对应 ssh(1) FILES。~/.ssh/ 的建议权限是 “read/write/execute for the user, and not accessible by others.”。sshkey_perm_ok 检查的是钥匙文件。目录这一行是手册的建议。ls -ld ~/.ssh 已经是 drwx------ 时,这个目录已经在那个建议上。
chmod 400 得到 -r--------。所有者只需要读的时候可以用它。常用的仍是 chmod 600。钥匙、~/.ssh、config、authorized_keys 都不要 chmod 777。~/.ssh 留在原地,其他钥匙也留在原地。
ls -l 的所有者已经是你的登录名时,改动就是 chmod 600。警告能打出来,是因为打开文件的那个客户端满足 st.st_uid == getuid()。ls -l 若显示另一个所有者,你正在看 ls 的这个 shell 和打出警告的客户端不是同一个账号,或者警告之后所有者变过。源码注释写明,另一个所有者不会碰上这一项检查。这篇不为 root 拥有的文件再编一条报错。ls 已经明确显示、将要运行 ssh 的那个登录名并不是所有者时,先把文件还给他,再设模式:
sudo chown USER 'PATH'
chmod 600 'PATH'
USER 换成那个登录名。ssh 和 git 前面不要加 sudo。sudo ssh 读的是 root 的 ~/.ssh。publickey 那篇 已经写过这个分叉。
下一句若是 Permission denied (publickey)
被忽略的私钥没有被服务器接受。ssh 可能已经试过其他身份。指纹、GitHub 账号上的钥匙,以及生成新钥匙,都在 publickey 那篇。这篇不跑 ssh-keygen,也不贴 .pub。
Bad owner or permissions on ~/.ssh/config
Bad owner or permissions on ~/.ssh/config 是另一句。同一句 fatal 也会带着家目录、authorized_keys、/root 或 /home 下面的路径,或者一条 WSL 路径出现。写作时读到的 readconf.c 里,read_config_file_depth 在设置了 SSHCONF_CHECKPERM 时调用 fatal("Bad owner or permissions on %s", filename),客户端就此停下。
触发条件是:所有者既不是 root 也不是当前用户,或者组写位、其他用户写位有一位是开的(st.st_mode & 022)。私钥检查则是任何组位或其他用户位,包括 0644 里的读位。~/.ssh/config 为 0644 时没有组写、也没有其他用户写,你或 root 拥有它时,可以通过这项配置检查。ssh(1) FILES 对这个文件的要求是 “must have strict permissions: read/write for the user, and not writable by others.”。对它 chmod 600 是合理做法。
publickey 那篇的安全一节已经写过这句 fatal,就在不要 chmod 777 的那一段旁边。这一节只把两句分开。
Windows 和 WSL
同一段英文警告,人们会从 Windows、WSL 和 PowerShell 里贴出来。WSL 里面是 Linux 文件系统,上面的步骤就是 chmod 和 ls -l。Windows 的 ACL 命令不在这篇里。这里没有引用微软或 GitHub 上关于那些步骤的当前文档。
这篇停在这里
- 命令没有为这篇在 Mac 上重跑。站上没有一次会话的屏幕是这句警告。依据是手册和上面的 OpenSSH 文件。机器上的
man优先。 - 搜索量。这篇没有另做外部数据。
- 这篇没有给出一个旗标,让客户端继续使用权限过开的私钥。
StrictModes是服务器设置,管的是服务器上用户的文件和家目录。publickey 那篇已经点过它。关掉它,客户端对私钥文件的这项检查仍在。- 别人的钥匙,以及已经放在 GitHub 账号上的钥匙,留在原地。这篇要动的是消息里的那个路径。
.pub可以继续让所有人可读。
其他阅读路线见 自部署阅读路线。英文稿是同一题的另一份写法:WARNING: UNPROTECTED PRIVATE KEY FILE: Permissions are too open (SSH on a Mac)。
这篇如果有用,欢迎自愿赞助,用来继续更新博客和自部署笔记。这不是慈善捐赠。