对于网站开发者而言,逐个页面运行 Lighthouse 审计耗时且繁琐,尤其面对中大型站点时往往力不从心。Unlighthouse 是一款免费、开源的 CLI 工具,它将 Google Lighthouse 的能力扩展到整个站点,自动发现所有 URL、并行爬取并生成一份统一的可视化性能报告。
只需一行命令 npx unlighthouse –site example.com,即可在本地 localhost:5678 启动现代化仪表盘,让性能优化工作从“点”跨越到“面”。
核心功能
Unlighthouse 围绕“全站规模化审计”这一目标,集成了多项实用能力:
- 并行扫描(Parallel Scans):利用多线程工作池配合机会性限流,在保证扫描效率的同时避免压垮服务端,实现快速审计。
- 自动爬取(Auto Crawling):自动通过 robots.txt、sitemap.xml 以及页面内链发现站点 URL,无需手动配置爬取规则。
- 智能采样(Smart Sampling):针对动态路由页面(如带查询参数或路径变量的页面)自动采样,减少冗余扫描,大幅缩短总耗时。
- 现代 UI(Modern UI):基于 Vite 构建的客户端界面,支持搜索、排序、重新扫描单个页面,交互流畅,数据可视化直观。
- SEO 洞察(SEO Insights):内置标题、Meta 描述、分享图片以及链接分析能力,帮助排查搜索引擎优化问题。
- 可访问性摘要(A11y Summary):提供无障碍审计报告,并带有对比度问题可视化,让开发者快速定位颜色或元素层面的可访问性缺陷。
使用体验
Unlighthouse 的设计哲学是“开箱即用”——零配置即可启动。只需要 Node 20+ 环境和 MIT 许可证,无需安装额外依赖。运行命令后,工具会自动完成 URL 发现、并行扫描和数据聚合,最终在浏览器中打开一个具有仪表盘效果的 Web 客户端。
在客户端中,所有页面的 Lighthouse 分数(性能、可访问性、最佳实践、SEO)以卡片形式清晰展示,支持按分数排序、按分类筛选,还可以针对特定页面单独“重新扫描”以验证修复效果。这种集中查看、快速定位、局部重扫的工作流,比逐一打开 DevTools 逐个测试高效得多。
同时,Unlighthouse 会生成统一的 JSON 报告,方便集成到 CI/CD 流水线或导出至其他分析平台。目前该项目在 npm 上拥有 3.4K 日均下载量、101K 月下载量,GitHub 收获 4.5K 星标,社区活跃度可见一斑。
价格方案
Unlighthouse 完全免费且开源,采用 MIT 许可证,无任何付费版本或功能限制。项目的持续发展依赖于社区赞助,gh-sponsors 等渠道提供了资金支持。顶级赞助商包括 Daniel Roe,另有 Gold Sponsors 和 Backers 贡献支持。这意味着任何个人或团队都可以直接下载使用,无需付费,也无需担心未来被锁定。
适用场景
- 大型网站性能基线扫描:对拥有成百上千页面的企业站、电商站,只需一次命令即可完成全量审计,建立性能基线。
- SEO 批量检查:利用 SEO 洞察功能,快速发现站点中缺失标题、描述或分享图片的页面,避免搜索引擎降权。
- 无障碍合规审计:面向需满足 WCAG 标准的政务、教育、金融类网站,可一次性抓取所有页面的可访问性问题(如对比度不足)。
- CI/CD 质量门禁:将 Unlighthouse 集成到预发布流程,每次部署前对比新旧报告,确保性能不退化。
- 竞品分析或迁移前后对比:对整站进行快照式扫描,对比不同版本或不同站点的性能差异。
综合评价,优缺点
优点:
- 真正实现“全站扫描”自动化,省去逐个页面重复操作的精力。
- 并行与智能采样结合,扫描速度远快于逐页手动测试。
- 现代 UI 交互直观,搜索、排序、重扫一应俱全。
- 免费开源,MIT 许可证,无功能阉割。
- 社区活跃,下载量与 GitHub 星标证明其可靠性。
缺点:
- 依赖本地环境:需要 Node 20+,对老旧服务器或受限环境适配不够友好。
- 无持久化存储:报告默认仅存在于本地 localhost:5678 服务运行期间,如需历史对比需自行导出或二次开发。
- 动态路由覆盖有限:智能采样只能处理部分动态路径,对于参数极多或表单生成的页面可能遗漏。
- 无移动端模拟:目前以桌面端 Lighthouse 为主,移动端模拟需手动配置参数。
