
如果你使用 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 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
已弃用:请改用 dockerfiles 仓库中的镜像:https://github.com/MaxMilton/dockerfiles/tree/master/chromium
上运行。
基于https://github.com/jessfraz/dockerfiles/blob/master/chromium/Dockerfile%EF%BC%8C%E4%BD%86%E8%BF%9B%E8%A1%8C%E4%BA%86%E5%A4%A7%E9%87%8F%E8%87%AA%E5%AE%9A%E4%B9%89%E3%80%82
使用针对性能和安全性的https://github.com/MaxMilton/docker-chromium/blob/master/default.conf%EF%BC%8C%E5%85%B7%E6%9C%89%E5%BC%BA%E7%83%88%E7%9A%84%E4%B8%AA%E4%BA%BA%E9%85%8D%E7%BD%AE%E5%80%BE%E5%90%91%E3%80%82
shdocker build -t local/chromium .
或者,也可从Docker Hub下载预构建镜像(需同时编辑 launch.sh 脚本):
shdocker pull maxmilton/chromium
注意:默认页面为 about:blank,以加快启动速度。
sh./launch.sh
可选择传递自定义参数:
sh./launch.sh http://localhost:8080 --allow-insecure-localhost
Arch Linux启动问题
若使用Arch Linux,容器可能无法启动,此时可使用替代启动脚本(详见脚本内注释):
sh./launch.insecure.sh
SELinux卷配置
若系统启用SELinux(如Fedora Linux),需在每个 --volume 末尾添加 :z,使Docker正确标记卷:
sh--volume "$HOME"/Downloads:/home/chromium/Downloads:z \ --volume "$HOME"/.config/chromium/:/data:z \
简而言之 — 编辑
launch.sh;取消相关代码注释。
默认情况下,容器为临时模式,每次启动都是全新浏览器环境。若需持久化浏览器数据,需编辑 launch.sh 文件,注释现有 docker run 命令并取消持久化版本的注释。之后可登录创建配置文件等。
主要差异:
sh--rm \
注意:z 用于设置正确的SELinux角色并允许读写访问,不使用SELinux可移除。
sh--volume "$HOME"/Downloads:/home/chromium/Downloads:z \ --volume "$HOME"/.config/chromium/:/data:z \
sh--volume /usr/share/fonts/uddigikyokasho:/usr/share/fonts/uddigikyokasho \
自定义标志:使用自定义Chromium标志集以提升安全性和性能,详见 https://github.com/MaxMilton/docker-chromium/blob/master/default.conf%E3%80%82
时区设置:容器时区默认设为UTC。
Guest会话:即使配置持久化,默认仍以guest会话运行。
共享内存配置:--volume /dev/shm:/dev/shm 是必要的,因为Docker目前仅为 /dev/shm 分配64MB内存,而Chromium需要更多内存以避免崩溃。部分系统可能无需此配置。https://github.com/c0b/chrome-in-docker/issues/1%E3%80%82
基于MIT许可证发布;详见 https://github.com/MaxMilton/docker-chromium/blob/master/LICENCE%E3%80%82
© 2018 Max Milton
以下是 maxmilton/chromium 相关的常用 Docker 镜像,适用于 不同场景 等不同场景:
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。




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