简介Carbonyl​ 是一个基于 Chromium 引擎、专为终端Terminal环境构建的开源图形浏览器。它并非 Lynx 那样的纯文本浏览器而是通过 Unicode 块字符和 ANSI 颜色将网页以像素级图形的方式渲染在命令行窗口中。该项目最初源于html2svg工具现已演变为一个完整的浏览器运行时。它最大的特点是无需图形界面X11/Wayland即可运行现代 Web 应用。你可以在纯命令行服务器、SSH 远程会话甚至安全模式控制台中直接浏览支持 WebGL、WebGPU 的复杂页面体验接近桌面浏览器的交互能力。主要功能完整的 Web 标准支持基于 Chromium 内核支持 JavaScript、WebAssembly、WebGL、WebGPU、CSS 动画等现代 API几乎能运行任何复杂的单页应用SPA。多媒体播放支持视频与音频播放部分环境受限帧率最高可达 60 FPS在终端里“看视频”不再是天方夜谭。极致的轻量化启动时间小于 1 秒空闲时 CPU 占用率为 0%。相比同类方案如 Browsh资源消耗极低渲染效率更高。无头环境原生支持完全不需要窗口服务器可直接在 Linux 虚拟终端TTY、SSH 连接或 Docker 容器内运行是服务器调试的利器。灵活的构建架构项目采用 Rust 编写核心库libcarbonyl运行时基于修改的 Chromium headless shell支持快速迭代开发。安装与配置推荐安装方式Docker最快上手适合大多数 Linux 服务器或本地测试无需安装复杂依赖。docker run --rm -ti fathyb/carbonyl https://github.comnpm 安装若本地已有 Node.js 环境可全局安装npm install -g carbonyl预编译二进制从 GitHub Releases 页面下载对应平台Linux/macOS的二进制包解压后可直接运行。环境要求Linux需要与 Chromium 相同的依赖库如 libnss3、libatk-bridge等。macOS / WindowsmacOS 可直接运行二进制Windows 建议通过 WSL2 使用。如何使用基本浏览在终端直接输入carbonyl命令加 URL 即可。carbonyl https://news.ycombinator.com参数调整支持调整渲染帧率--fps和缩放比例--zoom以适应不同终端尺寸和性能需求。交互操作鼠标支持点击链接、按钮若终端支持鼠标事件。键盘使用Tab键切换焦点Enter确认CtrlC退出。滚动使用鼠标滚轮或键盘方向键。本地文件查看使用file://协议查看本地图片或 HTML 文件。carbonyl file:///path/to/image.png应用场景实例场景一无 GUI 服务器网页调试当你通过 SSH 连接到一台没有安装桌面的远程服务器发现 Web 服务如 Nginx 静态页状态异常。无需配置复杂的远程桌面或 X11 转发直接运行carbonyl http://localhost:8080即可在终端内直观检查页面布局和 JS 加载情况快速定位渲染错误。场景二CI/CD 自动化视觉回归测试在持续集成流水线如 GitHub Actions中使用 Carbonyl 的 Docker 镜像进行页面截图字符形式对比。由于它基于真实 Chromium 内核能捕捉到纯文本浏览器无法察觉的 CSS 样式或 Canvas 渲染差异且比启动完整图形环境的方案更轻量、更快速。场景三低带宽/嵌入式环境浏览在树莓派或旧设备上图形界面卡顿且占用资源。使用 Carbonyl 可以极低的内存和 CPU 开销访问 Gmail、Slack 等现代 Web 应用。虽然画面是“马赛克”字符风格但功能逻辑完全正常适合作为轻量级信息工作站。GitHub 地址项目仓库https://github.com/fathyb/carbonyl