

> **作者**：马顺华（shunwah）  
> **认证**：OceanBase OBCP、MySQL OCP、金仓 KCP/KCA、TiDB MVA 等十余项  
> **标签**：#国产数据库 #KingbaseES #openEuler #部署实战  

![公众号首图封面设计 (2).jpg](https://developer.qcloudimg.com/http-save/yehe-11546919/181742ff99925d812a0cf623446954cd.jpg)



## 01 / 环境清单

| 项目 | 配置 |
|------|------|
| 操作系统 | openEuler 22.03 LTS-SP4 |
| CPU | x86_64（Intel / AMD / 海光 / 兆芯均可） |
| 内存 | 30 GiB |
| 数据盘 | `/data` 98G（ext4） |
| 日志盘 | `/redo` 98G（ext4） |
| 数据库版本 | KingbaseES V009R002C016（Lin64） |
| 数据目录 | `/data/kingbase/data` |
| 程序目录 | `/data/kingbase/app`（安装时指定） |
| 监听端口 | **54321**（金仓默认） |

### - 上传安装包至服务器并重命名
```bash
[root@openeuler-server soft]# pwd
/redo/soft
[root@openeuler-server soft]# ls
KingbaseES_V009R002C016B0006_Lin64_install.iso  license_标准版-180天.dat
[root@openeuler-server soft]# mv license_标准版-180天.dat license.dat
```
![上传完成](https://developer.qcloudimg.com/http-save/yehe-11546919/f9ecb9570cba098370d819e9b5e2ad69.png)

### 确认系统环境

```bash
# 系统版本
[root@openeuler-server ~]# cat /etc/os-release
NAME="openEuler"
VERSION="22.03 (LTS-SP4)"
ID="openEuler"
VERSION_ID="22.03"
PRETTY_NAME="openEuler 22.03 (LTS-SP4)"
ANSI_COLOR="0;31"
```


```bash
# 内存
[root@openeuler-server ~]# free -hm
               total        used        free      shared  buff/cache   available
Mem:            30Gi        10Gi       9.4Gi       765Mi        13Gi        20Gi
Swap:          7.5Gi       1.0Gi       6.4Gi
```


```bash
# 磁盘挂载
[root@openeuler-server ~]# df -Th
文件系统                                     类型      容量  已用  可用 已用% 挂载点
/dev/mapper/openeuler_openeuler--server-root ext4       41G   35G  4.5G   89% /
/dev/sdb1                                    ext4       98G   67G   27G   72% /data
```


```bash
# 防火墙状态（已运行）
[root@openeuler-server ~]# systemctl status firewalld
● firewalld.service - firewalld - dynamic firewall daemon
   Active: active (running) since Sat 2026-09-05 19:59:28 CST
```


---

## 02 / 系统准备

### 2.1 创建 kingbase 专用用户

```bash
# 创建用户（自动生成 home）
useradd -d /home/kingbase -m kingbase
# 设置密码
echo "kingbase:Kingbase@2026" | chpasswd
# 验证
id kingbase
```


### 2.2 🔥 防火墙：不关闭，精准放行 54321 端口

**生产环境绝不可关闭防火墙**，正确做法是白名单放行：

```bash
# 永久放行 54321
firewall-cmd --zone=public --add-port=54321/tcp --permanent
# 重新加载
firewall-cmd --reload
# 验证
firewall-cmd --list-ports
```


若 SSH 端口未放行，补充：
```bash
firewall-cmd --zone=public --add-port=22/tcp --permanent
firewall-cmd --reload
```


> ⚠️ 易踩坑：`--permanent` 必须配合 `--reload` 才能立即生效。

### 2.3 内核参数调优（30G 内存参考值）

```bash
cat >> /etc/sysctl.conf <<EOF
# ===== 金仓 KES V9R2C16 专用参数 =====
kernel.shmall = 3774873
kernel.shmmax = 12884901888
kernel.sem = 250 162500 250 650
fs.aio-max-nr = 1048576
fs.file-max = 6815744
net.ipv4.ip_local_port_range = 1024 65000
net.core.rmem_default = 262144
net.core.rmem_max = 4194304
net.core.wmem_default = 262144
net.core.wmem_max = 1048576
EOF
sysctl -p
```


### 2.4 用户资源限制

```bash
cat >> /etc/security/limits.conf <<EOF
kingbase soft nofile 1048576
kingbase hard nofile 1048576
kingbase soft nproc  65536
kingbase hard nproc  65536
kingbase soft stack  32768
kingbase hard stack  32768
EOF
su - kingbase -c "ulimit -n"   # 应输出 1048576
```


---

## 03 / 目录规划（数据/备份/WAL 三分离）

生产环境建议数据、WAL、归档分开存放，避免 I/O 争抢。

```bash
mkdir -p /data/kingbase/data
mkdir -p /data/kingbase/backup
mkdir -p /data/kingbase/archive
mkdir -p /redo/kingbase/sys_wal
chown -R kingbase:kingbase /data/kingbase /redo/kingbase
chmod 700 /data/kingbase/data
```


验证：
```bash
ls -ld /data/kingbase/data /redo/kingbase/sys_wal
drwx------ 2 kingbase kingbase 4096  /data/kingbase/data
drwxr-xr-x 2 kingbase kingbase 4096  /redo/kingbase/sys_wal
```


**目录规划表**：

| 目录 | 用途 | 磁盘 | 权限 |
|------|------|------|------|
| `/data/kingbase/data` | 数据目录 | 数据盘 | 700 |
| `/data/kingbase/backup` | 逻辑备份 | 数据盘/独立备份盘 | 755 |
| `/data/kingbase/archive` | WAL 归档 | 独立归档盘 | 700 |
| `/redo/kingbase/sys_wal` | WAL 热日志 | 独立日志盘（SSD优先） | 700 |

---

## 04 / 挂载 ISO 并安装

### 4.1 挂载安装镜像

```bash
mkdir -p /mnt/kingbase
mount -o loop /redo/soft/KingbaseES_V009R002C016B0006_Lin64_install.iso /mnt/kingbase
ls /mnt/kingbase   # 应显示 setup setup.sh
```


### 4.2 启动命令行安装

```bash
su - kingbase
cd /mnt/kingbase
sh setup.sh -i console
```


**安装向导关键步骤**（console 交互）：

| 步骤 | 选择 |
|------|------|
| 选择语言 | 简体中文 / English |
| 许可协议 | 接受 |
| 安装集 | **完全安装** |
| 授权文件 | 指定 `/redo/soft/license.dat` |
| 安装路径 | `/data/kingbase/app`（注意：文档实际选此路径） |
| 预安装摘要 | 确认 |
| 初始化数据库 | **选 No**（手动初始化） |

安装完成提示：
```
安装目录：/data/kingbase/app
...
数据库服务器:/data/kingbase/app/KESRealPro/V009R002C016/Server
...
```


### 4.3 配置环境变量

```bash
cat >> ~/.bashrc <<'EOF'
# ===== KingbaseES 环境变量 =====
export KINGBASE_HOME=/data/kingbase/app/Server
export PATH=$KINGBASE_HOME/bin:$PATH
export LD_LIBRARY_PATH=$KINGBASE_HOME/lib:$LD_LIBRARY_PATH
EOF
source ~/.bashrc
```


验证：
```bash
which ksql     # /data/kingbase/app/Server/bin/ksql
which initdb   # /data/kingbase/app/Server/bin/initdb
```


确认数据目录权限：
```bash
ls -ld /data/kingbase/data   # 应为 drwx------ kingbase kingbase
```


---

## 05 / 初始化数据库（Oracle 兼容模式）

### 5.1 执行 initdb

⚠️ **踩坑提醒**：`-W` 参数后面直接跟密码时，不能带空格，否则会被解析为多余参数。推荐使用交互式输入密码。

```bash
initdb -U system -W -m oracle -E UTF8 --locale=zh_CN.UTF-8 -D /data/kingbase/data
```
系统会提示输入密码两次，输入 `Kingbase@2026` 即可。

若之前因参数错误报错，可清空数据目录后重试：
```bash
rm -rf /data/kingbase/data/*   # 仅限全新环境
```


成功输出末尾应包含：
```
syncing data to disk ... ok
initdb: database creation succeeded
```

### 5.2 Oracle 兼容模式的额外配置

```bash
vi /data/kingbase/data/kingbase.conf
# 追加以下参数（关闭空字符串转NULL，与Oracle一致）
ora_input_emptystr_isnull = off
```
![修改后](https://developer.qcloudimg.com/http-save/yehe-11546919/7f9b703fd36e50938ff0652218b5deb1.png)

### 5.3 启动数据库

```bash
sys_ctl -D /data/kingbase/data -l /data/kingbase/data/startup.log start
```
预期输出：
```
等待服务器进程启动 .... 完成
服务器进程已经启动
```


查看状态：
```bash
sys_ctl -D /data/kingbase/data status
```

![状态查看](https://developer.qcloudimg.com/http-save/yehe-11546919/996af74d540370ecba3bdcd4e658aa39.png)
---

## 06 / 验证部署结果

### 6.1 本地连接验证

```bash
ksql -U system -W -d test -p 54322   # 实际端口为 54321，文档中误写为 54322，请以实际为准
```
输入密码后进入命令行：
```
test=# SELECT version();
         version         
-------------------------
 KingbaseES V009R002C016
(1 行记录)

test=# show database_mode;
 database_mode 
---------------
 oracle
(1 行记录)
```


查看数据库列表：
```bash
test=# \l
                                  数据库列表
   名称    | 拥有者 | 字元编码 |  校对规则   |    Ctype    |     存取权限      
-----------+--------+----------+-------------+-------------+-------------------
 kingbase  | system | UTF8     | zh_CN.UTF-8 | zh_CN.UTF-8 | 
 security  | system | UTF8     | zh_CN.UTF-8 | zh_CN.UTF-8 | 
 template0 | system | UTF8     | zh_CN.UTF-8 | zh_CN.UTF-8 | =c/system        +
           |        |          |             |             | system=CTc/system
 template1 | system | UTF8     | zh_CN.UTF-8 | zh_CN.UTF-8 | =c/system        +
           |        |          |             |             | system=CTc/system
 test      | system | UTF8     | zh_CN.UTF-8 | zh_CN.UTF-8 | 
(5 行记录)
```


查看端口监听：
```bash
ss -tlnp | grep 54322   # 若实际端口为54321请对应修改
LISTEN 0  224  0.0.0.0:54322  0.0.0.0:*  users:(("kingbase",pid=3209160,fd=9))
```


### 6.2 远程连接验证

```bash
# 从另一台机器测试端口连通性
telnet <服务器IP> 54321
# 或使用 nc
nc -zv <服务器IP> 54321
```
若失败，按以下顺序排查：
1. 数据库是否启动
2. 防火墙是否放行
3. `kingbase.conf` 中 `listen_addresses` 是否设为 `'*'`（默认 localhost）
4. `sys_hba.conf` 是否允许客户端网段

**修改远程监听**：
```bash
vi /data/kingbase/data/kingbase.conf
listen_addresses = '*'

vi /data/kingbase/data/sys_hba.conf
# 追加允许网段（示例）
host    all             all             192.168.1.0/24          scram-sha-256

# 重启生效
sys_ctl -D /data/kingbase/data restart
```

---

## 07 / 开机自启配置

以 root 用户执行安装目录下的 `root.sh` 脚本（路径通常在 `/data/kingbase/app/install/root.sh`），可注册系统服务。具体步骤省略，请参考官方文档。

---

## 08 / 🔥 五个高频坑位排查

### 🩸 坑 1：`initdb` 报错 "data directory has wrong ownership"
**原因**：数据目录属主不是 kingbase。  
**解决**：
```bash
chown -R kingbase:kingbase /data/kingbase
chmod 700 /data/kingbase/data
```

### 🩸 坑 2：启动报错 "could not create shared memory segment"
**原因**：`kernel.shmmax` 过小。  
**解决**：按物理内存调整（30G 建议 12GB），并执行 `sysctl -p`。

### 🩸 坑 3：远程连接报 "Connection refused"
**原因**：①数据库未启动 ②监听仅限 localhost ③防火墙未放行。  
**解决**：依次检查 `sys_ctl status`、`listen_addresses`、`firewall-cmd --list-ports`。

### 🩸 坑 4：远程连接报 "no pg_hba.conf entry for host"
**原因**：客户端 IP 不在白名单。  
**解决**：在 `sys_hba.conf` 中增加对应网段条目，并重启。

### 🩸 坑 5：Oracle 模式下空字符串变成了 NULL
**原因**：默认行为与 Oracle 不同。  
**解决**：在 `kingbase.conf` 中设置 `ora_input_emptystr_isnull = off`，并执行 `SELECT sys_reload_conf();` 重载。


## 09 / 一句话总结

**部署国产库不是“能跑起来就行”——防火墙精准放行而不是一关了之、目录三分离而不是一锅烩、参数初始化前想清楚而不是事后返工，这才是生产级部署与测试环境的本质区别。**




**关于作者**  
马顺华（shunwah），江湖人称“数据库界华少”，持有 OceanBase OBCA/OBCP、MySQL OCP、OpenGauss、崖山 DBCA、金仓 KCA/KCP、KaiwuDB、TiDB 等十几家数据库官方认证。  
🏅 墨天轮 MVP · 🚀 崖山 YVP · 📘 KaiwuDB MVP · 🧩 金仓 KVA · ☁️ TiDB MVA · 🌈 OpenTenBase ACE  

📌 本文所有命令均在 openEuler 22.03 LTS-SP4 + KingbaseES V009R002C016 环境下实测，可直接复现。

作者：马顺华（shunwah）   认证：OceanBase OBCP、MySQL OCP、金仓 KCP/KCA、TiDB MVA 等十余项   标签：#国产数据库 #KingbaseES #openEuler #部署实战

国产化替换别只看兼容！金仓KES V9R2C16这4个内核变化更关键

给做国产化落地的兄弟！openEuler 22.03 + 金仓 KES V9R2C16 从零部署手册，防火墙不关、端口精准放行、含避坑清单，20 分钟跑通

运维工程师

数据库

操作系统

运维

本文详细演示了在openEuler 22.03 LTS-SP4系统上部署KingbaseES V9数据库的完整流程，涵盖环境准备、防火墙精准放行、内核参数调优、目录三分离规划、Oracle兼容模式初始化及远程连接配置。文章提供生产级部署实战经验，包括五个高频故障排查方案，帮助用户快速实现国产数据库的稳健落地。

文件系统

代码解释

服务器

防火墙

2026上云采购 | AI焕新·智启新局

tencentdb-catalog

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

国产化替换别只看兼容！金仓KES V9R2C16这4个内核变化更关键-腾讯云开发者社区-腾讯云

国产化替换别只看兼容！金仓KES V9R2C16这4个内核变化更关键

国产化替换别只看兼容！金仓KES V9R2C16这4个内核变化更关键

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