在macOS通过Lima运行Nomad时无法启动Docker容器

问题背景 #

在Mac设备上使用Lima部署docker-rootful虚拟机，配置Docker上下文后可正常运行容器，但启动Nomad开发节点并运行官方Redis任务时，容器启动失败，报错无法绑定主机局域网IP。

环境配置回顾 #

1. Lima与Docker配置正常：

   limactl start template://docker-rootful
   
   docker context create lima-docker-rootful --docker "host=unix:///Users/antonin/.lima/docker-rootful/sock/docker.sock"
   docker context use lima-docker-rootful
   

   运行docker run --rm -p8080:80 nginx可通过localhost:8080正常访问。

2. Nomad Docker插件配置：

   plugin "docker" {
       config {
         // endpoint = "unix:///var/run/docker.sock"
         // 使用Lima的Docker套接字
         endpoint = "unix:///Users/antonin/.lima/docker-rootful/sock/docker.sock"
       }
   }
   

3. Nomad启动命令：

   sudo nomad agent -dev -config=docker.nomad -bind=0.0.0.0 -network-interface=en0
   

报错信息 #

2023-02-15T22:57:24.796+0100 [DEBUG] client.driver_mgr.docker: failed to start container: driver=docker container_id=196030610c2795d6876386e799e03dd9f9afa3b391d6c093ab1d03616daf1949 attempt=5 error="API error (500): driver failed programming external connectivity on endpoint redis-bc2b6d1d-9241-ccb8-c5ad-3e649f018208 (df95904fed93d4be70fc0c3bf1682dbead84ba71f2a321443fba09ff0c43dd69): Error starting userland proxy: listen tcp4 192.168.1.120:28033: bind: cannot assign requested address"

其中192.168.1.120是Mac主机的局域网IP。

问题分析 #

1. 网络接口不匹配：Nomad运行在Mac主机上，指定-network-interface=en0（主机网卡），但Docker服务实际运行在Lima虚拟机内，虚拟机无法直接绑定主机的局域网IP，导致端口绑定失败。
2. Docker上下文未生效：docker info输出显示当前上下文为default（Docker Desktop），而非配置的lima-docker-rootful，Nomad可能连接到了错误的Docker实例。

修复步骤 #

1. 确保Docker上下文切换正确 #

先确认当前Docker上下文：

docker context ls

若未使用lima-docker-rootful，执行切换命令：

docker context use lima-docker-rootful

再次执行docker info，验证Server信息对应Lima虚拟机而非Docker Desktop。

2. 修改Nomad启动参数，适配Lima网络 #

获取Lima虚拟机的IP：

limactl list docker-rootful

或进入虚拟机查看网卡IP：

limactl shell docker-rootful ip addr show eth0

将Nomad绑定到Lima虚拟机的IP或其内部网卡：

sudo nomad agent -dev -config=docker.nomad -bind=<LIMA_VM_IP> -network-interface=eth0

或简化为绑定虚拟机的所有接口：

sudo nomad agent -dev -config=docker.nomad -bind=0.0.0.0 -network-interface=eth0

3. 调整Nomad任务网络配置 #

在任务的network块中添加桥接模式，让容器使用Lima内部网络：

group "cache" {
  count = 1
  network {
    mode = "bridge"
    port "db" {
      to = 6379
    }
  }
  // 其余配置保持不变
}

若需限制端口仅绑定到虚拟机回环，可添加host_network：

port "db" {
  to = 6379
  host_network = "127.0.0.1"
}

4. 配置Lima端口转发（可选） #

若要从Mac主机访问Redis服务，编辑Lima虚拟机配置：

limactl edit docker-rootful

添加端口转发规则：

ssh:
  localForward:
    - guestPort: <任务分配的端口>
      hostPort: 6379

重启Lima虚拟机：

limactl restart docker-rootful

之后即可通过localhost:6379访问Redis。

内容的提问来源于stack exchange，提问作者Antonin