Windows 系统安装 OpenGauss 指南

Windows 系统安装 OpenGauss 指南

由于 OpenGauss 是主要针对 Linux 系统设计的数据库，官方并不直接提供 Windows 版本，但您可以通过以下方法在 Windows 上运行 OpenGauss：

方法一：使用 Docker

这是最简单的方法，适合开发和测试环境。

1. 安装 Docker Desktop

1. 下载并安装 Docker Desktop for Windows

2. 启动 Docker 服务

2. 拉取 OpenGauss 镜像

docker pull enmotech/opengauss-lite

3. 运行容器

docker run --name opengauss --privileged=true -d -e GS_PASSWORD=YourPassword@123 -p 5432:5432 enmotech/opengauss-lite:latest

4. 连接数据库

使用 pgAdmin 或 DBeaver 等工具连接：

• 主机：localhost

• 端口：5432

• 用户名：gaussdb

• 密码：YourPassword@123

• 数据库：postgres

方法二：使用 WSL 2（Windows Subsystem for Linux）

1. 启用 WSL 2

1. 以管理员身份打开 PowerShell 并运行：

wsl --install

2. 重启计算机

2. 安装 Ubuntu 发行版

1. 从 Microsoft Store 安装 Ubuntu 20.04 LTS

2. 启动 Ubuntu 并完成初始设置

3. 在 WSL 中安装 OpenGauss

按照 Linux 安装步骤在 WSL 中安装 OpenGauss（见附录）

方法三：虚拟机安装

1. 安装 VirtualBox 或 VMware Workstation Player

2. 创建 Ubuntu 虚拟机

3. 在虚拟机中按照标准 Linux 方法安装 OpenGauss

注意事项

1. 生产环境不建议在 Windows 上运行 OpenGauss

2. Docker 方式最适合开发和测试

3. 性能方面：WSL 2 > 虚拟机 > Docker（Windows版）

4. 某些高级功能可能在 Windows 环境下受限

客户端工具推荐

1. pgAdmin：https://www.pgadmin.org/

2. DBeaver：https://dbeaver.io/

3. DataGrip：https://www.jetbrains.com/datagrip/

如需更稳定的生产环境，建议使用 Linux 服务器或华为云上的 GaussDB 服务。

 

问题：镜像拉取失败，配置镜像

Windows (Docker Desktop):

1. 右键点击任务栏 Docker 图标

2. 选择 "Settings" > "Docker Engine"

3. 添加镜像源配置：

   {
     "builder": {
       "gc": {
         "defaultKeepStorage": "20GB",
         "enabled": true
       }
     },
     "experimental": false,
     "registry-mirrors": [
       "https://docker.1ms.run"
     ]

   }

4. 点击 "Apply & Restart"

其它方式配置

　　1.Docker 的配置文件一般在：

　　/etc/docker/daemon.json

　　2.如果没有这个文件，可以新建一个。示例：

　　{ "registry-mirrors": [ "https://docker.m.daocloud.io", "https://mirror.ccs.tencentyun.com", "https://registry.docker-cn.com" ] }

　　3.保存后，重启 Docker：

　　systemctl daemon-reexec

　　systemctl restart docker

　　4.查看是否生效：

　　docker info | grep "Registry Mirrors" -A 3

 

附录：win11 的WSL方式（Unbuntu系统）安装操作步骤记录

一、宿主机操作(win11的Unbuntu子系统)

 1.安装docker

sudo apt update && sudo apt upgrade -y
sudo apt install -y docker.io curl wget vim net-tools sudo
sudo systemctl enable docker
sudo systemctl start docker
sudo usermod -aG docker $USER

2.拉取opengauss镜像，换版本：enmotech/opengauss-lite

docker pull enmotech/opengauss-lite

3.启动容器

docker run --name opengauss --privileged=true -d -e GS_PASSWORD=OpenGauss@123 -e ALLOW_IP_RANGE=0.0.0.0/0 -p 5432:5432 -v opengauss_data:/var/lib/opengauss enmotech/opengauss-lite

 

二、容器内操作(连接数据库测试)

1.进入容器

docker exec -it opengauss /bin/bash

2.安装pgsql客户端进行连接测试

apt-get update
apt-get install -y postgresql-client
psql --version
psql -h 127.0.0.1 -p 5432 -U omm -d postgres -c "SELECT version();"

3. 改用gsql进行测试,将工具加入PATH

echo 'export PATH=/usr/local/opengauss/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

4.连接数据库测试

gsql -d postgres -U omm -c "SELECT version();"

5.安装相关依赖，并使库生效

apt-get install -y libssl1.1
apt-get install -y libcjson1 libcjson-dev
apt-get install -y libcurl4
apt-get install -y libcurl4-openssl-dev
apt-get install libpq-dev postgresql-client

echo 'export LD_LIBRARY_PATH=/usr/local/opengauss/lib:$LD_LIBRARY_PATH' >> ~/.bashrc
source ~/.bashrc

6.登录数据库并创建新用户(初始用户omm无法远程连接)

gsql -d postgres -U omm

CREATE USER root WITH PASSWORD 'Root@123';
ALTER USER root SYSADMIN;

7.连接数据库

 gsql -h 127.0.0.1 -d postgres -U root

 

官方安装文档

https://docs.opengauss.org/zh/docs/latest-lite/docs/InstallationGuide/%E5%AE%B9%E5%99%A8%E9%95%9C%E5%83%8F%E5%AE%89%E8%A3%85.html