🪵 在 Debian 上安装最新版 lnav

什么是 lnav？

lnav，即 Logfile Navigator，是一款终端日志查看器，能把来自多个来源的日志文件合并到一个按时间戳排序的视图中。把几个文件、一个目录或一个压缩包交给它，它会自己识别格式（syslog、systemd 日志、Apache 和 nginx 访问日志、JSON lines 等等），按时间交错排列消息，高亮错误和警告，并在文件增长时持续跟踪。之后你可以过滤、搜索、在错误之间跳转；当问题不是一次搜索能回答的时候，还可以用 SQL 查询日志消息。通过 ssh 打开远程日志和打开本地日志一样简单。lnav 由 Tim Stack 用 C++ 编写，采用 BSD-2-Clause 许可证。

⚡ lnav 的主要功能

📦 从 deb.griffo.io 安装

sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(. /etc/os-release; echo ${DEBIAN_CODENAME:-${UBUNTU_CODENAME:-$VERSION_CODENAME}}) main" | sudo tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
sudo apt update

install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(. /etc/os-release; echo ${DEBIAN_CODENAME:-${UBUNTU_CODENAME:-$VERSION_CODENAME}}) main" | tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
apt update

sudo apt install extrepo
sudo extrepo enable griffo
sudo apt update

# 安装最新版 lnav（原地替换发行版自带的旧版 lnav）
sudo apt install lnav

# 验证安装
dpkg -s lnav | grep Version

# 安装最新版 lnav（原地替换发行版自带的旧版 lnav）
apt install lnav

# 验证安装
dpkg -s lnav | grep Version

# /var/log 下的日志只有 root 和 adm 组可读
sudo lnav /var/log

# 没有 rsyslog（Debian 默认如此）？以 JSON 形式读取 systemd 日志
journalctl -o json | lnav

# 你自己的日志无需 sudo；格式会自动识别
lnav ~/app/logs/

# 在 lnav 中按 ? 查看内置帮助，按 q 退出

# /var/log 下的日志只有 root 和 adm 组可读
lnav /var/log

# 没有 rsyslog（Debian 默认如此）？以 JSON 形式读取 systemd 日志
journalctl -o json | lnav

# 你自己的日志无需 sudo；格式会自动识别
lnav ~/app/logs/

# 在 lnav 中按 ? 查看内置帮助，按 q 退出

🎯 基本用法示例

阅读和跟踪日志：

# 轮转和压缩过的日志可以直接打开，归档也一样
lnav /var/log/nginx/access.log.2.gz support-bundle.tar.gz

# 多个来源，按时间戳合并成一条时间线
lnav /var/log/nginx/ ~/app/logs/app.log

# 另一台机器上的日志，走你平常的 ssh 配置
lnav user@host:/var/log/syslog

过滤与 SQL：

# 在 lnav 中：e / E 跳到下一个 / 上一个错误，w / W 跳到警告
# :filter-in error         只保留匹配的行
# :filter-out healthcheck  隐藏匹配的行
# ;SELECT c_ip, count(*) AS hits FROM access_log GROUP BY c_ip ORDER BY hits DESC

# 不启动界面执行同样的查询，适合脚本
lnav -n -c ';SELECT sc_status, count(*) FROM access_log GROUP BY sc_status' /var/log/nginx/access.log

保持最新：

# lnav 随系统其他软件一起更新
sudo apt update && sudo apt upgrade

# 查看已安装的版本以及可用的最新版本
apt policy lnav

# 卸载
sudo apt remove lnav

# lnav 随系统其他软件一起更新
apt update && apt upgrade

# 查看已安装的版本以及可用的最新版本
apt policy lnav

# 卸载
apt remove lnav

🚀 为什么选择 deb.griffo.io？

• ✅ 与 Debian 相同的软件包名：软件包名为 lnav，与 Debian 官方仓库中的名称完全一致，因此本仓库会在 apt upgrade 时原地升级自带的 lnav，之后 apt remove 也不会留下任何东西
• ✅ 上游官方静态构建：上游自己的 musl 静态二进制文件，完全没有运行时依赖，在每个版本上的表现都一样
• ✅ 完整的软件包：lnav 二进制文件及其 man 手册页，推荐安装 openssh-client 以查看远程日志，建议安装 wl-clipboard 或 xclip 以复制日志行
• ✅ 自动更新： 上游发布后数小时内更新软件包
• ✅ 两种架构： 每个版本都提供 amd64 和 arm64，同一个 lnav 可以运行在服务器、笔记本以及树莓派这样的 ARM 开发板上
• ✅ 多发行版： 支持 Bookworm、Trixie、Forky 和 Sid
• ✅ 易于维护： 使用标准 apt 命令即可更新

📦 软件包构建仓库

Debian 软件包在这个 GitHub 仓库中自动构建和维护：

• 🪵 lnav-debian - 最新版本构建

🔗 相关软件包

deb.griffo.io 同样提供：

• lazydocker - Docker 的终端界面，用来找到你需要查看日志的容器
• k9s - Kubernetes 集群及其 Pod 的终端界面
• ripgrep - 快速的递归搜索，一次 grep 整个日志目录树
• bottom - 终端系统监视器，查看日志不会告诉你的信息
• fzf - 模糊查找器，用来挑选要打开的日志文件