NAS 与运维

Firefox:在 NAS 中运行浏览器

  • 0 次阅读
  • 0 条评论
文章摘要

Firefox 的 LinuxServer 容器把浏览器运行在 NAS 上,通过网页桌面访问。适合需要独立浏览环境的任务;浏览器会使用 NAS 的网络,网页桌面端口本身也需要受控访问。 网页桌面展示 NAS 上的 Firefox,浏览器配置与缓存保存在持久化目录。与 Chromium 容器使用不同配置和端口。 适合需要 Firefox 的独立浏览任务。先检查中文输入、下载和重启后状态,再增加扩展。

项目介绍

通过容器在 NAS 中运行 Firefox,可以从浏览器访问独立的桌面会话。下面介绍容器配置、群晖目录准备和网页访问步骤。下载文件、浏览器配置和登录状态需要按挂载目录持久化,管理入口也应设置访问密码。

version: '3.3'  # 指定 Docker Compose 文件版本

services:
  firefox:
    image: jlesage/firefox  # 使用 jlesage/firefox 镜像(基于容器的 Firefox 浏览器)
    container_name: firefox  # 指定容器名称为 firefox
    ports:
      - "5800:5800"  # 映射 noVNC 网页访问端口(通过浏览器访问的端口)
      - "5959:5900"  # 映射 VNC 访问端口(5900是VNC默认端口,这里外部用5959访问)
    environment:
      - DISPLAY_WIDTH=1280  # 设置浏览器窗口宽度为1280像素
      - DISPLAY_HEIGHT=720   # 设置浏览器窗口高度为720像素
      - VNC_PASSWORD=请设置自己的密码  # 设置VNC连接密码(建议改为更复杂的密码)
      - ENABLE_CJK_FONT=1    # 启用中日韩(CJK)字体支持(解决中文显示问题)
      - LANG=zh_CN.UTF-8     # 设置系统语言为简体中文(UTF-8编码)
    volumes:
      # 配置文件持久化(将容器内的配置保存到宿主机)
      - /volume1/docker/firefox/config:/config  
      # 自定义字体目录(如果需要额外安装字体)
      - /volume1/docker/firefox/fonts:/usr/share/fonts/other  
      # 下载目录映射(浏览器下载文件会保存到这里)
      - /volume1/docker/firefox/config/downloads:/config/downloads  
    restart: unless-stopped  # 自动重启策略(除非手动停止,否则总是重启)

补充:部署与使用

安装与使用步骤

  1. 创建 /volume1/docker/firefox/config。通过 id 你的用户名 获取对该目录有读写权限的 UID 和 GID,在项目 .env 中设置 PUID=实际UID、PGID=实际GID。
  2. 按下面配置启动,先在可信局域网打开 https://NAS_IP:3103。内置证书可能出现提示;远程使用应通过可信 HTTPS 与认证入口。
  3. 先浏览公开页面,检查输入、下载与剪贴板操作。书签和浏览器配置保存在 /config,重启后确认仍能读到。
  4. 需要硬件加速时再按设备与项目文档添加 GPU 映射,不一开始就开启特权模式或关闭全部沙箱。

首次使用与操作检查

测试页面输入与下载,创建书签后重启验证。

配置保存失败查目录权限。远程桌面本身需要认证与 HTTPS,不把它当作普通公开网页。

Docker Compose

依据 LinuxServer 官方 README 的端口、共享内存与 /config 挂载整理。本示例 PUID、PGID 已写为 0;没有配置认证前仅在可信局域网访问。

群晖目录准备

在群晖 SSH 终端执行下面这一段,再将下方配置保存为 /volume1/docker/firefox/compose.yaml。也可在 Container Manager 中新建项目,选择该目录并粘贴配置。

sudo sh <<'HALO_PREPARE'
set -eu
mkdir -p /volume1/docker/firefox /volume1/docker/firefox/config
cd /volume1/docker/firefox
HALO_PREPARE
cd /volume1/docker/firefox

本示例使用数值 0 访问挂载目录,无需查询或填写 UID/GID。

services:
  firefox:
    image: lscr.io/linuxserver/firefox:latest
    restart: unless-stopped
    environment:
      PUID: "0"
      PGID: "0"
      TZ: Asia/Shanghai
    ports:
      - "3102:3000"
      - "3103:3001"
    shm_size: "1gb"
    volumes:
      - /volume1/docker/firefox/config:/config

在项目目录保存为 compose.yaml 后,先检查配置,再启动:

docker compose config --quiet
docker compose up -d
docker compose ps
docker compose logs --tail=100

配置与常见问题

  • 共享内存设为 1 GB,需要给 NAS 留出相应运行资源;内存不足时先减少标签页。
  • 这个页面可操作完整浏览器,不能作为无密码的公网工具开放。
  • 页面无法打开:先用 docker compose ps 检查状态,再核对宿主机端口、NAS 防火墙与应用日志。不要把容器端口随意改成另一个数字。
  • 文件无法保存:核对宿主目录是否存在、挂载方向及运行用户的读写权限。不要直接给整个存储卷开放所有权限。

更新与备份

备份 config 目录时按账号资料处理,可能包含 Cookie、历史记录和登录状态。

更新前保留原配置和数据备份,阅读所用版本的升级说明;确认兼容后再执行 docker compose pull 和 docker compose up -d。只回退镜像不一定能回退已经迁移过的数据库。

参考资料