
Logdy Core 是由 logdyhq 团队开发的一款轻量级、高性能的实时日志查看与分析工具。其最大特色是内置 Web 界面,无需额外部署前端服务或依赖复杂的可视化平台(如 Kibana、Grafana),即可实现对本地或远程日志文件的实时监控、搜索、过滤和高亮显示。Logdy 的设计哲学是“开箱即用”、“极简部署”和“开发者友好”,适用于开发调试、系统运维、容器日志追踪等多种场景。
作为 Logdy 生态的核心组件,它基于 Go 语言开发,提供了日志读取、解析、索引、Web 服务等核心能力。它支持多种日志格式(包括 JSON、纯文本、Nginx、Apache 等),并具备强大的正则匹配、关键词高亮、时间范围筛选、多文件并行监控等功能。
核心特性
- 内置 Web UI: 启动后自动提供一个基于浏览器的图形界面,无需额外安装前端框架或配置反向代理。
- 实时日志流: 支持
tail -f 风格的实时日志更新,新日志内容秒级呈现,适用于调试微服务、容器日志、系统日志等。
- 多文件监控: 可同时监控多个日志文件,支持通配符路径(如
/var/log/*.log),便于聚合查看。
- 智能日志解析: 自动识别 JSON 日志结构并将其展开为可交互的字段;支持自定义解析规则(通过正则或模板)。
- 全文搜索与过滤: 提供关键词搜索、正则表达式过滤、排除模式、时间范围筛选等高级功能。
- 语法高亮与着色: 对日志级别(INFO/WARN/ERROR 等)自动着色,提升可读性;支持自定义颜色规则。
- 跨平台支持: 编译为单二进制文件,支持 Linux、macOS、Windows 等主流操作系统。
- 低资源占用: 内存和 CPU 占用极低,适合在资源受限的边缘设备或开发机上运行。
- API 接口: 提供 RESTful API,可用于集成到其他系统或自动化脚本中。
- 无外部依赖: 不依赖数据库、消息队列或第三方服务,部署极其简单。
开源信息
安装与部署
方法一:使用预编译二进制(推荐)
Logdy Core 提供了针对各平台的预编译二进制文件。
- 访问 GitHub Releases 页面。
- 根据操作系统选择对应版本。
- 下载并赋予执行权限(Linux/macOS):
# 示例:Linux AMD64
wget https://github.com/logdyhq/logdy-core/releases/latest/download/logdy-core_linux_amd64
chmod +x logdy-core_linux_amd64
sudo mv logdy-core_linux_amd64 /usr/local/bin/logdy
- 验证安装:
logdy --version
方法二:通过 Go 工具链安装
如果已安装 Go (≥1.20),可直接使用:go install github.com/logdyhq/logdy-core@latest
方法三:Docker 部署
官方提供了 Docker 镜像,便于在容器化环境中使用。
docker run -d \
--name logdy \
-p 8080:8080 \
-v /path/to/your/logs:/logs \
ghcr.io/logdyhq/logdy:latest \
--file /logs/app.log
注意:需将主机日志目录挂载到容器内,并通过 --file 指定要监控的日志路径。
快速启动示例
监控单个日志文件
logdy --file /var/log/myapp.log
启动后,默认监听 http://localhost:8080,打开浏览器即可看到 Web 界面。
监控多个文件(支持通配符)
logdy --file "/var/log/nginx/*.log" --file "/app/logs/*.json"
指定监听端口和主机
logdy --file ./debug.log --port 9090 --host 0.0.0.0
此时可通过 http://<服务器IP>:9090 访问。
配置选项详解
Logdy Core 支持丰富的命令行参数,常用选项包括:
| 参数 |
说明 |
--file 或 -f |
指定要监控的日志文件路径(可重复使用) |
--port 或 -p |
Web 服务监听端口(默认 8080) |
--host |
绑定的 IP 地址(默认 127.0.0.1,设为 0.0.0.0 可外网访问) |
--follow |
是否持续跟踪文件末尾(默认 true) |
--buffer-size |
内存缓冲区大小(默认 1000 行) |
--format |
日志格式(auto/json/text 等) |
--timezone |
时区设置(如 Asia/Shanghai) |
--help |
查看所有选项 |
完整参数列表可通过 logdy --help 查看。
Web 界面功能
访问 Web 界面,你将看到:
- 顶部工具栏:搜索框(支持正则)、文件切换下拉菜单、刷新/暂停按钮、设置选项。
- 日志列表区域:日志按时间倒序排列,ERROR/WARN/INFO 等自动着色,JSON 日志可展开字段。
- 快捷键支持:
Ctrl + F 聚焦搜索框,Space 暂停/恢复日志流,Esc 清除搜索。
典型使用场景
- 开发调试: 实时查看应用日志,快速定位 Bug。
- 容器日志监控: 替代
docker logs -f,获得更友好的 UI 体验。
- 服务器运维: 远程监控 Nginx、MySQL、系统日志,无需 SSH 登录即可排查问题,是 服务器运维 的轻量级利器。
- CI/CD 日志分析: 在构建服务器上部署,实时查看构建日志。
- 边缘设备日志收集: 在资源受限设备上运行,通过浏览器远程查看日志。
与其他工具对比
| 工具 |
是否内置 Web UI |
是否需数据库 |
学习成本 |
适用场景 |
| Logdy Core |
✅ 是 |
❌ 否 |
极低 |
开发/轻量运维 |
| ELK Stack |
❌ (需 Kibana) |
✅ (Elasticsearch) |
高 |
企业级日志分析 |
| Grafana Loki |
❌ (需 Grafana) |
✅ (Loki) |
中 |
云原生日志 |
| GoAccess |
✅ (但仅限 Web 日志) |
❌ |
低 |
Nginx/Apache 分析 |
| lnav |
❌ (终端工具) |
❌ |
中 |
高级终端用户 |
Logdy 的优势在于“零配置 + 即时可用”,特别适合快速查看日志而非长期存储分析。
总结
Logdy Core 是一款极具实用价值的现代日志查看工具,它将传统 tail -f 的能力与现代化 Web UI 完美结合,极大提升了日志查看的效率和体验。其“单文件部署、零依赖、跨平台”的特性,使其成为开发者和运维工程师的得力助手。对于需要长期存储、告警、复杂分析的场景,建议搭配 Loki、ELK 等系统;但对于“快速看一眼日志”的日常任务,Logdy 提供了目前最优雅的解决方案之一。
立即尝试:
# 一行命令启动
logdy --file your-app.log
# 然后打开 http://localhost:8080
让日志查看变得简单而高效!
|