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 的配置文件一般在：

　　2.如果沒有這個文件，可以新建一個。示例：

　　3.保存後，重啓 Docker：

　　4.查看是否生效：

附錄：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