banner
约 1,200 字
4 分钟

NAS 上安装的浏览器不好用?这个 Docker 版 Firefox 都解决了

摘要

在 NAS 上装浏览器,最容易踩的坑是中文乱码、没声音、剪贴板不通、显卡硬解开不起来。jlesage/firefox 这个 Docker 镜像把这些都做成了环境变量:中文界面、GPU 直通、网页音频、无缝剪贴板、网页文件管理器与终端、登录认证,一条 compose 就能起。文章给出逐行带注释的完整 compose 文件,包含国内装字体走清华源、HTTPS 自签证书、登录态时长、/dev/dri 直通等细节,并配了首次证书警告、设置中文、调音量、about:support 确认 WebRender、侧边栏中文输入等 7 步实测截图。

NAS 上的 Docker 版 Firefox 教程封面

前言

在家里的 NAS 上安装一个浏览器,虽然使用频率不高,但还是有一些使用场景的。比如在外面可以通过这个浏览器控制家里的所有设备,或是借用家里的网络访问一些只在内网才存在的页面,安全和隐私性都有所保证。之前装的是应用商店里的版本,非常不好用。最近找到了一个更好的版本,几乎解决了我所有的痛点,推荐给大家。

这个项目的作者提供了非常多的参数可以选择,比如中文界面、GPU 直通、中文输入、音频播放、无缝剪贴板共享等。另外还集成了文件管理器和终端,可以直接访问容器里的文件和 Shell,桌面通知也支持。

项目地址:https://github.com/jlesage/docker-firefox

部署

通过 Docker Compose 部署,每个参数我都加了注释,其他参数可以参考项目地址。

YAML
services:
  firefox:
    image: jlesage/firefox:latest
    container_name: firefox
    restart: unless-stopped

    ports:
      - "5800:5800"                  # Web 入口:局域网 http://IP:5800

    volumes:
      - ./config:/config                       # 唯一需要持久化的目录

    shm_size: "1gb"                           # 多标签必需,给小了会崩

    environment:

      # ---- 身份与权限 ----------------------------------------
      - USER_ID=1000    # 容器内运行用户,与宿主 uid 对齐
      - GROUP_ID=1000
      - UMASK=0022

      # ---- 中文环境(必须开,否则中文乱码) ----------------------
      - LANG=zh_CN.UTF-8    # 界面与系统语言
      - TZ=Asia/Shanghai    # 时区
      - ENABLE_CJK_FONT=1   # 装文泉驿正黑字库
      # 装字体走清华源,用官方 CDN 国内会长时间卡死
      - PACKAGES_MIRROR=https://mirrors.tuna.tsinghua.edu.cn/alpine

      # ---- 显示 ---------------------------------------------
      - DISPLAY_WIDTH=1920
      - DISPLAY_HEIGHT=1080
      - DARK_MODE=1           # 深色模式

      # ---- HTTPS 自签证书(认证/通知/剪贴板的前置条件) ----------
      - SECURE_CONNECTION=1              # 全站 HTTPS,浏览器首次会警告
      - SECURE_CONNECTION_VNC_METHOD=TLS

      # ---- 网页登录认证(改下面两行为你自己的账号密码) ------------
      - WEB_AUTHENTICATION=1                          # 打开登录页
      - WEB_AUTHENTICATION_USERNAME=admin           # 改成你的账号
      - WEB_AUTHENTICATION_PASSWORD=ChangeMe_2026   # 改成你的密码
      - WEB_AUTHENTICATION_TOKEN_VALIDITY_TIME=48   # 登录态有效小时数

      # ---- 影音与通知 ------------------------------------------
      - WEB_AUDIO=1                 # 声音推到浏览器,看视频前提
      - WEB_NOTIFICATION=1          # 网页通知转发成系统通知
      - WEB_HOST_CLIPBOARD_SYNC=1   # 宿主机剪贴板互通,需 Chrome/Edge

      # ---- 网页工具 -------------------------------------------
      - WEB_FILE_MANAGER=1                            # 网页文件管理器
      - WEB_FILE_MANAGER_ALLOWED_PATHS=/config,/tmp   # 只放行必要路径
      - WEB_TERMINAL=1                          # 网页终端,非root权限

      # ---- Firefox 行为 ---------------------------------------
      - FF_OPEN_URL=https://www.1day.vip   # 启动页,多个用 | 分隔
      - KEEP_APP_RUNNING=1                     # 崩溃自动重启

    # GPU 硬解(仅 AMD/Intel 开源驱动,NVIDIA 闭源不支持)
    # 宿主机须存在 /dev/dri,否则删掉这一段再启动
    devices:
      - /dev/dri:/dev/dri

使用及功能介绍

  1. 部署完成后,打开 https://IP:5800

    由于这个项目大概率是在外网使用,所以默认使用 HTTPS 协议,直接打开会有证书警告,继续访问就可以了。

    注意内网穿透时,映射地址也是 https

    首次打开时的 HTTPS 证书警告页
  2. 填入 yaml 文件中的登录密码

    容器的网页登录页,输入账号和密码
  3. 设置中文

    Docker 首次启动时会自动下载中文字体,进入 Firefox 的设置选项中添加中文即可。

    Firefox 设置页里添加中文语言
  4. 开启声音

    点开左侧边栏调整声音大小。

    侧边栏里的声音音量控制
  5. 确认开启显卡直通

    地址栏输入 about:support,查看「图像-合成」状态是否显示为 webrender;再随便播放一个视频,看 GPU 是否工作。

    about:support 页面里查看图像合成与 GPU 状态
  6. 中文输入

    侧边栏点开键盘图标即可输入中文。

    调出侧边栏键盘后在网页里输入中文
  7. 剪贴板共享已默认开启

结尾

这个项目几乎解决了我所有的痛点,日常可以正常使用。要是有更好的项目,欢迎给我留言。

END
广告腾讯云 · 2核2G4M 轻量服务器新客 99 元 / 年起去看看 →