DNS 名称

机器生命周期

创建

orb create ubuntu                      # 最新版 Ubuntu
orb create ubuntu:noble devbox         # Ubuntu 24.04，命名为 "devbox"
orb create --arch amd64 debian x86vm   # 通过 Rosetta 进行 x86 模拟
orb create --set-password ubuntu pwvm  # 设置密码
orb create ubuntu myvm -c cloud.yml    # 使用 cloud-init

支持的发行版：Alma、Alpine、Arch、CentOS、Debian、Devuan、Fedora、Gentoo、Kali、NixOS、openSUSE、Oracle、Rocky、Ubuntu、Void

生命周期

orb start myvm      # 启动已停止的机器
orb stop myvm       # 停止机器
orb restart myvm    # 重启
orb delete myvm     # 永久删除
orb default myvm    # 设置为默认机器
orb logs myvm       # 查看启动日志

Cloud-Init

使用自动化配置创建机器：

orb create ubuntu myvm -c user-data.yml

示例 user-data.yml：

#cloud-config
packages:
  - git
  - vim
  - docker.io

users:
  - name: dev
    groups: sudo, docker
    shell: /bin/bash
    sudo: ALL=(ALL) NOPASSWD:ALL

runcmd:
  - systemctl enable docker
  - systemctl start docker

调试 cloud-init：

orb logs myvm                              # 从 macOS 查看启动日志
orb -m myvm cloud-init status --long       # 查看机器内部状态
orb -m myvm cat /var/log/cloud-init-output.log

网络

端口访问

Linux 机器中的服务器会自动映射到 localhost：

# 在 Linux 中：python3 -m http.server 8000
# 从 macOS：curl localhost:8000 或 curl myvm.orb.local:8000

从 Linux 连接到 macOS

# 从 Linux 机器
curl host.orb.internal:3000

# 从 Docker 容器
curl host.docker.internal:3000

VPN/代理

• 完全兼容 VPN，自动处理 DNS
• 自动遵循 macOS 代理设置
• 自定义代理：orb config set network_proxy http://proxy:8080
• 禁用：orb config set network_proxy none

文件共享

从 Linux 访问 macOS 文件

# 相同的路径有效
cat /Users/allen/file.txt
cat /mnt/mac/Users/allen/file.txt  # 显式前缀

从 macOS 访问 Linux 文件

ls ~/OrbStack/myvm/home/user/
ls ~/OrbStack/docker/volumes/myvolume/

传输命令

orb push ~/local.txt              # 到默认机器的 home 目录
orb pull ~/remote.txt             # 从默认机器拉取
orb push -m vm ~/f.txt /tmp/      # 到特定路径

SSH 访问

内置多路复用 SSH 服务器（无需为每个机器单独设置）：

ssh orb                    # 默认机器
ssh myvm@orb               # 特定机器
ssh user@myvm@orb          # 特定用户 + 机器

IDE 设置

VS Code ：安装 "Remote - SSH" 扩展，连接到 orb 或 myvm@orb

JetBrains ：主机 localhost，端口 32222，密钥 ~/.orbstack/ssh/id_ed25519

Ansible

[servers]
myvm@orb ansible_user=ubuntu

SSH 代理转发是自动的。

Docker 集成

容器域名

docker run --name web nginx
# 访问：http://web.orb.local （Web 服务器无需指定端口）

# Compose：<service>.<project>.orb.local

HTTPS

所有 .orb.local 域名的零配置 HTTPS：

curl https://mycontainer.orb.local

自定义域名

docker run -l dev.orbstack.domains=myapp.local nginx

主机网络

docker run --net=host nginx
# localhost 双向工作

x86 模拟

docker run --platform linux/amd64 ubuntu
export DOCKER_DEFAULT_PLATFORM=linux/amd64  # 默认使用 x86

容器中的 SSH 代理

docker run -v /run/host-services/ssh-auth.sock:/agent.sock \
  -e SSH_AUTH_SOCK=/agent.sock alpine

卷与绑定挂载

为获得性能，优先使用卷（数据保留在 Linux 中）：

docker run -v mydata:/data alpine           # 卷（快速）
docker run -v ~/code:/code alpine           # 绑定挂载（较慢）

