云数据库 GAUSSDB-连接设置:listen_addresses

时间：2025-01-23 04:58:58

云数据库 GAUSSDB 连接和认证

listen_addresses

参数说明：声明服务器侦听客户端的TCP/IP地址。

该参数指定 GaussDB 服务器使用哪些IP地址进行侦听，如IPV4。服务器主机上可能存在多个网卡，每个网卡可以绑定多个IP地址，该参数就是控制GaussDB绑定在哪个或者哪几个IP地址上。而客户端则可以通过该参数中指定的IP地址来连接GaussDB或者给GaussDB发送请求。

该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。

取值范围：

主机名或IP地址，多个值之间用英文逗号分隔。
星号“*”或“0.0.0.0”表示侦听所有IP地址。配置侦听所有IP地址存在安全风险，不推荐用户使用。必须与有效地址结合使用（比如本地IP等），否则，可能造成Build失败的问题。同时，主备环境下配置为“\*”或“0.0.0.0”时，主节点数据库路径下postgresql.conf文件中的localport端口号不能为数据库dataPortBase+1，否则会导致数据库无法启动。
当该参数值非法时（如包含非法IP、非法字符，参数值为空，或重复侦听），进程将启动失败。

默认值：数据库实例安装好后，根据public_cloud.conf配置文件中不同实例的IP地址配置不同默认值。DN的默认参数值为：listen_addresses = 'data.net网卡对应的IP地址'。

public_cloud.conf文件保存的网卡信息，包括：mgr.net（管理网卡）、data.net（数据网卡）、virtual.net（虚拟网卡）。
支持gs_guc reload方式进行设置该参数值，GaussDB内核会按照“侦听新IP、保留重复IP的侦听、关闭无效IP侦听”的策略，动态侦听该参数配置的IP。若存在非法IP（如本机未配置此IP、无效的IP值、该IP已被侦听等）时，内核侦听IP失败，此时会出现listen_addresses设置值和实际侦听IP的状况不匹配。
若通过gs_guc reload方式设置参数值，且参数值中均为非法IP时，侦听新IP失败，同时会取消全部旧IP的侦听。若参数为空时，直接拦截而保持旧IP侦听。
若在进程启动参数中配置listen_addresses后，该参数将强制指定为设置值而不会被reload修改。
若设置新参数值和已设置旧参数值相同时，将不再进行侦听动作。故设置listen_addresses参数值且列表中某非法IP时，内核侦听此IP失败；待IP变为合法后，再次设置相同参数值，由于前后两次参数值相同，则不会侦听此IP。此时需通过gs_guc reload方式将此IP从参数值中去除，并再次设置添加该IP，才会成功侦听。
通过gs_guc reload方式刷新该参数后，若不再侦听某IP后，需再执行gs_validate_ext_listen_ip函数进行清理连接操作，具体入参及执行详见该函数说明。
禁止gs_guc工具通过"-N all"方式reload刷新所有DN的listen_addresses参数值，仅允许单DN设置。
动态修改listen_addresses属于高危操作，若配置有误可能导致数据库无法接受新连接，进而影响业务，请谨慎操作。