使用GitHub Codespaces连接本地Microsoft SQL Server配置问题求助

问题根源 #

报错中的Name or service not known表明云端的Codespaces环境无法解析本地SQL Server的网络地址——Codespaces运行在GitHub云端，无法直接访问本地私有网络内的服务，单纯开放防火墙规则不足以解决问题。

分步解决方法 #

• 利用GitHub Codespaces本地端口转发

  1. 在本地终端执行GitHub CLI命令，将本地SQL Server端口（默认1433）转发到Codespaces环境：

     gh codespace ports forward 1433:1433
     

  2. 修改ASP.NET应用的连接字符串，将服务器地址设为localhost或127.0.0.1，转发后Codespaces内的1433端口会映射到本地SQL Server的对应端口。

• 验证SQL Server基础配置

  • 开启TCP/IP协议：打开SQL Server配置管理器，进入「SQL Server网络配置」→ 对应实例的「协议」，启用TCP/IP；在TCP/IP属性的「IP地址」页，设置TCP端口为1433。
  • 允许远程连接：在SQL Server Management Studio中，右键目标实例 → 属性 → 连接，勾选「允许远程连接到此服务器」。

• 修正连接字符串格式
  确保连接字符串参数正确，示例：

  Server=localhost,1433;Database=YourDatabaseName;User Id=YourSqlAccount;Password=YourPassword;TrustServerCertificate=True;
  

  添加TrustServerCertificate=True可绕过证书验证问题，避免额外连接阻碍。

• 备选：使用隧道工具暴露本地端口
  若GitHub端口转发失效，可借助ngrok将本地1433端口暴露至公网：

  1. 本地安装ngrok后执行：

     ngrok tcp 1433
     

  2. 将ngrok返回的公网地址（如0.tcp.ngrok.io:12345）替换到连接字符串的Server字段。

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