一、系统准备

1. 检查系统信息

cat /etc/os-releaseuname -m

推荐系统：

• openEuler 22.03 / 22.09

• CentOS 7.9 / 8.x

• RHEL 同类版本

架构：x86_64

2. 安装依赖包

dnf install -y libaio-devel flex bison ncurses-devel glibc-devel \
readline-devel zlib-devel tar openssl-devel net-tools sysstat \
libnsl* psmisc

openGauss 需要 OpenSSL 1.1 环境支持
如果系统缺少，可手动安装（但大部分安装包内自带，无需额外操作）

二、创建运行用户和目录

1. 创建运行用户

useradd omm

2. 创建安装目录

mkdir -p /opt/openGauss
mkdir  -p  /opt/openGauss/data

三、上传与解压安装包

将安装包上传到 /opt 目录，例如：

openGauss-Server-6.0.2-openEuler20.03-x86_64.tar.bz2

然后执行：

cd /opt
tar -jxvf openGauss-Server-6.0.2-openEuler20.03-x86_64.tar.bz2 -C /opt/openGauss
chown -R omm:omm /opt/openGauss

四、配置环境变量

切换到 omm 用户：

su - omm

编辑环境变量：

vi ~/.bashrc

添加以下内容（假设安装路径为 /opt/openGauss）：

export GAUSSHOME=/opt/openGauss
export GAUSSLOG=/opt/openGauss/log
export PATH=$GAUSSHOME/bin:$PATH
export LD_LIBRARY_PATH=$GAUSSHOME/lib:$LD_LIBRARY_PATH
export LANG=en_US.UTF8
export PGDATA=/opt/openGauss/data

保存后生效：

source ~/.bashrc

验证命令：

gs_initdb --help

能正常输出说明环境变量生效。

五、初始化数据库

初始化数据库：

su - omm
gs_initdb -D /opt/openGauss/data --nodename=single_node --locale=en_US.UTF8

成功后会提示：

Success. You can now start the database server...

六、修改数据库配置（允许远程连接）

1. 修改  vim /opt/openGauss/data/postgresql.conf

确保以下行存在或修改为：

listen_addresses = '*'        # 允许所有IP连接
port = 54321                  # 默认端口
password_encryption_type = 0  # 使用MD5加密方式

2. 修改  vim /opt/openGauss/data/pg_hba.conf

添加或修改以下行：

local   all             all                                     trust
host    all             all             127.0.0.1/32            trust
host    all             all             0.0.0.0/0               md5
host    all             all             ::1/128                 trust

保存后退出。

七、启动数据库

gs_ctl start -D /opt/openGauss/data -Z single_node

检查状态：

gs_ctl status -D /opt/openGauss/data

应显示：

server is running

八、首次登录数据库

gsql -d postgres -p 54321

首次本地登录使用 trust 模式，无需密码。

九、创建管理员密码与普通用户（opengauss）

进入数据库后执行：（此处的'密码'换成自己需要的密码）

ALTER USER omm IDENTIFIED BY '密码';
CREATE USER opengauss WITH PASSWORD '密码';
ALTER USER opengauss WITH SYSADMIN;
\du

创建数据库webfuture，数据库所有者opengauss，兼容PG(postgresql)：

CREATE DATABASE "webfuture" WITH OWNER "opengauss" DBCOMPATIBILITY 'PG';

十、配置防火墙

如系统启用 firewalld：

sudo firewall-cmd --zone=public --add-port=54321/tcp --permanent
sudo firewall-cmd --reload

确认端口监听：

ss -ltnp | grep 54321

输出示例：

LISTEN 0 128 0.0.0.0:54321 ...

十一、远程连接测试

在命令行指定IP执行连接：

su - omm
gsql -h 192.168.188.30 -p 54321 -U opengauss -d postgres

输入密码后成功登录则成功。

十二、验证配置

查看当前配置：

cat /opt/openGauss/data/postgresql.conf | grep -E "listen|port|password"cat /opt/openGauss/data/pg_hba.conf | grep -v "^#" | grep -v "^$"

查看日志：

tail -n 50 /opt/openGauss/data/pg_log/postgresql*.log

十三、关闭与重启数据库

su - omm  #以下命令需要在omm环境变量下执行
gs_ctl stop -D /opt/openGauss/data
gs_ctl restart -D /opt/openGauss/data -Z single_node