如何配置Docker网络默认使用宿主机VPN连接访问私有GitLab包注册表

方案1：使用宿主机网络模式（开发环境优先推荐） #

该模式会让容器直接共享宿主机的完整网络栈，宿主机的VPN路由、DNS规则全部会直接生效，无需额外网络配置，是开发场景下最高效的解决方案。
操作步骤：

• 直接运行容器时添加--network host参数即可，示例命令：

  docker run -d --network host your-react-dev-image
  

• 若使用docker-compose管理容器，在对应服务的配置块下添加参数：

  services:
    react-dev:
      image: your-react-dev-image
      network_mode: "host"
      # 其余原有配置保持不变
  

注意：Linux原生Docker可直接使用该模式，Windows/macOS桌面版Docker需要在设置中开启「Allow the default Docker socket to be used」相关权限；使用host模式后容器端口将直接占用宿主机对应端口，不需要再使用-p参数做端口映射

方案2：配置Docker网桥路由与DNS（保留桥接模式时使用） #

如果不希望容器共享宿主机完整网络栈，可通过修改Docker默认网桥配置适配VPN规则：
操作步骤：

• 第一步先获取VPN相关信息：执行ip route（Linux）或ifconfig（macOS）命令，确认宿主机VPN的虚拟网卡名称（通常为tun0/utun0这类命名）、内网DNS服务器地址、私有GitLab服务所在的网段
• 编辑Docker daemon配置文件/etc/docker/daemon.json，添加内网DNS配置：

  {
    "dns": ["你的内网DNS地址1", "你的内网DNS地址2", "8.8.8.8"]
  }
  

• 重启Docker服务让配置生效：

  sudo systemctl restart docker
  

• 若仍无法访问私有服务，手动添加静态路由规则，让容器访问内网网段的流量走VPN网卡：

  ip route add <私有GitLab所在网段> via <宿主机VPN网关IP> dev <VPN虚拟网卡名>
  

方案3：临时配置包管理器代理（仅解决yarn install问题时使用） #

如果仅需要临时解决私有npm包拉取问题，可直接在容器内配置yarn走宿主机代理：

• 先确认宿主机VPN对应的本地代理端口（常见HTTP代理端口为7890、Socks5代理端口为1080）
• 进入容器后执行以下配置命令：

  yarn config set proxy http://<宿主机本地IP>:<代理端口>
  yarn config set https-proxy http://<宿主机本地IP>:<代理端口>
  yarn config set registry <你的私有GitLab npm注册表地址>
  

配置完成后再执行yarn install即可正常拉取私有包。

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