如何通过Dockerfile多阶段构建迁移Selenium与Firefox并确保正常运行？

问题背景 #

采用Docker多阶段构建缩小镜像体积，从基础镜像复制Selenium和Firefox相关文件后，Selenium无法正常调用Firefox。已通过find和which命令查到Firefox路径：

find / -name firefox
/usr/local/lib/python3.11/site-packages/selenium/webdriver/firefox
/usr/lib/firefox
/usr/lib/firefox/firefox
/usr/bin/firefox

which firefox
/usr/bin/firefox

当前使用的Dockerfile配置：

FROM python:3.11.4-alpine
COPY --from=base_image /usr/local/lib/python3.11/site-packages /usr/local/lib/python3.11/site-packages
COPY --from=base_image /usr/local/bin /usr/local/bin
COPY --from=base_image /usr/lib/firefox /usr/lib/firefox
COPY --from=base_image /usr/bin/firefox /usr/bin/firefox
COPY --from=base_image /project /project

尝试在selenium.py中配置多个Firefox二进制路径均无效：

from selenium import webdriver

options = webdriver.FirefoxOptions()
#options.binary_location = "/usr/lib/firefox/firefox"
#options.binary_location = "/usr/bin/firefox/firefox-bin"
#options.binary_location = "/usr/bin/firefox"
service = webdriver.FirefoxService(executable_path=driver_path)
driver = webdriver.Firefox(service=service, options=options)

问题根源 #

Alpine是轻量级发行版，依赖库（如musl替代glibc）与基础镜像（通常为Debian/Ubuntu）差异极大。仅复制Firefox二进制文件和Python包，会遗漏Firefox运行必需的系统依赖库，同时可能未正确复制或配置geckodriver，且容器环境缺少桌面支持，需启用无头模式。

解决方案 #

1. 补充Alpine系统依赖 #

在Dockerfile中添加命令，安装Firefox运行所需的基础依赖：

RUN apk add --no-cache firefox-esr dbus-glib gtk3 libx11 libxext libxrender libxi alsa-lib

这些包覆盖了Firefox运行时的图形、音频、系统交互依赖，可根据实际运行报错调整补充。

2. 正确复制并配置geckodriver #

检查基础镜像中geckodriver的位置（通常在/usr/local/bin或/usr/bin），将其复制到Alpine镜像并赋予执行权限：

COPY --from=base_image /usr/local/bin/geckodriver /usr/local/bin/geckodriver
RUN chmod +x /usr/local/bin/geckodriver

确保geckodriver版本与Firefox、Selenium版本兼容。

3. 调整Selenium代码配置 #

容器环境无桌面环境，必须启用无头模式，同时禁用沙箱避免权限问题：

from selenium import webdriver

options = webdriver.FirefoxOptions()
# 对应which查到的Firefox路径
options.binary_location = "/usr/bin/firefox"
# 启用无头模式（容器必备）
options.add_argument("--headless")
# 禁用沙箱，适配Alpine环境
options.add_argument("--no-sandbox")
# 禁用/dev/shm共享内存，避免Alpine下的资源限制问题
options.add_argument("--disable-dev-shm-usage")

# 若geckodriver已在系统PATH中，无需指定executable_path
service = webdriver.FirefoxService()
driver = webdriver.Firefox(service=service, options=options)

4. 优化后的完整Dockerfile #

# 基础镜像阶段，替换为你的带Firefox和Selenium的基础镜像
FROM your-base-image as base_image

# 最终镜像阶段
FROM python:3.11.4-alpine

# 安装Firefox运行依赖
RUN apk add --no-cache firefox-esr dbus-glib gtk3 libx11 libxext libxrender libxi alsa-lib

# 复制Python依赖与工具
COPY --from=base_image /usr/local/lib/python3.11/site-packages /usr/local/lib/python3.11/site-packages
COPY --from=base_image /usr/local/bin /usr/local/bin

# 复制Firefox相关文件
COPY --from=base_image /usr/lib/firefox /usr/lib/firefox
COPY --from=base_image /usr/bin/firefox /usr/bin/firefox

# 复制并配置geckodriver
COPY --from=base_image /usr/local/bin/geckodriver /usr/local/bin/geckodriver
RUN chmod +x /usr/local/bin/geckodriver

# 复制项目代码
COPY --from=base_image /project /project

WORKDIR /project

可选优化：直接在Alpine中安装Firefox #

若基础镜像的Firefox与Alpine依赖冲突，可直接在Alpine中安装官方包，避免复制带来的兼容性问题：

RUN apk add --no-cache firefox-esr geckodriver

这种方式更稳定，无需从基础镜像复制Firefox文件，只需复制Selenium的Python包即可。

内容的提问来源于stack exchange，提问作者Alberto Sanmartin Martinez