🍎 虚拟化环境配置
大约 3 分钟
提示
KBEngine 不支持直接在MacOS环境中开发，但我们可以借助虚拟机或者Docker
注意
OrbStack仅适用于Mac用户， Windows用户直接使用Docker Desktop 和其他虚拟机产品即可
什么是 OrbStack？
OrbStack 是 macOS 上的一款轻量级虚拟化平台，支持运行 Docker 容器、Linux 虚拟机和开发环境。它旨在替代 Docker Desktop，提供更快、更省资源、更符合开发者习惯的解决方案。其核心优势包括启动速度快、资源占用低、深度集成 macOS 生态、图形界面简洁易用。OrbStack它不仅替代了传统的WSL和Docker Desktop，还集成了强大功能于一身，致力于提升您的开发效率。
为什么使用 OrbStack ？
众所周知，Apple Silicon M系列芯片是ARM架构，KBEngine因历史原因只能运行在x86架构下，使用OrbStack可以在ARM架构下运行x86镜像。
OrbStack在运行x86镜像时，会使用 QEMU 自动仿真，不过性能会有所下降。
主要功能
1.1. Docker 支持
- 完全兼容 Docker CLI 与 Docker Compose。
- 支持使用 Linux 容器，无需安装 Docker Desktop。
- 可与 Docker Hub 等注册中心无缝集成。
- OrbStack支持单节点Kubernetes环境，是微服务开发的理想选择
1.2. Linux 虚拟机（VM）管理
- 可以启动多台轻量 Linux 虚拟机（基于 Ubuntu 或 Alpine 等）。
- 支持 SSH 访问、文件共享、端口转发。
- 可作为开发环境使用，支持图形化文件浏览器。
1.3. 文件共享与网络
- 宿主机与虚拟机/容器之间的文件系统共享高效、低延迟。
- 自动端口映射，可从 macOS 直接访问虚拟机/容器服务。
- 支持 host 网络、桥接等多种模式。
1.4. 图形化界面与 CLI 工具
- 提供简洁的 GUI 管理界面。
- 提供 orbstack 命令行工具，用于管理 VM、容器、镜像等。
安装与配置
1.1. 安装步骤
1.1.1官方下载安装：
- 访问官网：https://orbstack.dev
- 点击 Download 下载安装包（支持 macOS 11+，Apple Silicon 和 Intel 芯片均支持）。
- 拖入 Applications 文件夹，打开 OrbStack。
- 首次运行将提示安装虚拟化扩展，按提示授权即可。
- 📝 注意：需要开启 macOS 的虚拟化功能（无需额外安装 VirtualBox 或 HyperKit）
- 3.1.2安装完成后，OrbStack 会自动安装并配置 Docker 和默认 Linux VM（如 Ubuntu）。
Docker （推荐）
一、拉取 Docker 镜像
二、运行
三、配合 KBEX 插件完成开发
KBEX 插件提供了远程开发的功能
1. 在SSH配置中填写相关信息
- IP：127.0.0.1 （或使用实际随机分配的Domain）
- 账号：kbe
- 密码：kbe
虚拟机
OrbStack 同样提供了虚拟机功能。
一、创建虚拟机
- 虚拟机名称：kbe
- 版本：Ubuntu 22.04 LTS
- CPU type：Intel (KBE只能运行在x86架构下)
- username:kbe
二、编译KBEngine
参考《安装和启动》
三、配合 KBEX 插件完成开发
KBEX 插件提供了远程开发的功能
1. 虚拟机安装SSH
sudo apt install ssh
2. 修改虚拟机密码
orb -m kbe sudo passwd {你设置的密码}
宿主机中尝试 ssh 用户@ubuntu.orb.local SSH登录，进入虚拟机则成功（用户和ubuntu.orb.local 自行替换）
3. 在SSH配置中填写相关信息
- IP：ubuntu.orb.local （根据实际情况修改，OrbStack Info -> Domain）
- 账号：kbe （上述创建时填写的username）
- 密码：以上自行生成的密码（点我跳转）
四、下载
当然，你也可以使用我们已经创建并编译好的虚拟机
SSH账号密码：kbe:kbe