esme518/docker-firefox-zh Docker 镜像 - 轩辕镜像

镜像概述

基于linuxserver/firefox构建的Docker镜像，专门添加中文字体支持，解决Firefox在Docker环境中中文显示异常问题。该镜像保留原镜像的全部功能，同时确保中文文本、界面元素及网页内容正常渲染，适用于需要中文界面的容器化Firefox场景。

核心功能与特性

• 继承基础功能：完整保留linuxserver/firefox镜像的全部特性，包括浏览器核心功能、容器化配置及运行时环境
• 中文字体支持：预装常用中文字体（如宋体、黑体、微软雅黑等），解决中文显示乱码、空白等问题
• 开箱即用：无需手动安装或配置字体，容器启动后中文即可正常显示，简化部署流程

适用场景

• 需要在Docker环境中运行Firefox并显示中文内容的场景
• 开发测试环境中模拟中文用户界面的浏览器测试
• 容器化办公环境，要求浏览器支持中文文档、网页浏览
• 服务器或无头环境（Headless）中运行带中文支持的Firefox实例

使用方法与配置说明

基本部署（docker run）

bash
docker run -d \
  --name=firefox-chinese \
  -p 3000:3000 \  # Web访问端口（默认WebUI端口）
  -e PUID=1000 \   # 运行用户ID（参考linuxserver镜像文档）
  -e PGID=1000 \   # 运行用户组ID
  -e TZ=Asia/Shanghai \  # 时区配置
  -v /path/to/local/config:/config \  # 持久化配置目录
  --restart unless-stopped \
  [镜像名称]:[标签]  # 替换为实际镜像名称和标签

环境变量配置

支持linuxserver/firefox镜像的全部环境变量，关键参数参考：

• PUID/PGID：控制容器内运行用户权限，避免文件权限问题
• TZ：设置时区，影响浏览器时间显示
• DISPLAY：如需本地显示（非WebUI），需配置X11转发（参考原镜像文档）

字体验证

容器启动后，通过WebUI（默认http://localhost:3000）访问Firefox，打开包含中文的网页或文档，确认中文显示正常（无乱码、方块等异常）。

持久化配置

通过-v /path/to/local/config:/config挂载本地目录，可持久化保存浏览器配置、书签、历史记录等数据，容器重建后数据不丢失。

注意事项

• 镜像基于linuxserver/firefox构建，详细使用说明可参考其官方文档
• 如需自定义字体，可通过挂载字体文件到容器内/usr/share/fonts目录扩展字体库（需注意权限配置）