如何让Docker容器内的ASP.NET应用连接主机SQL Server？

一、Windows主机适配方案 #

1. 用Docker特殊DNS指向主机 #

Docker Desktop for Windows提供专属DNS名称host.docker.internal，可直接指代主机。修改连接字符串如下：

Server=host.docker.internal,1433;Database=你的数据库名;User Id=你的SQL账号;Password=你的密码;Trusted_Connection=False;

注意：若用Windows身份验证（Trusted_Connection=True），容器进程默认使用自身账户，无法直接通过主机Windows认证，建议改用SQL Server账号登录。

2. 开启SQL Server远程连接权限 #

• 打开SQL Server配置管理器，找到SQL Server网络配置→SQLExpress的协议，启用TCP/IP协议。
• 双击TCP/IP，切换到IP地址标签页，拉至最底部设置IPAll的TCP端口为1433，重启SQL Server服务。
• 在Windows防火墙中添加入站规则，允许1433端口的TCP连接。

3. 固定SQL Server端口 #

确保SQL Express禁用动态端口，固定使用1433，避免端口变动导致连接失败。

二、Linux/macOS主机适配方案 #

1. 复用Docker特殊DNS #

Docker Desktop for Mac/Linux同样支持host.docker.internal，替换连接字符串中的主机名即可：

Server=host.docker.internal,1433;Database=你的数据库名;User Id=你的SQL账号;Password=你的密码;

2. 直接使用主机局域网IP #

若host.docker.internal不生效，可直接替换为主机的局域网IP（如192.168.1.100），连接字符串示例：

Server=192.168.1.100,1433;Database=你的数据库名;User Id=你的SQL账号;Password=你的密码;

三、通用注意事项 #

• 确认SQL Server登录账户拥有远程连接权限，且服务器开启SQL Server和Windows身份验证模式（在SSMS中右键服务器→属性→安全性设置）。
• 连接外部机器的SQL Server时，需确保目标机器防火墙开放1433端口，且SQL Server已配置允许远程连接。
• 容器内的localhost或127.0.0.1指向容器自身，切勿用来指代主机。

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