howdy

Howdy 为 Linux 提供 Windows Hello™ 风格的认证。利用你内置的红外发射器和摄像头，结合面部识别来证明你的身份。

通过中央认证系统（PAM），它可以在任何需要密码的地方工作：登录、锁屏、sudo、su 等。

安装

Howdy 目前已为 Debian/Ubuntu、Arch Linux、Fedora 和 openSUSE 打包。如果你有兴趣为你的发行版打包 Howdy，请随时提交一个 issue。

注意： dlib 的构建可能会在 100% 处挂起超过一分钟，请耐心等待。

Ubuntu 或 Linux Mint

在终端中逐条粘贴（ctrl+shift+V）以下命令来运行安装程序：

sudo add-apt-repository ppa:boltgolt/howdy
sudo apt update
sudo apt install howdy

这将引导你完成安装。

Debian

从 发布页面 下载 .deb 文件并使用 gdebi 安装。

Arch Linux

寻求维护者。

从 AUR 安装 howdy 包。有关 AUR 安装说明，请查看此 wiki 页面。

你需要进行一些额外的配置步骤。请阅读 ArchWiki 条目 了解更多信息。

Fedora

维护者：@luyatshimbalanga

howdy 包可作为 Fedora COPR 仓库 使用，只需在终端中执行以下命令即可安装：

sudo dnf copr enable principis/howdy
sudo dnf --refresh install howdy

注意： Fedora 41 移除了对 Python2 的支持，但目前 Howdy 仍依赖它。如果安装失败，你可以通过安装 beta 仓库并删除发行版版本来解决：

sudo dnf copr remove principis/howdy
sudo dnf copr enable principis/howdy-beta
sudo dnf --refresh install howdy

有关详细的配置步骤，请参阅 COPR 仓库的链接。

openSUSE

维护者：@dmafanasyev

前往 openSUSE wiki 页面 查看详细的安装说明。

从源码构建

如果你想从源码构建 Howdy，需要一些依赖项。

依赖项

• Python 3.6 或更高
  • pip
  • setuptools
  • wheel
• meson 0.64 或更高
• ninja
• INIReader（如果找不到，可以自动从 git 拉取）
• libevdev

例如，在 Debian/Ubuntu 上安装它们：

sudo apt-get update && sudo apt-get install -y \
python3 python3-pip python3-setuptools python3-wheel \
cmake make build-essential \
libpam0g-dev libinih-dev libevdev-dev python3-opencv \
python3-dev libopencv-dev

构建

meson setup build
meson compile -C build

你也可以通过 meson install -C build 将 Howdy 安装到系统中。

设置

安装后，Howdy 需要学习你的长相，以便以后能够识别你。运行 sudo howdy add 添加一个人脸模型。

如果一切顺利，我们应该能够仅通过展示你的面部来运行 sudo。打开一个新终端，运行 sudo -i 看看效果。如果遇到问题，请查阅 此 wiki 页面 或 搜索 类似问题。

如果你好奇，可以运行 sudo howdy config 打开中央配置文件并查看 Howdy 提供的选项。在大多数系统上，这会打开 nano 编辑器，你需要按 ctrl+x 保存更改。

CLI

安装程序会添加一个 howdy 命令来管理当前用户的人脸模型。使用 howdy --help 或 man howdy 列出可用选项。

用法：

howdy [-U user] [-y] command [argument]

贡献

为 Howdy 做贡献最简单的方式是 star 这个仓库，并为你希望看到的功能开启 GitHub issue。如果你想做得更多，也可以 请我喝杯咖啡。

代码贡献也非常欢迎。如果你想将 Howdy 移植到其他发行版，也可以为此提交 issue。

故障排除

任何 Python 错误都会直接打印到控制台，并指示哪里出了问题。如果认证仍然失败但没有显示错误，你可以查看 /var/log/auth.log 的最后几行，看看是否有任何报告信息。

请先查看 常见问题 wiki，如果你遇到了尚未报告的错误，请随时提交新的 issue。

关于安全性的说明

此软件包的安全性绝不可能与密码相提并论，也永远不会。虽然它比普通面部识别更难被欺骗，但一个与你长相相似的人，或者一张打印精良的照片，可能就足以骗过它。Howdy 是一种更快速、更便捷的登录方式，而不是更安全的方式。

为最大程度降低此程序被攻破的风险，建议将 Howdy 保留在 /lib/security 目录中，并保持其为只读状态。

请勿将 HOWDY 作为系统的唯一认证方法。