kingbase 怎么修改端口

默认端口：54321，工具命令：sys_initdb（金仓初始化工具，对应 PG 的 initdb）

一、实例还未初始化：初始化时直接指定端口

1、命令行 sys_initdb 初始化指定端口

切换金仓运行用户 kingbase 执行：

su - kingbase
# 语法：--port / -p 指定端口；-D 数据目录；-U 超级管理员账号system
# 示例：初始化端口 54322
$KINGBASE_HOME/bin/sys_initdb \
-D /opt/kingbase/data \
-U system \
--port=54322 \
--pwfile=/tmp/pwd.txt  # 提前把管理员密码写入pwd.txt一行

 

简写短参数：

sys_initdb -D /opt/kingbase/data -U system -p 54322

 

初始化完成后，自动在 kingbase.conf 写入 port = 54322，后续启动直接生效。

2、图形化安装向导设置端口

运行 setup.sh 图形安装，初始化步骤页面直接填写 DB_PORT=自定义端口 。

3、静默安装配置文件指定端口

编辑 install.conf：

DB_PORT=54322
DB_USER=system
DB_PASS=xxx

 

二、数据库已经初始化完毕，事后修改监听端口

步骤 1：停止数据库服务

su - kingbase
sys_ctl stop -D $KINGBASE_DATA

 

步骤 2：修改核心配置 kingbase.conf

vi $KINGBASE_DATA/kingbase.conf

 

找到 port 参数，取消注释修改：

port = 54322        # 修改为目标端口
listen_addresses = '*'  # 如需远程访问放开监听

 

保存退出。

步骤 3：（可选）集群 / 流复制环境同步修正

如果搭建了主备集群：

 

备库 recovery.conf / standby.signal 里的 primary_conninfo 中的主库 IP 端口同步改成新端口。

步骤 4：放行防火墙端口（麒麟 V10/CentOS）

# firewalld放行
firewall-cmd --permanent --add-port=54322/tcp
firewall-cmd --reload

 

步骤 5：重启数据库验证

sys_ctl start -D $KINGBASE_DATA
# 验证端口监听
netstat -tlnp | grep kingbase
# 数据库内查看当前端口
ksql -U system -p 54322
show port;

 

三、临时环境变量临时指定端口（不固化配置）

# 临时生效，当前会话启动使用该端口
export KINGBASE_PORT=54322
sys_ctl start -D $KINGBASE_DATA

 

四、常见注意事项

1. 端口取值：1025~65535，避开已占用端口；
2. 修改端口必须重启实例，在线动态修改不支持；
3. 客户端连接时必须带 -p 指定新端口：

   ksql -U system -h 127.0.0.1 -p 54322
   

    
4. 如果你之前是银河麒麟 V10 部署，注意 SELinux、防火墙放行新端口。