OrbStack Linux 系统机器网络配置详解

OrbStack 为其 Linux 机器构建了一个高度集成、高性能且可靠的自定义虚拟网络栈，旨在提供无缝的网络体验。它能自动跟随 macOS 的网络设置（如 VPN 和代理），并实现了所有常见的网络功能。

核心特性

高性能: macOS 与 Linux 间吞吐量高达 45 Gbps，机器间通信可达 115 Gbps (在 M1 芯片上)。
零配置: 大部分功能开箱即用，无需手动设置。
无缝集成: 自动遵循 macOS 的 VPN、DNS 和代理设置。
功能完整: 支持 IPv4/IPv6、ping、traceroute 等标准网络工具。

详细功能与使用方法

1. 域名 (Domain Names)
每台机器自动获得一个本地域名，格式为 机器名.orb.local。

示例:
如果你的机器名为 ubuntu，你可以直接在 macOS 或其他机器上通过 ubuntu.orb.local 访问它。

2. 在 Linux 中运行服务 (Running Servers)
在 Linux 机器中启动的任何服务，都可以直接从 macOS 通过 localhost 访问。

命令示例:
bash
在 Linux 机器中启动一个 Python HTTP 服务器

python3 -m http.server 8000

访问方式:
在 macOS 的浏览器或终端中，直接访问 http://localhost:8000 即可。

注意: 如果你的服务监听在 0.0.0.0 (IPv4) 或 :: (IPv6)，它也会被网络中的其他设备访问到。

3. 从 Linux 连接 macOS 服务 (Connecting to Mac servers)
使用特殊主机名 host.orb.internal 来连接运行在 macOS 上的服务。

命令示例:
bash
在 Linux 中连接 macOS 上运行的 MySQL 服务

mysql -h host.orb.internal -u root -p

重要限制: 为了防止意外行为，不能直接从 Linux 机器通过 localhost 连接到 macOS 上的服务。必须使用 host.orb.internal。

4. 机器间互连 (Connecting between machines)
所有 Linux 机器都连接在同一个虚拟网络桥接器上，可以直接通过 IP 地址互相访问。

如何查找机器 IP:
在目标机器中运行 ip addr 命令。

bash

ip addr

输出示例：

2: eth0@if6: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc noqueue state UP group default qlen 1000
    link/ether 46:51:ff:fb:a0:2f brd ff:ff:ff:ff:ff:ff link-netnsid 0
    inet 198.19.249.204/24 metric 1024 brd 198.19.249.255 scope global dynamic eth0 // [!code focus:3]
       valid_lft 170414sec preferred_lft 170414sec
    inet6 fd07:b51a:cc66:0:4451:ffff:fefb:a02f/64 scope global mngtmpaddr noprefixroute
       valid_lft forever preferred_lft forever

IPv4 地址: 198.19.249.204
IPv6 地址: fd07:b51a:cc66:0:4451:ffff:fefb:a02f

使用方式:
在另一台机器中，使用 curl 198.19.249.204 或 ping fd07:b51a:cc66:0:4451:ffff:fefb:a02f 即可连接。

5. 从 macOS 连接 Linux 机器 (Connecting from Mac to machines)
除了使用 localhost 访问服务端口外，你也可以直接使用 Linux 机器的 IP 地址进行连接。

命令示例:
bash
在 macOS 终端中，直接通过 IP 地址访问 Linux 机器上的服务

curl 198.19.249.204

6. 连接 Docker 容器 (Connecting to Docker containers)
如果你从 macOS 启动了 Docker 容器并映射了端口，可以在 Linux 机器中通过 docker.orb.internal 访问它们。

操作示例:
bash
在 macOS 终端中启动一个 Nginx 容器

docker run --rm -p 80:80 nginx

在 Linux 机器中访问该容器

curl docker.orb.internal

7. VPN 兼容性 (VPN Compatibility)
OrbStack 的网络栈完全兼容各种 VPN，包括复杂的 DNS 解析器设置。启用 VPN 后，Linux 机器的网络流量会自动通过 VPN 隧道，无需任何额外配置。

8. 代理设置 (Proxies)
Linux 机器会自动继承 macOS 的系统代理设置（HTTP, HTTPS, SOCKS），无需手动配置 HTTPPROXY 环境变量。

自定义代理配置
你可以为 OrbStack 单独设置代理，而不影响 macOS 其他应用。

bash

# 设置 HTTP 代理
orb config set network_proxy http://example.com

# 设置带用户名密码的 HTTPS 代理 (端口 8443)
orb config set network_proxy https://user:password@example.com:8443

# 设置带用户名密码的 SOCKS5 代理 (端口 1081)
orb config set network_proxy socks5://user:password@example.com:1081

# 恢复为跟随 macOS 系统代理
orb config set network_proxy auto

# 完全禁用代理
orb config set network_proxy none

macOS 中配置的代理排除列表（Proxy Exclusions）也会被 OrbStack 自动遵守。

9. 自签名证书 (Self-signed certificates)
OrbStack 使用 macOS 的钥匙串（Keychain）。因此，任何在 macOS 钥匙串中被标记为“始终信任”的 SSL 证书，在 Linux 机器中也会被信任，无需额外导入。

总结

OrbStack 的网络设计目标是“无感”和“高性能”。无论是本地开发、机器间通信、连接 Docker，还是在 VPN/代理环境下工作，它都能提供稳定、快速且符合直觉的体验，极大地简化了开发环境的网络配置复杂度。