linuxserver/dosbox-staging

linuxserver/dosbox-staging 镜像文档

镜像概述和主要用途

linuxserver/dosbox-staging是由LinuxServer提供的Docker镜像，封装了DOSBox Staging模拟器。DOSBox Staging是经典DOSBox的现代延续版本，作为免费开源的MS-DOS环境模拟器，其核心用途是在现代操作系统上模拟MS-DOS运行环境，从而支持运行各类MS-DOS软件，尤其适用于运行传统MS-DOS视频游戏。该镜像通过容器化部署简化了环境配置流程，无需手动搭建复杂的DOS模拟环境即可快速启用。

核心功能和特性

• 开源免费：基于DOSBox Staging项目，遵循开源许可协议，可免费使用和分发。
• 现代优化：作为DOSBox的现代分支，包含性能提升、兼容性改进等优化，相比传统DOSBox体验更佳。
• 容器化部署：通过Docker封装，简化安装配置过程，支持跨平台运行，降低环境依赖复杂度。
• Web访问支持：可通过浏览器访问（默认3001端口），提供便捷的图形化使用方式。

使用场景和适用范围

• 经典DOS游戏运行：模拟DOS环境，运行《仙剑奇侠传》DOS版、《毁灭战士》等传统MS-DOS游戏。
• 旧版DOS应用使用：运行依赖MS-DOS环境的老旧办公软件、工具程序等 legacy 应用。
• 怀旧软件体验：为用户提供怀旧的MS-DOS软件使用场景，满足复古计算需求。
• DOS环境测试：用于开发或测试需在DOS环境下运行的程序，提供隔离的模拟环境。

详细的使用方法和配置说明

Docker 部署命令示例

bash
docker 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）

端口映射（-p）

卷挂载（-v）

其他配置

• --shm-size="1gb"：设置容器共享内存大小，建议至少1GB以确保模拟器运行流畅，避免因内存不足导致卡顿或崩溃。
• --restart unless-stopped：设置容器重启策略，确保服务在意外停止后自动恢复运行，提高可用性。

应用访问

容器启动后，通过以下地址访问DOSBox Staging应用：
https://<yourhost>:3001/（将<yourhost>替换为宿主机IP地址或域名）