1

检查系统架构与版本兼容性

PG模拟器 需要与设备的处理器架构和操作系统版本匹配。开始安装前,请先确认当前设备是否满足最低运行要求。不同系统版本对内核模块与依赖库的支持程度存在差异,提前检查可避免安装中断。

  • 确认处理器架构为 x86_64、ARM64 或 RISC-V 之一
  • Windows 系统需 10 Build 19044 或更高版本,macOS 需 12.0 Monterey 及以上
  • Linux 发行版内核版本不低于 5.10,推荐 5.15 或 6.1 LTS
  • 检查可用内存是否大于 4GB,存储空间预留 8GB 以上
  • 确认用户账户具备管理员或 sudo 权限
系统架构 x86_64 / ARM64 内核 5.10+
PG模拟器系统架构检查示意图
2

安装运行库与依赖组件

PG模拟器 依赖一组基础运行库来执行虚拟化、网络通信与图形渲染任务。不同操作系统使用的包管理器和依赖名称略有差异,本文列出各平台的参考命令。

# Windows (PowerShell / 管理员) winget install Microsoft.VCRedist.2022.x64 dism /online /enable-feature /featurename:HypervisorPlatform /all /norestart
# macOS (Homebrew) brew install openssl sqlite pcre2 libxml2
# Ubuntu/Debian sudo apt update && sudo apt install -y build-essential libssl-dev zlib1g-dev libffi-dev
运行库 VC++ Redistributable OpenSSL 3.x
PG模拟器依赖组件安装示意图
3

配置环境变量与权限策略

环境变量是 PG模拟器 定位运行时文件的关键。配置错误会导致启动时提示"运行时组件缺失"或"动态库加载失败"。同时需要设置防火墙放行规则,保证模拟实例的网络通信正常。

# Windows 环境变量示例 setx PATH "%PATH%;C:\PGSimulator\runtime\bin" /M setx PG_SIMULATOR_HOME "C:\PGSimulator" /M
# Linux / macOS 环境变量示例 export PG_SIMULATOR_HOME=/opt/pgsimulator export PATH=$PG_SIMULATOR_HOME/bin:$PATH sudo firewall-cmd --permanent --add-port=8088/tcp && sudo firewall-cmd --reload
环境变量 PG_SIMULATOR_HOME 端口 8088
PG模拟器环境变量配置示意图
4

初始化模拟器并生成基础配置

首次运行 PG模拟器 需要执行初始化命令,该过程会创建默认配置目录、生成设备拓扑文件并下载基础组件。初始化完成后可通过控制台查看当前版本与组件状态。

# 初始化命令 pgsim init --config-dir /etc/pgsimulator --runtime-version latest # 查看初始化结果 pgsim status --verbose
  • 初始化默认创建 config/、runtime/、instances/ 三个子目录
  • 基础组件下载大小约 380MB,建议使用稳定网络
  • 可通过 --mirror 参数指定国内加速镜像
初始化 pgsim init 镜像加速
PG模拟器初始化配置示意图
5

验证安装并运行自检程序

安装完成后需要执行自检命令,确认所有运行时组件、驱动接口与网络模块均已正确加载。自检程序会输出多维度的健康状态报告,帮助定位潜在问题。

# 运行完整自检 pgsim doctor --full-report # 输出示例:核心模块 12/12 正常,驱动 3/3 已加载,网络延迟 12ms
  • 检查 runc / containerd 等容器运行时是否可用
  • 验证虚拟化引擎(KVM / Hyper-V / Virtualization.framework)启用状态
  • 测试默认网关到本地交换网络的连通性
自检 pgsim doctor 健康报告
PG模拟器安装验证自检示意图
6

创建首个模拟实例并启动运行

完成验证后即可创建第一个 PG模拟器 实例。每个实例拥有独立的配置目录、网络命名空间与存储卷,支持同时运行多个互不干扰的模拟环境。

# 创建实例 pgsim instance create --name dev-sandbox --image base:latest # 启动实例 pgsim instance start dev-sandbox # 查看实例列表 pgsim instance list
实例管理 dev-sandbox 多实例运行
PG模拟器创建模拟实例示意图

PG模拟器最低系统要求

