Firefox Docker镜像使用文档

镜像概述和主要用途

本镜像提供了Mozilla Firefox浏览器的Docker化运行环境，旨在通过容器隔离方式便捷地运行Firefox浏览器。支持基本浏览功能，并集成音频输出、硬件加速和数据持久化等增强特性，满足不同场景下的使用需求。

核心功能和特性

• 基础运行支持：可直接在容器中启动标准Firefox浏览器实例
• 音频输出：通过Pulseaudio实现音频支持（自标签78.0.2-buster起）
• 硬件加速：集成mesa驱动（mesa-dri-intel），支持Intel显卡硬件加速（自标签firefox:68.8.0起）
• 数据持久化：支持用户配置和下载文件的持久化存储

使用场景和适用范围

• 需要隔离运行环境的网页浏览场景
• 临时使用Firefox浏览器且不希望影响主机配置
• 需在多环境中保持一致Firefox配置的需求
• 对浏览器性能有要求（如WebGL应用）的场景

详细使用方法和配置说明

启动基础Firefox实例

使用以下命令直接启动基础Firefox容器实例：

docker run \
    --network host \
    -e DISPLAY \
    -v $HOME/.Xauthority:/home/firefox/.Xauthority:ro \
    cremuzzi/firefox

Pulseaudio音频支持配置

自标签78.0.2-buster起，镜像采用Pulseaudio替代alsa以提供更优音频支持。容器将作为主机Pulseaudio服务器的客户端运行，需添加Pulseaudio卷挂载：

docker run \
    --network host \
    -e DISPLAY \
    -v $HOME/.Xauthority:/home/firefox/.Xauthority:ro \
    -v /run/user/1000/pulse:/run/user/1000/pulse:ro \
    cremuzzi/firefox

mesa硬件加速配置

自标签firefox:68.8.0起，镜像已启用Intel显卡的mesa驱动（mesa-dri-intel），可解决WebGL相关性能问题。启用硬件加速需共享主机/dev/dri设备：

docker run \
    --network host \
    -e DISPLAY \
    -v $HOME/.Xauthority:/home/firefox/.Xauthority:ro \
    --device /dev/dri \
    cremuzzi/firefox

持久化存储配置

为保存用户数据（如书签、扩展、设置）和下载文件，需配置持久化存储：

1. 创建主机数据目录
   在主机合适位置创建数据存储目录，例如：

   • /my/own/mozilla：用于存储Firefox配置数据
   • /my/own/downloads：用于存储下载文件

2. 启动带持久化存储的容器
   挂载创建的目录启动容器：

docker run \
    --network host \
    -e DISPLAY \
    -v $HOME/.Xauthority:/home/firefox/.Xauthority:ro \
    -v /run/user/1000/pulse:/run/user/1000/pulse:ro \  # 可选，需音频支持时添加
    -v /my/own/downloads:/home/firefox/Downloads \       # 下载文件持久化
    -v /my/own/mozilla:/home/firefox/.mozilla \          # 用户配置持久化
    cremuzzi/firefox