如果你使用 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 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
linuxserver/dosbox-staging是由LinuxServer提供的Docker镜像,封装了DOSBox Staging模拟器。DOSBox Staging是经典DOSBox的现代延续版本,作为免费开源的MS-DOS环境模拟器,其核心用途是在现代操作系统上模拟MS-DOS运行环境,从而支持运行各类MS-DOS软件,尤其适用于运行传统MS-DOS视频游戏。该镜像通过容器化部署简化了环境配置流程,无需手动搭建复杂的DOS模拟环境即可快速启用。
bashdocker run -d \ --name=dosbox-staging \ # 容器名称,可自定义 -e PUID=1000 \ # 运行容器的用户ID(建议与宿主机用户ID一致,避免权限问题) -e PGID=1000 \ # 运行容器的用户组ID(建议与宿主机用户组ID一致) -e TZ=Etc/UTC \ # 时区设置,格式为"区域/城市",如"Asia/Shanghai"(中国上海时区) -p 3000:3000 \ # 端口映射:容器3000端口映射至宿主机3000端口(内部服务通信) -p 3001:3001 \ # 端口映射:容器3001端口映射至宿主机3001端口(Web访问端口) -v /path/to/config:/config \ # 配置目录挂载:宿主机目录/path/to/config映射至容器/config,用于持久化配置和数据 --shm-size="1gb" \ # 共享内存大小设置,建议1GB以保证模拟器性能 --restart unless-stopped \ # 重启策略:除非手动停止,否则容器意外退出后自动重启 lscr.io/linuxserver/dosbox-staging:latest # 镜像地址(latest标签为最新稳定版)
环境变量(-e)
| 参数 | 说明 | 默认值 |
|---|---|---|
| PUID | 运行容器的用户ID,用于文件权限控制,建议通过id -u命令获取宿主机用户ID | 1000 |
| PGID | 运行容器的用户组ID,用于文件权限控制,建议通过id -g命令获取宿主机用户组ID | 1000 |
| TZ | 容器内时区设置,格式为"区域/城市",如"Asia/Shanghai"(中国时区) | Etc/UTC |
端口映射(-p)
| 宿主机端口 | 容器端口 | 说明 |
|---|---|---|
| 3000 | 3000 | 内部服务通信端口,用于模拟器核心功能 |
| 3001 | 3001 | Web访问端口,通过浏览器访问应用 |
卷挂载(-v)
| 宿主机路径 | 容器路径 | 说明 |
|---|---|---|
| /path/to/config | /config | 配置文件与数据持久化目录,需替换为宿主机实际路径,用于存储游戏ROM、配置文件等 |
其他配置
--shm-size="1gb":设置容器共享内存大小,建议至少1GB以确保模拟器运行流畅,避免因内存不足导致卡顿或崩溃。--restart unless-stopped:设置容器重启策略,确保服务在意外停止后自动恢复运行,提高可用性。容器启动后,通过以下地址访问DOSBox Staging应用:
https://<yourhost>:3001/(将<yourhost>替换为宿主机IP地址或域名)
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
来自真实用户的反馈,见证轩辕镜像的优质服务