dlandon/z80pack Docker 镜像 - 轩辕镜像

Z80Pack Docker镜像文档

镜像概述

使用Z80Pack在Docker环境中模拟Z80处理器，支持运行CP/M 1、CP/M 2、CP/M 3和MP/M II等复古操作系统的镜像。容器重启时会自动更新系统以应用安全补丁和Linux更新，确保运行环境安全性。

核心功能与特性

• 多系统支持：兼容CP/M 1、CP/M 2、CP/M 3和MP/M II等经典操作系统
• 自动更新：容器重启时自动应用系统安全更新和Linux补丁
• Web界面访问：通过Web GUI（shell in a box）便捷管理，无需本地终端
• 持久化配置：支持配置文件持久化存储，保持用户设置和数据

使用场景

• 复古计算爱好者体验经典操作系统
• 计算机历史教学与研究
• 复古软件开发测试环境搭建
• 怀旧应用程序运行与调试

使用方法

基本运行命令（以unRAID为例）

bash
docker run -d --name="Z80Pack" \
--net="bridge" \
-p 4200:4200 \
-e PUID="99" \
-e PGID="100" \
-e TZ="America/New_York" \
-v "/mnt/user/appdata/Z80Pack":"/config":rw \
z80pack

参数说明

环境变量

• PUID：运行容器的用户ID，默认99
• PGID：运行容器的组ID，默认100
• TZ：时区设置，如"Asia/Shanghai"（默认"America/New_York"）

端口映射

• 4200:4200：Web管理界面端口，用于访问shell in a box GUI

数据卷

• /config：容器配置目录，映射至宿主机路径（如/mnt/user/appdata/Z80Pack），用于持久化存储配置数据

访问与操作步骤

1. 访问Web界面
   通过浏览器访问 https://<宿主机IP>:4200

2. 登录认证

   • 用户名：vintage
   • 密码：computer

3. 运行模拟器
   登录后将直接进入 /root/z80pack/cpmsim 目录，执行以下命令以root权限运行模拟器：

   bash
   sudo ./cpm
   

注意事项

• 首次运行需确保宿主机已开放4200端口防火墙规则
• 时区设置建议根据实际地理位置调整（如中国用户使用"Asia/Shanghai"）
• 配置目录需保证宿主机有读写权限，避免数据丢失