项目介绍
通过容器在 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 # 自动重启策略(除非手动停止,否则总是重启)补充:部署与使用
安装与使用步骤
- 创建
/volume1/docker/firefox/config。通过id 你的用户名获取对该目录有读写权限的 UID 和 GID,在项目.env中设置PUID=实际UID、PGID=实际GID。 - 按下面配置启动,先在可信局域网打开
https://NAS_IP:3103。内置证书可能出现提示;远程使用应通过可信 HTTPS 与认证入口。 - 先浏览公开页面,检查输入、下载与剪贴板操作。书签和浏览器配置保存在
/config,重启后确认仍能读到。 - 需要硬件加速时再按设备与项目文档添加 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。只回退镜像不一定能回退已经迁移过的数据库。