在无根 Podman 容器中运行 Firefox,以实现安全隔离。你的浏览器几乎不持有任何 Linux 能力,运行在独立的用户和网络命名空间中,与宿主机隔离——同时仍具备完整的 GPU 加速、音频和 DRM 支持。
Firefox 本身已具备多进程沙箱,利用 Linux 命名空间和 seccomp-bpf 隔离网页内容渲染进程。对大多数威胁而言,这已经足够有效。foxcage 增加了第二道墙:如果攻击者利用漏洞逃逸出 Firefox 的沙箱(这种情况确实会发生——存在相关 CVE),他们落入的是一个被锁定的容器,而不是你的完整用户会话。
~/.ssh、~/.gnupg、其他浏览器的配置文件、密码管理器数据库、文档、源代码。在 foxcage 中,攻击者只能看到你显式挂载进来的内容。@tmp 临时笼将整个浏览会话保存在内存中,不向磁盘写入任何内容——包括扩展、HSTS 状态、TLS 会话缓存和 DNS 缓存,而这些在 Firefox 的隐私浏览模式下仍会被持久化。多个 @tmp 笼可以并发运行而互不干扰。~/.config/autostart、~/.bashrc、cron 或任何其他位置以在重启后存活。foxcage 的临时容器(--rm)意味着除非你进行了绑定挂载,否则什么都不会持久化。localhost 上的服务。在裸 Firefox 上,沙箱逃逸拥有完整的网络访问权限。(如果某个笼需要访问 localhost,例如用于本地开发,可使用 [network] mode = "host"——但请参阅“网络”下的注意事项:host 模式也会暴露宿主机的抽象 Unix 套接字。)CAP_SYS_CHROOT 之外的所有 Linux 能力,并阻止获取新权限。Setuid 二进制文件、通过冷门系统调用发起的内核漏洞利用以及类似的提权路径都被切断。profile、downloads_dir、额外的绑定挂载)对已被攻陷的浏览器完全可访问。如果你挂载了宿主机配置文件目录,攻击者可以像在裸 Firefox 上一样篡改它。org.mozilla.* 命名空间(每个笼的确切名称无法安全预测)。因此,被攻陷的笼可以在你的其他笼中打开 URL(携带它们的 cookie),或在你在宿主机上运行的 Firefox 中打开。当宿主机 Firefox 未运行时,它还可以抢占其 D-Bus 名称并接收发给它的链接。参见 docs/DESIGN.md 中的“D-Bus 代理”。容器以以下配置运行:
CAP_SYS_CHROOT;当配置了 init.root 时临时添加 CAP_SETUID/CAP_SETGID)no-new-privileges 防止权限提升--userns keep-id)/dev/shm(不与宿主机共享)——可通过 shm_size 配置大小network.dns 配置)XDG_RUNTIME_DIR 中的特定套接字绑定挂载进来(Wayland、PulseAudio 以及经过过滤的 D-Bus 代理)——完整的宿主机运行时目录绝不会暴露xdg-dbus-proxy 进行中介。仅可访问 org.freedesktop.Notifications、org.freedesktop.portal.Desktop、org.mozilla.*,以及(对于分支版本)分支自身的命名空间(例如 org.librewolf.*)——密钥环和 SSH/GPG 代理等会话服务被阻止org.freedesktop.portal.Desktop 被整体允许,因为文件选择器、“在其他应用中打开链接”以及屏幕共享都依赖它。它同时也暴露了 RemoteDesktop(用于整个会话的合成键盘/鼠标)、Camera 和 Location。这些由你桌面环境自身的审批对话框控制,而非由 foxcage 控制——并且 RemoteDesktop 的提示与屏幕共享提示相似,因此在接受之前请仔细阅读审批对话框。xdg-dbus-proxy 没有“拒绝单个接口”的规则,因此要收窄范围就意味着需要枚举 Firefox 所需的每一个接口;关于为何默认不这样做,请参见 docs/DESIGN.mdprofile、downloads_dir、额外的 [mounts] bind)均使用 nosuid,noexecgpg --verify 更严格,后者对于由已撤销密钥生成的签名以及密钥环中的任何密钥都会以 0 退出。foxcage 还额外要求签名链到固定的主密钥,并拒绝任何由其所有者因泄露而撤销的子密钥所签名的版本——参见已撤销的签名密钥--rm)——文件系统写入在退出时丢失你启用的每个 [network] 和 [mounts] 选项都是以牺牲部分隔离性来换取便利性。默认配置是在仍能提供可用浏览器的前提下最严格的配置。
sudo apt install passt)——除非 network.mode = "host"sudo apt install xdg-dbus-proxy)/dev/dri 时 foxcage 会发出警告,Firefox 将以软件方式渲染。镜像中已安装适用于 Intel、AMD 和 nouveau 的 VA-API 驱动,因此硬件视频解码无需宿主机驱动包即可工作——参见硬件视频解码请以普通桌面用户身份运行 foxcage,而不是以 root 或通过 sudo 运行——沙箱会将你的用户映射到容器中,而以 root 运行会消除 foxcage 旨在提供的隔离。它会拒绝以 root 身份启动。
已测试环境: Debian 13(Trixie)搭配 GNOME 3。其他 Linux 发行版和 Wayland 合成器可能可用,但尚未经过测试。
foxcage 是一个单一的 Python 脚本,除 Python 标准库外没有任何依赖。将其复制到 PATH 中的某个目录:
sudo cp foxcage /usr/local/bin/foxcage
或者进行用户本地安装:
cp foxcage ~/.local/bin/foxcage
确保脚本可执行(chmod +x foxcage)。
使用 foxcage --version 查看你当前的版本——这在报告问题时很有用,因为 foxcage 是通过复制单个文件来安装的。
./foxcage
首次运行时,脚本会构建容器镜像(从 Mozilla 下载 Firefox,安装最小化的 Debian 依赖),然后启动 Firefox。在后续运行中,foxcage 会检查 Firefox 更新,并在有新版本可用时自动重建镜像。镜像还会定期重建(默认每 7 天一次),以获取系统软件包更新。如果更新检查失败(网络错误、超时),会记录一条警告并使用现有镜像——启动过程绝不会被阻塞。
将参数传递给 Firefox:
./foxcage https://example.com
将命名 cage 与 Firefox 标志组合使用:
./foxcage @work --kiosk https://example.com
关闭启动 foxcage 的终端后,浏览器会继续运行:foxcage 留在后台,并在 Firefox 退出时进行清理。要从脚本中关闭 cage,请向 foxcage 发送 SIGTERM;它会优雅地停止容器,效果与 Ctrl+C 相同。
如果某个 cage 已在运行,URL 会在现有浏览器的新标签页中打开,而不是启动第二个容器。当 cage 仍在启动或构建时,这一行为同样适用。在此期间点击的链接会等待(显示“Waiting for another launch of cage ... to start”),然后作为标签页在其中打开,而不是启动一个竞争的容器。对正在运行的 cage 执行不带 URL 的 foxcage(或 foxcage @cage)会以“cage is already running”消息干净退出——foxcage 无法从容器外部提升现有的 Wayland 窗口,因此它不会尝试这样做。
当 cage 已在运行时,每次启动的标志不会生效。--dns、--ipv4-only、--lifetime、--color 和 --fork 在容器启动时被消费,而运行中容器的设置无法从外部更改,因此它们会被忽略并给出警告。请关闭 cage 并重新运行以应用它们。
使用
private_browsing配置键来启用隐私模式会话——不要使用 Firefox 原生的--private-windowCLI 标志。该配置键会设置会话级隐私模式(browser.privatebrowsing.autostart),因此后续的foxcage @cage URL调用可以在标签页中重新打开。作为 Firefox 透传参数的--private-window只会让第一个窗口变为隐私模式,并破坏上述在标签页中重新打开的行为。注意: 通过
private_browsing = true启用的会话不会显示 Firefox 通常的隐私窗口 UI 提示(紫色强调条、面具图标、标题中的“(Private Browsing)”)。这是因为会话中的每个窗口都是隐私窗口,Firefox 没有非隐私窗口可供视觉对比——它会抑制该指示器。该会话确实是真正的隐私模式;如果你想验证,可以在 cage 中访问about:privatebrowsing(显示标准的 Private Browsing 信息页),或访问about:config并检查browser.privatebrowsing.autostart = true。
@tmp 进行临时浏览对于不应留下任何痕迹的一次性链接,请使用保留的 tmp cage:
./foxcage @tmp https://somewhere-suspicious.example
每次通过 @tmp 启动都是一个全新的、一次性的 Firefox,没有持久化配置文件。窗口关闭后,所有内容都会消失——cookie、缓存、历史记录、扩展、HSTS 状态、TLS 会话缓存、DNS 缓存、已保存的标签页状态。这比 Firefox 隐私浏览更进一步,后者仍会保留扩展和相当一部分磁盘状态。
该会话从不接触磁盘:cage 的主目录(配置文件、缓存、崩溃报告、~/Downloads)和 /tmp 都位于内存文件系统中。从磁盘删除文件并不会擦除其内容,因此让它们不落盘是确保不留痕迹的唯一可靠方式。一些注意事项:
~/Downloads 的下载内容会占用 RAM,并随窗口关闭而消失。在 tmp.toml 中设置 downloads_dir,可将它们保存到宿主机。init.root 或 init.user 命令写入主目录和 /tmp 之外的文件会进入容器的磁盘层,并在退出时被删除,与之前一样。多个 @tmp cage 可并发运行,彼此隔离。菜单栏会显示 FoxCage - tmp (<short id>),以便你区分并发的临时窗口。
临时 cage 在启动时打开空白页,新标签页也是空白——默认的 Firefox 主页和新标签页内容(热门站点、Pocket 推荐、活动流)在一个即将被丢弃的全新配置文件上纯属噪音,因此它们被抑制。持久化 cage 保留 Firefox 的默认设置。
如果你希望给一次性会话起一个有意义的名称(比如,一个你想在新标签页中重新打开的研究线索),请使用 @tmp-<name>:
./foxcage @tmp-research https://example.com # first call → new window
./foxcage @tmp-research https://another.example # second call → new tab in the existing window
@tmp-<name> 仍然是临时的——关闭窗口后,所有内容都会消失。与裸 @tmp 的区别在于,使用相同名称的第二次启动会复用现有窗口(与持久化 cage 相同),因此你之后可以添加更多标签页,而无需启动一个并行副本。裸 @tmp 则保持其“每次启动都是全新的一次性实例”的行为。
菜单栏标签会显示你选择的名称(FoxCage - tmp-research),因此窗口会被赋予有意义的标签。
创建 ~/.config/foxcage/tmp.toml 来为所有临时 cage(包括裸 @tmp 和每个 @tmp-<name>)设置默认值。例如:
private_browsing = true
lifetime = "30m"
extensions = ["ublock-origin"]
[network]
dns = "cloudflare"
每次临时启动现在都会获得一个隐私窗口、uBlock Origin、Cloudflare DoH,并在 30 分钟后自动关闭——同时完全保持临时性不变。命名临时环境默认继承 tmp.toml;如果你想按名称覆盖,请创建 ~/.config/foxcage/tmp-<name>.toml。该文件随后会替代 tmp.toml 生效——不进行合并,更具体的文件直接胜出。如果你想要共享默认值,请将它们复制到该文件中。
常规 cage 配置中可以设置的任何内容在这里都适用,除了那个会破坏临时性本身的键:
profile —— 硬错误。它指向宿主机上的持久化 profile 目录,这直接违背了 @tmp 的用途。如果你想要一个带持久化 profile 的沙箱化 cage,请使用不以 tmp- 开头的常规命名 cage(@work、@research 等)。
一个 cage 可以将扩展烘焙进其镜像,并在每次启动时强制安装:
extensions = ["ublock-origin"]