VSCode devcontainer在Docker卷克隆仓库后重开与IP访问问题

1. 关闭VSCode后重新进入命名容器卷工作区 #

• 打开VSCode，点击左下角绿色的远程开发状态按钮
• 在弹出的命令面板中选择「Containers: Open Folder in Container...」
• 容器列表会同时展示运行中、已停止的容器，找到和克隆仓库名匹配的目标容器（自动创建的容器命名格式通常为/vscode/<仓库名>-<随机后缀>），选中即可自动启动容器并加载命名卷内的工作区，所有代码、环境配置都不会丢失。
• 如果列表中找不到对应容器，可先打开Docker的容器面板确认容器未被手动删除，只要关联的命名卷未被清理，卷内存储的代码和配置就不会丢失。
• 如果后续需要快速识别，可以在第一次进入工作区后，右键点击Docker面板里的对应容器，添加自定义别名。

2. 容器内运行的服务无法被本地应用访问 #

问题原因 #

• 直接访问localhost默认指向宿主机回环地址，未做端口转发时请求无法抵达容器内部
• 通过容器内ifconfig查询到的IP属于Docker内部私有网段：Windows/macOS环境下宿主机本身没有到该网段的路由，Linux环境下默认防火墙规则会拦截外部对该网段的直接访问，直接访问容器IP必然失败。

解决步骤 #

• 临时使用无需改配置的操作方式：
  • 进入容器工作区后，打开底部面板的「Ports」标签（和终端、输出面板同栏）
  • 点击「Forward a Port」按钮，输入容器内服务监听的端口号（如3000、8080）后回车
  • 转发完成后面板会显示本地绑定的端口，直接访问localhost:<本地端口>即可访问容器服务，本地部署的其他应用也可以通过该地址正常调用
  • 注意：如果服务启动时默认绑定127.0.0.1，需要修改启动配置让服务监听0.0.0.0地址，否则端口转发会连接失败。例如Python Flask启动命令改为flask run --host=0.0.0.0，Nodejs服务listen配置指定host为0.0.0.0。
• 永久配置（重建容器也自动生效）：
  • 打开工作区内的.devcontainer/devcontainer.json配置文件，没有该文件可以通过命令面板的「Dev Containers: Add Dev Container Configuration Files」生成
  • 添加forwardPorts配置项声明需要自动转发的端口，示例配置：

    {
      "forwardPorts": [3000, 8080]
    }
    

  • 保存后选择重建容器，后续每次启动开发容器时，列出的端口都会自动完成转发，无需手动操作。
• 如果需要让局域网内其他设备访问容器服务，在Ports面板右键点击对应转发端口，将「Port Visibility」设置为「Public」即可，无需手动修改Docker网络配置。

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