Conky：X 桌面上的轻量级系统监视器 #

Conky 是什么？ #

Conky 是一款面向 X 窗口系统的系统监视器，它可以把几乎任何信息直接绘制在桌面根窗口上，或者显示在属于自己的独立窗口中。

作为一款经典的开源桌面监控工具，Conky 内置了超过 250 种对象，覆盖 uname、uptime、CPU 使用率、内存占用、磁盘用量、top 风格的进程统计以及网络流量监控等常见系统指标，还内置 IMAP/POP3 邮件检查和 MPD、XMMS2、Audacious 等音乐播放器集成。所有信息既可以纯文本呈现，也能通过进度条与图形控件展示，并支持多种字体与配色。对于希望随时掌握机器状态、又不想让监控面板占用过多桌面空间的 Linux 用户来说，Conky 提供了一种高度自由、资源占用极低的解决方案。

Conky 有哪些亮点特色？ #

• 250+ 内置对象，信息覆盖全面：官方文档说明 Conky 内置超过 250 种对象，涵盖 uname、uptime、CPU、内存、磁盘、top 风格进程统计与网络监控等系统指标，几乎可以显示你想知道的任何数据。
• 桌面根窗口级显示，零窗口干扰：Conky 可将信息直接绘制在 X 的根窗口上，也可以选择运行在独立窗口中，让监控面板真正“长”在桌面上，不遮挡、不抢焦点。
• 文本、进度条与图形控件自由组合：除了纯文本，Conky 还支持用简单的进度条和图形控件呈现数据，并可搭配多种字体与颜色，视觉表现完全由配置决定。
• Lua API 深度扩展：通过内置的 Lua API，用户可以为 Conky 编写自定义行为与绘制逻辑，把静态监视器变成可编程的桌面组件。
• 兼容外部脚本与程序：除内置对象外，Conky 还能显示通过脚本和外部程序采集到的信息，任何命令行能输出的内容都有机会进入你的面板。
• 内置邮件与音乐播放器集成：开箱即用的 IMAP/POP3 邮件支持，以及与 MPD、XMMS2、Audacious 等播放器的集成，让桌面上同时具备“系统状态 + 生活信息”两个维度。
• Docker 化运行，环境可复现：官方提供 Docker 构建与运行指南，图形版与命令行版均可容器化运行，避免编译器与依赖库差异带来的困扰，也让问题更容易复现和调试。
• 开源免费，社区生态活跃：项目采用 GPLv3 许可，代码托管于 GitHub，并配有 Wiki 收录用户配置、Lua 脚本与常见问题，任何人都可以参与贡献。

免费下载 Conky #

以下为官方渠道提供的安装包，点击链接即可下载。

提示：AppImage 为便携格式，下载后赋予可执行权限即可运行。其他发行版也可直接通过系统包管理器安装 Conky。

Conky 如何使用？ #

1. 启动 Conky：在终端中直接执行 conky 命令，Conky 会读取默认配置文件并立即在桌面根窗口绘制监控面板。
2. 指定自定义配置：使用 conky -c configurationfile 载入你自己的配置文件，便于在不同面板方案之间切换。
3. 编写配置内容：在配置文件中通过 conky.text 段落书写显示项，每一项对应一个内置变量（变量含义可查阅官网 Variables 文档），再配合全局配置参数调整窗口位置、透明度、刷新间隔等行为。
4. 查看可用参数：命令行执行 conky --version 可确认当前版本，执行 conky --help 可查看可用启动选项。
5. 进阶扩展：需要更复杂的绘制或交互时，可参考官网 Lua API 文档编写脚本，把自定义逻辑接入 Conky。

Docker 方式快速上手（参考官方文档）：

docker build --tag=conky .
docker run --rm -ti --net=host -e DISPLAY -v ~/.Xauthority:/root/.Xauthority conky

如需先调试配置，可进入容器交互式修改：

docker run --rm -ti --net=host -e DISPLAY -v ~/.Xauthority:/root/.Xauthority conky bash
conky -c configurationfile ; exit

Conky 的常见问题？ #

Conky 支持哪些操作系统？

Conky 的官方定位是“X 系统监视器”，主要运行在提供 X 窗口环境的类 Unix 系统（如 Linux）上。项目官网的安装、编译与 Docker 文档均围绕这一环境展开，未提供 Windows 或 macOS 的官方原生版本。

为什么在 Docker 中运行时显示的数据不对？

