Chromium在主流Linux发行版中可通过包管理器稳定安装，但需注意版本差异、仓库启用状态及headless运行的必要参数。
Chromium 在大多数主流 Linux 发行版的官方源里都存在，直接用包管理器安装最稳；但如果你需要最新版、或系统源太旧（比如 Ubuntu 20.04 的 chromium-browser 还停留在 v85），就得绕过源、手动拉预编译二进制或换仓库。
Ubuntu/Debian 系统用 apt 安装 Chromium
多数情况下，apt install chromium-browser 就够用了，它来自系统默认源，无需额外配置。但要注意：
- 这个包名在较新 Ubuntu（22.04+）中已改为
chromium，老版本才叫chromium-browser - 安装后可执行文件路径通常是
/usr/bin/chromium，不是/usr/bin/chromium-browser（后者可能只是软链） - 若提示
Package 'chromium-browser' has no installation candidate，说明源里没收录——先运行sudo apt update，再检查是否启用了universe仓库：grep -r "universe" /etc/apt/sources.list*
CentOS/RHEL 系统无法用 yum 直接装 Chromium
官方 CentOS/RHEL 的 base 和 epel 源里不提供 Chromium 包，yum install chromium 会失败。你有两个实际可用的选择：
Browser Setup (No-Root Linux)
下载
在无 root/sudo 权限的环境（云容器、VPS、隔离主机）中安装并配置 OpenClaw 浏览器工具的 headless Chrome。适用场景：...
- 改用第三方仓库如 EPEL + RPM Fusion：先启用
epel（sudo yum install epel-release），再启用rpmfusion-free，之后才能yum install chromium - 跳过包管理器，直接下载预编译二进制：去 ungoogled-chromium-binaries 找对应架构的
.tar.xz，解压后用绝对路径运行./chrome（注意它不写注册表、不建桌面图标、也不自动更新） - 别误装成 Google Chrome：很多教程混用两者，但
google-chrome-stable是闭源、带遥测、依赖更多（如libgconf-2.so.4），而 Chromium 是开源基础版，更轻、更适合自动化或隐私敏感场景
headless 场景下启动 Chromium 必须加的参数
命令行跑无界面 Chromium（比如截图、PDF 导出、Selenium 自动化），光写 chromium --headless 很大概率失败，缺参数会卡住或报错：
-
--no-sandbox：容器或非 root 用户下必须加，否则因沙箱初始化失败退出（错误含Failed to move to new namespace） -
--disable-gpu：纯命令行环境没 GPU 上下文，不加会卡在GL is swiftshader或直接崩溃 -
--remote-debugging-port=9222：如果后续要用 Puppeteer 或调试协议，这个端口得显式打开 -
--user-data-dir=/tmp/chromium-headless：必须指定一个干净的临时目录，否则报Cannot create Pref Service with no user data dir - 示例完整命令：
chromium --headless --no-sandbox --disable-gpu --user-data-dir=/tmp/chromium-test --screenshot https://example.com
Chromium 和 chromedriver 版本必须严格对齐
用 Selenium 控制 Chromium 时，chromedriver 不是通用驱动，它和 Chromium 主版本号必须一致（如 Chromium 124.x → 需要 chromedriver 124.x）。常见踩坑点：
- 系统 apt 装的
chromium版本是 120，但你从别处下了 chromedriver 125，webdriver.Chrome()会静默失败或报status code was: 127 - 查 Chromium 版本：运行
chromium --version（注意不是chromium-browser --version） - 查 chromedriver 版本：运行
chromedriver --version，输出首行即主版本号 - 推荐方案：用
webdriver-manager或新版 Selenium（≥4.12）内置的 Selenium Manager，它会自动匹配并缓存对应版本，省去手动下载和校验步骤
真正麻烦的从来不是“装不上”，而是装上了却跑不起来——尤其是 headless 参数漏一个、chromedriver 版本差一位、或者用户数据目录权限不对，都会让进程卡在日志最后一行不动。动手前先确认清楚你要跑的是什么模式、谁来调用、有没有沙箱权限，比反复重装快得多。
