碎碎念

此文章为macOS使用docker配置openGauss的简单指引。之所以选择3.0.0版本,是因为我测试了若干版本后,发现很多更高的版本都会出现docker运行容器闪退的问题,于是根据

https://blog.csdn.net/Katharsis_Tk/article/details/138305306

和@ysy同学提供的经验,更换3.0.0版本后正常,特别感谢!
但是,上述教程仍然存在一些问题,所以建议参考本文。

本教程基于macOS,但windows亦可作为参考。windows适配的版本号未经测试。
推荐使用适宜的网络环境,如果没有,可以更换国内镜像源。

STEP1 下载安装docker

有关docker desktop的安装可以参考上述文章的前半部分,这里不再赘述。
或者可以参考以下文章:

STEP2 拉取openGauss镜像

docker配置完成后,在后台打开docker desktop,然后打开终端输入以下命令,拉取3.0.0版本的镜像:

docker pull enmotech/opengauss:3.0.0

等待拉取完成即可。

image

STEP3 创建openGauss容器

docker run --name opengauss --privileged=true -d -e GS_PASSWORD=openGauss@123 -p 5432:5432 enmotech/opengauss:3.0.0

运行该命令会返回一串id。

image

openGauss的密码要求包含大小写字母、数字和特殊符号。
作为测试,不推荐在此步修改GS_PASSWORD。

然后打开docker,验证一下是否处于运行状态

image

此步中,如果出现容器运行闪退的情况,请检查:
1.端口是否被占用;
2.openGauss版本号是否为3.0.0。
上述命令中,-p 5432:5432​的位置不可改变。冒号前代表宿主机(即本机电脑)的端口号,冒号后代表docker中对应的端口号。如果你需要自定义,仅推荐修改前者。

如果容器处于Running状态,并且Port(s)列也正确显示了端口映射情况,则此步正确完成。

STEP4 完成openGauss的基础配置

此步参考https://blog.csdn.net/Katharsis_Tk/article/details/138305306

安装后的openGauss默认有一个用户gaussdb,账户密码就是刚刚设置的密码,这里是openGauss@123

打开终端执行以下步骤:

先切换到omm用户,然后使用gsql工具创建普通用户方便管理:

su - omm
gsql -d postgres -U gaussdb -W openGauss@123
CREATE USER myuser WITH PASSWORD "userpw1.";

其中,"myuser"和"userpw1."可以分别替换为你设定的账号和密码。

STEP5 配置DBeaver

可以前往https://dbeaver.io/download/下载对应版本的DBeaver

image

macOS可以直接使用brew下载(推荐)

brew install --cask dbeaver-community

使用brew下载需要静待其完成安装,然后在启动台处即可找到。

如果提示没有brew可以自行搜索安装homebrew,一个强大的包管理器。

image

然后,下载并解压对应架构的openGauss JDBC驱动。

如果你是windows系统或Intel芯片的mac系统,通常选择x86_64;如果你是M芯片的mac系统,选择AArch64。

image

image

在DBeaver中,点击菜单栏的“Driver Manager”,然后点击NEW创建新的驱动。

2025-10-19T10:26:49.png

在创建新驱动页,依次点击Libraries,Add File,添加我们刚刚解压的驱动文件(通常为带版本号的这个jar文件)

然后点击Find Class

image

完成后,切换到Settings,按照如下设置完成后,点击OK即可。(ID不用改)

2025.10.21补充:URL如下
jdbc:opengauss://{host}:{port}/{database}
方便各位粘贴

image

然后,在主界面,右键如图所示的postgres,选择Edit connection,然后填写用户和密码。可以是默认的账户,也可以是刚刚你新设置的账户。如果填写默认账户,且你没有修改我给出的默认密码,则默认密码是openGauss@123

在此步中,请保证docker开启,并且openGauss容器处于运行状态。

2025-10-19T10:24:49.png

现在,双击postgres,即可连接上openGauss了!

2025-10-19T10:25:37.png

最后修改:2025 年 10 月 21 日
如果觉得我的文章对你有用,请随意赞赏