以下为运行 PG模拟器 的最低配置。推荐配置可提供更流畅的多实例并发体验,尤其在同时运行多个模拟环境或进行性能测试时差距明显。

🖥

处理器

最低:双核 2.0GHz,支持硬件虚拟化
推荐:四核 3.0GHz 以上

🧠

内存

最低:4GB 可用 RAM
推荐:16GB,多实例建议 32GB

💾

存储空间

最低:8GB 可用空间
推荐:NVMe SSD,预留 50GB 以上

🌐

网络

最低:10Mbps 带宽
推荐:千兆局域网,支持端口映射

🪟

Windows 环境

Windows 10 Build 19044 及以上
Windows Server 2019 及以上

🍎

macOS 环境

macOS 12 Monterey 及以上
Apple Silicon 或 Intel 芯片

🐧

Linux 环境

Ubuntu 20.04 / 22.04 / 24.04
Debian 11 / 12,CentOS Stream 9

⚙️

虚拟化支持

KVM、Hyper-V 或 Apple Virtualization.framework
需在 BIOS/UEFI 中开启 VT-x/AMD-V

安装后快速验证

完成所有安装步骤后,执行以下命令可在 10 秒内判断 PG模拟器 是否部署成功。若输出中显示核心模块正常、驱动已加载、网络延迟低于 30ms,即表示安装生效。

pgsim doctor --quick && pgsim instance list

通过验证后即可开始创建模拟实例。建议首次使用时先创建小型实例测试配置效果,确认无误后再扩展至生产环境。

PG模拟器安装后验证测试示意图

PG模拟器安装部署常见问题

以下列举安装部署过程中出现频率最高的 6 个问题与解决办法,帮助快速排除障碍。

此问题通常由 VC++ Redistributable 或 OpenSSL 依赖未正确安装导致。请先确认是否已通过管理员权限执行安装命令,并检查系统 PATH 中是否将 PG_SIMULATOR_HOME 指向正确的 runtime\bin 目录。若问题依旧存在,可执行 pgsim doctor --check-deps 查看缺失组件列表并逐一补齐。
请先用 lscpu/proc/cpuinfo 确认 CPU 是否支持虚拟化扩展。然后检查 BIOS/UEFI 中是否已开启 Intel VT-x 或 AMD-V。若使用 KVM,可运行 kvm-ok 查看详细状态。部分云服务器需要联系服务商启用嵌套虚拟化后才可正常使用 PG模拟器。
macOS 对未签名或新安装的系统扩展有安全性拦截。请打开「系统设置」→「隐私与安全性」,查看是否有 PG模拟器 相关的扩展可允许载入。若使用 Apple Silicon 设备,请确认 Rosetta 2 已安装(适用于部分 Intel 组件)。执行 sudo spctl --master-disable 可临时关闭 Gatekeeper,但建议仅在确认来源可靠时使用。
PG模拟器 默认每个实例分配 2GB 内存。可在创建实例时通过 --memory 1024 参数降低占用,或修改 instances/ 目录下对应配置文件中的 memory_limit 值。建议根据实际负载动态调整,并关闭不必要的后台服务以释放系统资源。对于密集型测试,推荐使用 32GB 以上内存的宿主机。
高延迟通常与防火墙规则或网络命名空间配置有关。请检查是否已放行 8088/tcp 端口,并确认宿主机与模拟实例使用的网络模式一致。可运行 pgsim network diagnose 查看路由表和 NAT 状态。在 Linux 下使用 macvlan 模式可显著降低跨实例通信延迟,但需要宿主机物理网卡支持。
PG模拟器 的 CLI 工具支持 --non-interactive--yes 参数,可在脚本中跳过确认步骤。建议结合 --config-file 指定预先编辑好的 YAML 配置文件,同时使用 --log-level info 记录部署日志。完整示例可在资源中心下载自动化部署模板。

获取你的 PG模拟器 安装配置方案

提交你的设备环境与使用场景,我们会根据 PG模拟器 的版本特性与兼容性数据库,输出一份可直接执行的安装配置清单。

  • 根据处理器架构与系统版本匹配依赖组件
  • 提供环境变量与防火墙放行的完整命令
  • 预检存储、内存与虚拟化开启状态
  • 附带常见错误码与安装后自检命令