✅ OrbStack 自定义 Docker 容器 IP 段(避免冲突)

社区话题 Linux/macOS 与自动化运维 ✅ OrbStack 设置与开发优化指南 ✅ OrbStack 自定义 Docker 容器 IP 段(避免冲突)

#768

追光
管理员

OrbStack 中,Linux machine 的 IP 无法自定义(官方明确限制),只能修改 容器网络的 IP 范围

根据 OrbStack 官方文档和 CLI 功能:


为什么 machine IP 不能改?

  • OrbStack 的 Linux machine 运行在虚拟化环境中,IP 是自动分配的,并且绑定在 macOS 内部桥接网络。

  • 官方明确说明:Linux machine IP 段固定,不能更改


能修改哪些 IP?

可以修改 Docker 容器网络的子网,避免和 VPN 或其他网络冲突。

步骤:

  1. 查看当前网络配置

orb config get docker.network_subnet
  1. 修改容器 IP 段(示例:改为 192.168.200.0/24)

orb config set docker.network_subnet 192.168.200.0/24
  1. 重启 OrbStack 使配置生效

orb restart
  1. 验证新 IP 段

    启动一个容器并查看 IP:

docker run -it --rm alpine ip a

容器 IP 应显示在 192.168.200.x 网段。


注意:

  • Linux machine IP 段无法修改,只可改容器网络。

  • 如果 VPN 冲突,选一个未占用的网段即可。