Kubernetes

orb start k8s           # 启动集群
kubectl get nodes       # 包含 kubectl

所有服务类型都可以从 macOS 访问，无需端口转发：

curl myservice.default.svc.cluster.local  # cluster.local 有效
curl 192.168.194.20                       # Pod IP 有效
curl myservice.k8s.orb.local              # LoadBalancer 通配符

本地镜像立即可用（使用非 latest 标签或 imagePullPolicy: IfNotPresent）。

故障排除

orb report              # 生成诊断报告
orb logs myvm           # 机器启动日志
orb logs docker         # Docker 引擎日志
orb restart docker      # 重启 Docker
orb reset               # 恢复出厂设置（删除所有内容）

无法连接到 Docker 守护进程 ：使用 orb start 启动 OrbStack，或使用 docker context use orbstack 修复上下文

机器无法启动 ：检查 orb logs myvm，尝试 orb restart myvm

Rosetta x86 错误 ：安装 x86 libc：

sudo dpkg --add-architecture amd64
sudo apt update && sudo apt install libc6:amd64

配置

orb config set rosetta true        # 启用 x86 模拟
orb config set memory_mib 8192     # 内存限制（MiB）
orb config set cpu 4               # CPU 限制（核心数）
orb config set network_proxy auto  # 代理（auto/none/url）

Docker 守护进程配置位于 ~/.orbstack/config/docker.json：

{
  "insecure-registries": ["registry.local:5000"],
  "registry-mirrors": ["https://mirror.gcr.io"]
}

使用 orb restart docker 应用更改。

从 Linux 运行 macOS 命令

mac open https://example.com   # 在 macOS 浏览器中打开 URL
mac uname -a                   # 运行 macOS 命令
mac link brew                  # 链接命令以供重用
mac notify "Build done"        # 发送通知

转发环境变量：

ORBENV=AWS_PROFILE:EDITOR orb ./deploy.sh

每周安装次数

79

仓库

0xbigboss/claude-code

GitHub 星标数

36

首次出现时间

2026年1月24日

安全审计

Gen Agent Trust HubPassSocketPassSnykWarn

安装于

codex64

gemini-cli63

claude-code62

opencode61

github-copilot57

cursor57

Key Paths

DNS Names

Machine Lifecycle

Creation

orb create ubuntu                      # Latest Ubuntu
orb create ubuntu:noble devbox         # Ubuntu 24.04 named "devbox"
orb create --arch amd64 debian x86vm   # x86 emulation via Rosetta
orb create --set-password ubuntu pwvm  # With password set
orb create ubuntu myvm -c cloud.yml    # With cloud-init

Supported distros: Alma, Alpine, Arch, CentOS, Debian, Devuan, Fedora, Gentoo, Kali, NixOS, openSUSE, Oracle, Rocky, Ubuntu, Void

Lifecycle

orb start myvm      # Start stopped machine
orb stop myvm       # Stop machine
orb restart myvm    # Restart
orb delete myvm     # Delete permanently
orb default myvm    # Set as default machine
orb logs myvm       # View boot logs

Cloud-Init

Create machines with automated provisioning:

orb create ubuntu myvm -c user-data.yml

Example user-data.yml:

#cloud-config
packages:
  - git
  - vim
  - docker.io

users:
  - name: dev
    groups: sudo, docker
    shell: /bin/bash
    sudo: ALL=(ALL) NOPASSWD:ALL

runcmd:
  - systemctl enable docker
  - systemctl start docker

Debug cloud-init:

orb logs myvm                              # Boot logs from macOS
orb -m myvm cloud-init status --long       # Status inside machine
orb -m myvm cat /var/log/cloud-init-output.log

Networking

Port Access

Servers in Linux machines are automatically on localhost:

# In Linux: python3 -m http.server 8000
# From macOS: curl localhost:8000 or curl myvm.orb.local:8000

Connecting from Linux to macOS

# From Linux machine
curl host.orb.internal:3000

# From Docker container
curl host.docker.internal:3000

VPN/Proxy

• Fully VPN-compatible with automatic DNS handling
• Follows macOS proxy settings automatically
• Custom proxy: orb config set network_proxy http://proxy:8080
• Disable: orb config set network_proxy none

