「Linux」Electron 应用找不到系统钥匙串的排障记录

现象#

我的环境大致是：

• Fedora 44 Workstation
• Wayland
• Niri 桌面会话
• GNOME Keyring 已安装
• Netcatty 1.1.24，RPM 包安装

Netcatty 是一个 Electron 应用。它在写入本地备份前，需要用系统安全存储能力加密密钥。如果 Electron 认为当前平台没有可用的安全存储后端，应用就会拒绝继续写入备份。

这类问题不只可能出现在 Netcatty 上。许多 Electron 应用都会依赖系统密码存储，比如 GNOME Keyring、KWallet、libsecret，或者 Electron 的 safeStorage 能力。一旦桌面环境识别不准，就可能出现类似的“钥匙串不可用”“安全存储不可用”“无法保存凭据”等问题。

先确认钥匙串是否真的可用#

第一步不是急着改应用，而是确认系统钥匙串服务是否存在。

可以先检查用户会话的 DBus 服务：

1
busctl --user list | rg 'org\.freedesktop\.secrets|org\.gnome\.keyring'

如果看到类似下面的服务，说明 Secret Service 至少已经注册：

1
org.freedesktop.secrets
2
org.gnome.keyring

然后用 secret-tool 做一个只读查询：

1
secret-tool search application netcatty

即使没有输出，只要命令正常退出，也说明应用层可以连接到 Secret Service。如果提示无法连接，则需要先处理 GNOME Keyring、KWallet 或 libsecret 的安装与会话启动问题。

问题出在哪里#

我的机器上 org.freedesktop.secrets 已经存在，gnome-keyring-daemon 也在运行，secret-tool 查询正常。这说明系统钥匙串本身没坏。

真正的问题更像是：当前桌面会话是 Niri，而不是 GNOME 或 KDE。Electron/Chromium 在 Linux 下会根据桌面环境选择密码存储后端。如果它没有正确判断出应该使用 GNOME Keyring/libsecret，就可能落到不安全或不可用的后端，应用再基于这个结果判断为“当前平台不支持安全密钥库”。

这也是为什么同一台机器上，GNOME Keyring 明明在运行，Electron 应用却仍然说没有安全密钥库。

修复方式#

解决办法是启动 Electron 应用时显式指定密码存储后端：

1
/opt/Netcatty/netcatty --password-store=gnome-libsecret

如果这样启动后不再报错，就可以把参数写进用户级 .desktop 文件，避免每次手动输入。

先复制系统启动文件到用户目录：

1
mkdir -p ~/.local/share/applications
2
cp /usr/share/applications/netcatty.desktop ~/.local/share/applications/netcatty.desktop

然后把其中的 Exec 行改成：

1
Exec=/opt/Netcatty/netcatty --password-store=gnome-libsecret %U

最后刷新桌面数据库：

1
update-desktop-database ~/.local/share/applications

之后从应用菜单重新打开 Netcatty 即可。如果之前把应用固定在 dock 或启动器上，最好取消固定后重新从应用菜单固定一次，避免继续使用旧的启动命令。

对其他应用也有用吗#

有用，但前提是它们也是 Electron/Chromium 系应用，并且问题确实出在 Linux 密码存储后端选择上。

常见可尝试的参数包括：

1
--password-store=gnome-libsecret
2
--password-store=kwallet5
3
--password-store=kwallet6

GNOME、Niri、Sway、Hyprland 等环境通常可以优先试 gnome-libsecret；KDE Plasma 通常优先试 KWallet。不同应用的二进制路径不同，但思路是一样的：先用命令行加参数验证，再写入用户级 .desktop 覆盖文件。

小结#

这次问题的关键点是：系统钥匙串存在，不等于 Electron 应用一定能自动选对钥匙串后端。

在非 GNOME/KDE 的 Wayland 桌面环境里，如果某个 Electron 应用提示安全存储、钥匙串、凭据保存或本地加密不可用，可以按这个顺序排查：

1. 确认 org.freedesktop.secrets 是否在用户 DBus 上注册。
2. 用 secret-tool 验证 Secret Service 是否可访问。
3. 用 --password-store=gnome-libsecret 或 KWallet 参数启动应用。
4. 如果命令行启动正常，再写入 ~/.local/share/applications/*.desktop。

这类问题看起来像应用故障，实际上经常只是 Linux 桌面环境识别和密码存储后端之间的小错位。