用途：OrbStack 是 macOS 上快速轻量的 Docker 与 Linux 虚拟机运行时，本指南整理其命令行使用、机器管理、网络与文件互通等实践要点。
主要能力：使用 orb 命令启动/停止 OrbStack、创建和管理 Linux 机器（支持 Alma、Alpine、Arch、CentOS、Debian、Fedora、Ubuntu 等发行版，可通过 --arch amd64 在 Apple Silicon 上模拟 x86）；用 cloud-init 文件自动配置机器；Linux 端口自动映射到 macOS localhost，并提供 <machine>.orb.local、<container>.orb.local、host.orb.internal 等 DNS 名称；macOS 与 Linux 之间可同路径或经 ~/OrbStack/ 与 /mnt/mac/ 互访文件，也可用 orb push/pull 传输；内置多路复用 SSH 服务，可直接 ssh orb 或 ssh myvm@orb。
使用方式：常用命令包括 orb start/stop、orb list、orb create、orb delete、orb default、orb logs，以及 orb config set memory_mib/cpu/network_proxy、orb restart docker、orb start k8s。Docker 容器可通过 .orb.local 域名访问并默认获得 HTTPS；建议用 volumes 而非 bind mount 以提升性能；kubectl 随附，集群内服务无需端口转发即可从 macOS 访问。诊断可用 orb report、orb reset。
适用场景：本地开发中需要 Linux 环境、Docker 容器或 Kubernetes 集群，并希望与 macOS 深度集成、保持高性能的开发者。
限制：资料未提供收费、价格与平台支持范围等信息。x86 模拟需启用 rosetta 并可能需安装相应 libc；orb reset 会删除全部数据，需谨慎使用。