
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具,协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题,请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可:
请先完整阅读并严格遵守以下文档中的全部规则与要求:
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前,不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式,不推荐豆包 AI;Cursor 等编辑器可在对话 @ 该链接,或加入 User Rules。 若 AI 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
Firefox浏览器(又称Mozilla Firefox)是一款由Mozilla基金会及其子公司Mozilla Corporation开发的自由开源网页浏览器。它使用Gecko布局引擎渲染网页,支持当前及预期的Web标准。
!https://raw.githubusercontent.com/linuxserver/docker-templates/master/linuxserver.io/img/firefox-logo.png
本镜像利用Docker manifest实现多平台支持。只需拉取lscr.io/linuxserver/firefox:latest即可自动获取适合您架构的镜像,也可通过标签拉取特定架构镜像。
支持的架构:
| 架构 | 可用 | 标签 |
|---|---|---|
| x86-64 | ✅ | amd64-<版本标签> |
| arm64 | ✅ | arm64v8-<版本标签> |
| armhf | ❌ |
应用可通过以下地址访问:
本容器基于https://github.com/linuxserver/docker-baseimage-kasmvnc%E6%9E%84%E5%BB%BA%EF%BC%8C%E6%8F%90%E4%BE%9B%E9%A2%9D%E5%A4%96%E7%9A%84%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F%E5%92%8C%E8%BF%90%E8%A1%8C%E9%85%8D%E7%BD%AE%E4%BB%A5%E5%90%AF%E7%94%A8%E6%88%96%E7%A6%81%E7%94%A8%E7%89%B9%E5%AE%9A%E5%8A%9F%E8%83%BD%E3%80%82
可选环境变量
| 变量 | 描述 |
|---|---|
| CUSTOM_PORT | 容器内部HTTP监听端口,默认3000,如需修改可设置此变量 |
| CUSTOM_HTTPS_PORT | 容器内部HTTPS监听端口,默认3001,如需修改可设置此变量 |
| CUSTOM_USER | HTTP基本认证用户名,默认"abc" |
| PASSWORD | HTTP基本认证密码,默认"abc"。若不设置则无需认证 |
| SUBFOLDER | 反向代理子文件夹,需包含前后斜杠,如"/subfolder/" |
| TITLE | 网页浏览器中显示的页面标题,默认"KasmVNC Client" |
| FM_HOME | 文件管理器的主目录(起始目录),默认"/config" |
| START_DOCKER | 若设为false,特权容器将不会自动启动DinD Docker环境 |
| DRINODE | 挂载/dev/dri用于DRI3 GPU加速时,指定使用的设备,如"/dev/dri/renderD128" |
可选运行配置
| 配置 | 描述 |
|---|---|
--privileged | 在容器内启动Docker in Docker (DinD)环境,用于在隔离环境中使用Docker。为提高性能,可将主机Docker目录挂载到容器内,如-v /home/user/docker-data:/var/lib/docker |
-v /var/run/docker.sock:/var/run/docker.sock | 挂载主机级Docker socket,以便通过CLI与主机Docker交互或使用支持Docker的应用 |
--device /dev/dri:/dev/dri | 将GPU挂载到容器中,可与DRINODE环境变量配合使用,利用主机显卡实现GPU加速应用。仅支持开源驱动(如Intel、AMDGPU、Radeon、ATI、Nouveau) |
通过将流质量预设改为"Lossless",本容器能够以高帧率向网页浏览器传输真正的无损图像,更多信息见此处。若从非本地端点使用此模式,需通过3001的HTTPS端口访问。若使用反向代理到3000端口,需设置特定头信息,详见https://github.com/linuxserver/docker-baseimage-kasmvnc#lossless%E3%80%82
以下提供docker-compose和docker cli两种方式创建容器。
yaml--- version: "2.1" services: firefox: image: lscr.io/linuxserver/firefox:latest container_name: firefox security_opt: - seccomp:unconfined #可选 environment: - PUID=1000 - PGID=1000 - TZ=Etc/UTC volumes: - /path/to/config:/config ports: - 3000:3000 - 3001:3001 shm_size: "1gb" restart: unless-stopped
bashdocker run -d \ --name=firefox \ --security-opt seccomp=unconfined `#可选` \ -e PUID=1000 \ -e PGID=1000 \ -e TZ=Etc/UTC \ -p 3000:3000 \ -p 3001:3001 \ -v /path/to/config:/config \ --shm-size="1gb" \ --restart unless-stopped \ lscr.io/linuxserver/firefox:latest
容器通过运行时参数配置,格式为<外部>:<内部>。例如-p 8080:80表示将容器内80端口映射到主机8080端口。
| 参数 | 功能 |
|---|---|
-p 3000 | Firefox桌面图形界面HTTP端口 |
-p 3001 | Firefox桌面图形界面HTTPS端口 |
-e PUID=1000 | 用户ID - 详见下方说明 |
-e PGID=1000 | 组ID - 详见下方说明 |
-e TZ=Etc/UTC | 指定时区,详见时区列表 |
-v /config | 容器内用户主目录,存储本地文件和设置 |
--shm-size= | 共享内存大小,现代网站(如***)运行必需 |
--security-opt seccomp=unconfined | 仅Docker Engine需要,许多现代GUI应用在旧主机上运行时需要此选项,因Docker可能不识别某些系统调用 |
可通过特殊前缀FILE__从文件设置环境变量。例如:
bash-e FILE__MYVAR=/run/secrets/mysecretvariable
这将根据/run/secrets/mysecretvariable文件内容设置环境变量MYVAR。
所有镜像支持通过可选参数-e UMASK=022覆盖容器内服务的默认umask设置。注意umask不是chmod,它基于其值减去权限而非添加。请在寻求支持前阅读此处了解更多。
使用卷(-v标志)时,主机OS与容器间可能出现权限问题。通过指定用户PUID和组PGID可避免此问题。确保主机上的卷目录归指定用户所有,权限问题将迎刃而解。
此处PUID=1000和PGID=1000,可通过id your_user命令获取您的ID:
bashid your_user
示例输出:
textuid=1000(your_user) gid=1000(your_user) groups=1000(your_user)
我们发布多种https://github.com/linuxserver/docker-mods%E4%BB%A5%E5%A2%9E%E5%BC%BA%E5%AE%B9%E5%99%A8%E5%8A%9F%E8%83%BD%E3%80%82%E4%B8%8A%E8%BF%B0%E5%8A%A8%E6%80%81%E5%BE%BD%E7%AB%A0%E6%98%BE%E7%A4%BA%E4%BA%86%E6%AD%A4%E9%95%9C%E5%83%8F%E7%9A%84%E5%8F%AF%E7%94%A8Mods%E4%BB%A5%E5%8F%8A%E5%8F%AF%E5%BA%94%E7%94%A8%E4%BA%8E%E4%BB%BB%E4%BD%95LinuxServer.io%E9%95%9C%E5%83%8F%E7%9A%84%E9%80%9A%E7%94%A8Mods%E3%80%82
容器运行时的Shell访问:
bashdocker exec -it firefox /bin/bash
实时监控容器日志:
bashdocker logs -f firefox
容器版本号:
bashdocker inspect -f '{{ index .Config.Labels "build_version" }}' firefox
镜像版本号:
bashdocker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/firefox:latest
大多数镜像为静态、版本化,需更新镜像并重建容器以更新内部应用。除部分例外(如nextcloud、plex),不建议或支持在容器内更新应用。请参考应用设置部分了解是否推荐更新。
以下是更新容器的说明:
更新镜像:
所有镜像:
bashdocker-compose pull
单个镜像:
bashdocker-compose pull firefox
更新容器:
所有容器:
bashdocker-compose up -d
单个容器:
bashdocker-compose up -d firefox
移除旧的悬空镜像:
bashdocker image prune
更新镜像:
bashdocker pull lscr.io/linuxserver/firefox:latest
停止运行中的容器:
bashdocker stop firefox
删除容器:
bashdocker rm firefox
使用上述相同的docker run参数重建容器(若正确映射到主机文件夹,/config文件夹和设置将保留)
移除旧的悬空镜像:
bashdocker image prune
拉取最新镜像并使用相同环境变量运行:
bashdocker run --rm \ -v /var/run/docker.sock:/var/run/docker.sock \ containrrr/watchtower \ --run-once firefox
移除旧的悬空镜像:docker image prune
警告:我们不推荐使用Watchtower作为现有Docker容器的自动更新解决方案。事实上,我们通常不鼓励自动更新。但对于忘记原始参数的容器,这是一个有用的一次性手动更新工具。长期来看,强烈建议使用Docker Compose。
提示:推荐使用Diun获取更新通知。不推荐或支持其他自动更新容器的工具。
如需为开发或自定义逻辑修改镜像:
bashgit clone https://github.com/linuxserver/docker-firefox.git cd docker-firefox docker build \ --no-cache \ --pull \ -t lscr.io/linuxserver/firefox:latest .
可使用multiarch/qemu-user-static在x86_64硬件上构建ARM变体:
bashdocker run --rm --privileged multiarch/qemu-user-static:register --reset
注册后,可使用-f Dockerfile.aarch64指定Dockerfile构建ARM64版本。
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
来自真实用户的反馈,见证轩辕镜像的优质服务
以下是 lsiodev/firefox 相关的常用 Docker 镜像,适用于 不同场景 等不同场景: