`logkeys` 开源项目安装与使用指南-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00516/article/details/142807801

`logkeys` 开源项目安装与使用指南

logkeys :memo: :keyboard: A GNU/Linux keylogger that works! 项目地址: https://gitcode.com/gh_mirrors/lo/logkeys

一、项目目录结构及介绍

logkeys 是一个专为 GNU/Linux 系统设计的简单可靠键记录器。以下是其基本的目录结构以及关键文件的简介：

.
├── aclocal.m4            # 自动配置脚本的一部分
├── autogen.sh            # 自动生成配置文件的脚本
├── bin                   # 包含可执行辅助程序（如llk和llkk）
│   ├── llk               # 用于启动logkeys守护进程的脚本
│   └── llkk              # 用于杀死logkeys守护进程的脚本
├── COPYING               # 许可证文件，说明了GPLv3或WTFPLv2许可条款
├── ChangeLog             # 变更日志
├── configure.ac          # Autoconf使用的配置宏文件
├── doc                   # 文档相关文件夹，可能包含额外的用户手册或帮助文档
├── install-sh            # 安装脚本的备份或辅助文件
├── Makefile.am           # GNU Automake 的 Makefile 骨架
├── Makefile.in           # 由configure生成的实际Makefile模板
├── man                   # 手册页存放目录，包括logkeys的手册页
│   └── logkeys.1         # logkeys命令的手册页
├── README.md             # 项目的主要读我文件，介绍了项目概述
├── TODO                  # 待办事项列表
├── config.h.in           # 配置头文件模板
└── src                   # 源代码文件夹，包含了logkeys的核心功能实现
    ├── event.c           # 输入事件处理相关的代码
    └── ...               # 其他源代码文件

二、项目启动文件介绍

主要启动方式：直接通过命令行启动。例如，手动测试时可以使用：
```
logkeys --start --output <自定义日志文件>
```
辅助工具：项目提供了两个辅助程序 bin/llk 和 bin/llkk 分别用于便捷地启动和停止logkeys守护进程。这两个脚本利用setuid机制，可以在不输入root密码的情况下操作。
示例启动：通过修改 bin/llk 中的 etc/logkeys-start.sh 脚本来定制启动参数。

三、项目的配置文件介绍

默认配置与日志文件：logkeys没有单独的配置文件，但它的行为可以通过命令行参数调整。默认日志文件位置是 /var/log/logkeys.log，且权限设置仅允许root访问。
键盘映射自定义：对于非标准或特定语言布局，用户可能需要创建或修改键映射文件。可通过以下步骤自定义：
1. 使用 logkeys --export-keymap <your_keymap>.keymap 导出当前键映射。
2. 编辑 <your_keymap>.keymap 文件，修复或添加需要的键映射，确保编辑器支持UTF-8编码。
3. 启动logkeys时指定该映射文件：logkeys --start --keymap <your_keymap>.keymap。