
如果你使用 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 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
本镜像为基于KasmVNC的Chromium浏览器Docker镜像,支持Manifest v2,提供通过Web界面访问的Chromium浏览器环境。派生自lscr.io/linuxserver/chromium:latest,包含多种功能优化和配置选项,适用于需要通过浏览器进行远程操作的场景。
SOCAT:启用0.0.0.0:***上的远程调试地址TUNED:静音音频并移除通知以节省系统资源LESSLOG:抑制Chrome日志输出UA:设置用户代理,支持选项:"safari|firefox|chrome|ipad|ioschrome"$CHROME_CLI,支持传递带引号的字符串参数(如--var="strings")$CHROME_CLI_PLAIN:忽略其他CLI命令,仅执行此命令-e CHROME_CLI="--disable-gpu --disable-3d-apis --disable-webgl"bash# 最新版 (128.0.6613.84-1~deb12u1) docker pull truth1984/chromium:v128 # 旧版本 (121.0.6167.139-1~deb12u1) docker pull truth1984/chromium:v2
本容器基于https://github.com/linuxserver/docker-baseimage-kasmvnc%EF%BC%8C%E6%94%AF%E6%8C%81%E4%BB%A5%E4%B8%8B%E9%A2%9D%E5%A4%96%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%EF%BC%9A
可选环境变量
| 变量名 | 描述 |
|---|---|
| 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 | 指定DRI3 GPU加速设备,如"/dev/dri/renderD128" |
| LC_ALL | 设置容器语言,如"fr_FR.UTF-8"、"ar_AE.UTF-8" |
| NO_DECOR | 设置后应用无窗口边框,适用于PWA |
| NO_FULL | 使用openbox时不自动全屏应用 |
可选运行配置
| 配置 | 描述 |
|---|---|
--privileged | 启动Docker in Docker (DinD)环境;建议挂载主机Docker目录提高性能:-v /home/user/docker-data:/var/lib/docker |
-v /var/run/docker.sock:/var/run/docker.sock | 挂载主机Docker socket,用于CLI交互或Docker应用 |
--device /dev/dri:/dev/dri | 挂载GPU设备,可配合DRINODE环境变量使用;仅支持开源驱动(Intel, AMDGPU, Radeon, ATI, Nouveau) |
通过LC_ALL环境变量设置容器语言,例如启动法语环境:LC_ALL=fr_FR.UTF-8。中日韩等语言需额外安装CJK字体,可通过以下环境变量配置:
bash-e DOCKER_MODS=linuxserver/mods:universal-package-install -e INSTALL_PACKAGES=fonts-noto-cjk -e LC_ALL=zh_CN.UTF-8
Web界面设置中的"IME Input Mode"可支持非英文键盘输入,启用后与本地Linux系统locale设置效果一致。
yaml--- services: chromium: image: lscr.io/linuxserver/chromium:latest container_name: chromium security_opt: - seccomp:unconfined # 可选 environment: - PUID=1000 - PGID=1000 - TZ=Etc/UTC - CHROME_CLI=https://www.linuxserver.io/ # 可选 - SOCAT=SOCAT # 可选,启用远程调试 - TUNED=TUNED # 可选,优化资源使用 - LESSLOG=LESSLOG # 可选,抑制日志 - UA=safari # 可选,设置用户代理 volumes: - /path/to/config:/config ports: - 3000:3000 - 3001:3001 shm_size: "1gb" restart: unless-stopped
bashdocker run -d \ --name=chromium \ --security-opt seccomp=unconfined `# 可选` \ -e PUID=1000 \ -e PGID=1000 \ -e TZ=Etc/UTC \ -e CHROME_CLI=https://www.linuxserver.io/ `# 可选` \ -e SOCAT=SOCAT `# 可选` \ -e TUNED=TUNED `# 可选` \ -e LESSLOG=LESSLOG `# 可选` \ -e UA=safari `# 可选` \ -p 3000:3000 \ -p 3001:3001 \ -v /path/to/config:/config \ --shm-size="1gb" \ --restart unless-stopped \ lscr.io/linuxserver/chromium:latest
| 参数 | 功能 |
|---|---|
-p 3000 | Chromium桌面GUI HTTP端口 |
-p 3001 | Chromium桌面GUI HTTPS端口 |
-e PUID=1000 | 用户ID(详见下方说明) |
-e PGID=1000 | 组ID(详见下方说明) |
-e TZ=Etc/UTC | 时区设置,参考时区列表 |
-e CHROME_CLI=... | Chromium命令行参数,完整字符串传递 |
-v /config | 容器内用户主目录,存储配置和本地文件 |
--shm-size= | 共享内存大小,现代网站(如***)运行必需 |
--security-opt seccomp=unconfined | Docker Engine专用,修复旧主机上的系统调用问题;无此选项时Chromium以无沙箱测试模式运行 |
使用FILE__前缀从文件加载环境变量:
bash-e FILE__MYVAR=/run/secrets/mysecretvariable
上述命令将从/run/secrets/mysecretvariable文件内容设置MYVAR环境变量。
通过-e UMASK=022覆盖容器内服务的默认umask设置。Umask通过减法修改权限,而非直接设置权限,详情参考umask说明。
使用卷挂载时,可通过PUID和PGID避免权限问题。确保主机卷目录所有者与指定ID一致。通过id your_user命令获取当前用户的ID:
bashid your_user
示例输出:
textuid=1000(your_user) gid=1000(your_user) groups=1000(your_user)
https://img.shields.io/badge/dynamic/yaml?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=chromium&query=%24.mods%5B%27chromium%27%5D.mod_count&url=https%3A%2F%2Fraw.githubusercontent.com%2Flinuxserver%2Fdocker-mods%2Fmaster%2Fmod-list.yml]([] "查看此容器可用mods") https://img.shields.io/badge/dynamic/yaml?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=universal&query=%24.mods%5B%27universal%27%5D.mod_count&url=https%3A%2F%2Fraw.githubusercontent.com%2Flinuxserver%2Fdocker-mods%2Fmaster%2Fmod-list.yml]([] "查看通用mods")
提供多种https://github.com/linuxserver/docker-mods%E6%89%A9%E5%B1%95%E5%AE%B9%E5%99%A8%E5%8A%9F%E8%83%BD%EF%BC%8C%E4%B8%8A%E8%BF%B0%E5%BE%BD%E7%AB%A0%E9%93%BE%E6%8E%A5%E5%8F%AF%E6%9F%A5%E7%9C%8B%E5%8F%AF%E7%94%A8mods%E3%80%82
容器运行中进入shell:
bashdocker exec -it chromium /bin/bash
实时监控容器日志:
bashdocker logs -f chromium
查看容器版本:
bashdocker inspect -f '{{ index .Config.Labels "build_version" }}' chromium
查看镜像版本:
bashdocker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/chromium:latest
更新镜像:
bashdocker-compose pull
bashdocker-compose pull chromium
更新容器:
bashdocker-compose up -d
bashdocker-compose up -d chromium
清理旧镜像:
bashdocker image prune
更新镜像:
bashdocker pull lscr.io/linuxserver/chromium:latest
停止运行中的容器:
bashdocker stop chromium
删除容器:
bashdocker rm chromium
使用相同参数重新创建容器(配置文件在/config卷中会保留)
清理旧镜像:
bashdocker image prune
推荐使用Diun接收更新通知,不建议使用自动更新容器的工具。
如需本地修改或开发:
bashgit clone https://github.com/linuxserver/docker-chromium.git cd docker-chromium docker build \ --no-cache \ --pull \ -t lscr.io/linuxserver/chromium:latest .
在x86_64硬件上构建ARM变体需使用multiarch/qemu-user-static:
bashdocker run --rm --privileged multiarch/qemu-user-static:register --reset
以下是 truth1984/chromium 相关的常用 Docker 镜像,适用于 不同场景 等不同场景:
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。




来自真实用户的反馈,见证轩辕镜像的优质服务