官方文档明确指出，容器化运行 Conky 时，许多显示信息反映的是当前容器内部的状态，而不是整个宿主机的状态。这是 Docker 隔离机制导致的正常现象，而不是配置错误。

Conky 的 Docker 镜像可以用于生产环境吗？

官方文档说明，目前 Docker 镜像仍处于开发阶段。它适合用来规避编译器与依赖库差异、保证运行环境一致，也便于开发者复现问题，但不建议将其视为完全成熟的发行方式。

如何让 Conky 显示自己想要的指标？

Conky 内置对象超过 250 种，包括 CPU、内存、磁盘、网络、进程统计等。你需要在配置文件的 conky.text 中引用对应的变量名，具体变量列表与用法可查阅官网的 Variables 文档。

配置写法去哪里找参考？

官方 Wiki（托管在 GitHub 上）收录了大量用户配置、Lua 脚本和常见问题解答，是查找现成配置模板的最佳入口。此外官网还提供 Syntax Highlighting 说明，方便为 .conkyrc 配置文件开启语法高亮。

如何参与或反馈问题？

项目托管于 GitHub（https://github.com/brndnmtthws/conky ）。官方贡献指南建议通过 Pull Request 提交改动，并附上变更说明、影响范围、测试方式与相关截图；新增源码文件需带有 GPLv3 许可头。

Conky 如何安装？ #

Linux（发行版包管理器）

1. 更新本地软件源索引，例如 Debian/Ubuntu 执行 sudo apt update。
2. 使用发行版对应的包管理器安装 Conky，例如 sudo apt install conky-all（Debian/Ubuntu）、sudo dnf install conky（Fedora）、sudo pacman -S conky（Arch Linux）。
3. 执行 conky --version 验证安装是否成功。
4. 如需同时获得 Lua 等扩展能力，请安装发行版提供的完整功能包（如 conky-all）。

Linux（AppImage 便携版）

1. 下载上文提供的 conky-x86_64-v1.25.3.AppImage 文件。
2. 为文件添加可执行权限：chmod +x conky-x86_64-v1.25.3.AppImage。
3. 直接双击运行，或在终端中执行 ./conky-x86_64-v1.25.3.AppImage。

从源码编译（官方推荐流程）

Contributor 构建使用 mise 管理固定版本的开发工具，在仓库根目录执行：

mise install
mise run doctor
mise run configure
mise run build
mise run test

其中 mise run doctor 会检查仍来自系统包管理器的原生依赖，如 X11、Cairo、Lua、Imlib2、librsvg、ncurses 和 libxml2。

若希望手动使用 CMake：

mkdir build
cd build
cmake ../
make
sudo make install   # 可选

官方提示：ccmake 或 cmake-gui 是浏览众多构建选项的最便捷方式；生成文档需要第三方工具，例如多数发行版都提供的 docbook2X 包。

Docker 安装

1. 按照 Docker 官方文档安装 Docker CE，或通过发行版包管理器安装。
2. 在仓库根目录执行 docker build --tag=conky . 构建图形版镜像；如需命令行版，执行 docker build --build-arg X11=no --tag=conkycmd .。

Conky 如何卸载？ #

Linux（包管理器安装）

1. 使用与安装时相同的包管理器卸载，例如 sudo apt remove --purge conky-all（Debian/Ubuntu）、sudo dnf remove conky（Fedora）、sudo pacman -Rns conky（Arch Linux）。
2. 建议使用带清理参数的命令（如 --purge 或 -Rns），一并移除不再需要的依赖。

Linux（AppImage 便携版）

1. AppImage 不写入系统目录，直接删除 conky-x86_64-v1.25.3.AppImage 文件即可完成卸载。
2. 如需彻底清理，同时删除通过其创建的自定义配置文件。

清理残留配置

Conky 的用户配置文件通常位于用户主目录下（例如 ~/.config/conky/ 目录或 ~/.conkyrc 文件）。卸载程序包后这些文件一般不会被自动删除，如有需要可手动移除：

rm -rf ~/.config/conky
rm -f ~/.conkyrc

Docker 镜像清理

若通过 Docker 方式使用，可使用 docker rmi conky / docker rmi conkycmd 删除对应镜像；不再需要时，也可用 docker system prune 清理无用的容器与镜像层。

说明：以上卸载路径与配置位置基于 Conky 的通用使用惯例整理，官网调研资料中未逐一列出各发行版的具体卸载命令，实际操作时请以你所使用发行版的包管理器行为为准。