File Sharing

macOS Files from Linux

# Same paths work
cat /Users/allen/file.txt
cat /mnt/mac/Users/allen/file.txt  # Explicit prefix

Linux Files from macOS

ls ~/OrbStack/myvm/home/user/
ls ~/OrbStack/docker/volumes/myvolume/

Transfer Commands

orb push ~/local.txt              # To default machine home
orb pull ~/remote.txt             # From default machine
orb push -m vm ~/f.txt /tmp/      # To specific path

SSH Access

Built-in multiplexed SSH server (no per-machine setup):

ssh orb                    # Default machine
ssh myvm@orb               # Specific machine
ssh user@myvm@orb          # Specific user + machine

IDE Setup

VS Code : Install "Remote - SSH" extension, connect to orb or myvm@orb

JetBrains : Host localhost, Port 32222, Key ~/.orbstack/ssh/id_ed25519

Ansible

[servers]
myvm@orb ansible_user=ubuntu

SSH agent forwarding is automatic.

Docker Integration

Container Domains

docker run --name web nginx
# Access: http://web.orb.local (no port needed for web servers)

# Compose: <service>.<project>.orb.local

HTTPS

Zero-config HTTPS for all .orb.local domains:

curl https://mycontainer.orb.local

Custom Domains

docker run -l dev.orbstack.domains=myapp.local nginx

Host Networking

docker run --net=host nginx
# localhost works both directions

x86 Emulation

docker run --platform linux/amd64 ubuntu
export DOCKER_DEFAULT_PLATFORM=linux/amd64  # Default to x86

SSH Agent in Containers

docker run -v /run/host-services/ssh-auth.sock:/agent.sock \
  -e SSH_AUTH_SOCK=/agent.sock alpine

Volumes vs Bind Mounts

Prefer volumes for performance (data stays in Linux):

docker run -v mydata:/data alpine           # Volume (fast)
docker run -v ~/code:/code alpine           # Bind mount (slower)

Kubernetes

orb start k8s           # Start cluster
kubectl get nodes       # kubectl included

All service types accessible from macOS without port-forward:

curl myservice.default.svc.cluster.local  # cluster.local works
curl 192.168.194.20                       # Pod IPs work
curl myservice.k8s.orb.local              # LoadBalancer wildcard

Local images available immediately (use non-latest tag or imagePullPolicy: IfNotPresent).

Troubleshooting

orb report              # Generate diagnostic report
orb logs myvm           # Machine boot logs
orb logs docker         # Docker engine logs
orb restart docker      # Restart Docker
orb reset               # Factory reset (deletes everything)

Cannot connect to Docker daemon : Start OrbStack with orb start, or fix context with docker context use orbstack

Machine not starting : Check orb logs myvm, try orb restart myvm

Rosetta x86 error : Install x86 libc:

sudo dpkg --add-architecture amd64
sudo apt update && sudo apt install libc6:amd64

Configuration

orb config set rosetta true        # Enable x86 emulation
orb config set memory_mib 8192     # Memory limit (MiB)
orb config set cpu 4               # CPU limit (cores)
orb config set network_proxy auto  # Proxy (auto/none/url)

Docker daemon config at ~/.orbstack/config/docker.json:

{
  "insecure-registries": ["registry.local:5000"],
  "registry-mirrors": ["https://mirror.gcr.io"]
}

Apply with orb restart docker.

macOS Commands from Linux

mac open https://example.com   # Open URL in macOS browser
mac uname -a                   # Run macOS command
mac link brew                  # Link command for reuse
mac notify "Build done"        # Send notification

Forward env vars:

ORBENV=AWS_PROFILE:EDITOR orb ./deploy.sh

Weekly Installs

79

Repository

0xbigboss/claude-code

GitHub Stars

36

First Seen

Jan 24, 2026

Security Audits

Gen Agent Trust HubPassSocketPassSnykWarn

Installed on

codex64

gemini-cli63

claude-code62

opencode61

github-copilot57

cursor57

AI新闻播客制作技能：实时新闻转对话式播客脚本与音频生成

1,200 周安装