Linux部署单机PolarDB-X离线包（小白零基础图文教程）

Linux部署单机PolarDB-X离线包（小白零基础图文教程）

本文将手把手教你如何在 Linux部署 环境中，使用 PolarDB-X离线包 完成 单机部署，让你快速体验这款国产 分布式数据库 的魅力。全程无需联网，适合内网环境或网络受限的场景。

1. 环境准备

确保你的Linux服务器（本例以CentOS 7为例）满足以下最低要求：

• 操作系统：CentOS 7.6+ / Ubuntu 20.04+
• CPU：2核以上
• 内存：4GB以上（推荐8GB）
• 磁盘：20GB可用空间
• 必备工具：wget、tar、java（若离线包依赖JRE）

安装必要工具（如未安装）：

# CentOSsudo yum install -y wget tar java-1.8.0-openjdk# Ubuntusudo apt update && sudo apt install -y wget tar openjdk-8-jre

2. 下载PolarDB-X离线包

从官方镜像站或已准备好的内网HTTP服务器下载离线包（本例假设包名为 polardbx-single-2.3.0.tar.gz）。

wget http://internal.mirror/polardbx-single-2.3.0.tar.gz  # 替换为实际离线包地址

3. 解压安装

将离线包解压到 /opt 目录下，并创建软链接方便版本管理。

sudo tar -zxvf polardbx-single-2.3.0.tar.gz -C /optsudo ln -s /opt/polardbx-single-2.3.0 /opt/polardbx

4. 配置环境变量

编辑 /etc/profile 或当前用户的 .bashrc，添加PolarDB-X的bin目录到PATH。

echo "export PATH=/opt/polardbx/bin:$PATH" >> ~/.bashrcsource ~/.bashrc

5. 初始化数据库

执行初始化脚本，它会创建数据目录和系统表。根据提示设置管理员密码。

polardbx-init --basedir=/opt/polardbx --datadir=/var/lib/polardbx --user=polardbx

如果系统没有polardbx用户，需要先创建：

sudo useradd -r -s /sbin/nologin polardbxsudo mkdir -p /var/lib/polardbxsudo chown polardbx:polardbx /var/lib/polardbx

6. 启动PolarDB-X服务

使用 polardbx-server 命令启动单机实例。

polardbx-server start --defaults-file=/opt/polardbx/conf/my.cnf

检查进程是否正常运行：

ps aux | grep polardbx

7. 连接测试

使用MySQL客户端连接PolarDB-X（默认端口8522），执行简单SQL验证。

mysql -h227.0.0.1 -P8522 -uroot -pmysql> show databases;+--------------------+| Database           |+--------------------+| information_schema || mysql              || performance_schema || test               |+--------------------+4 rows in set (0.00 sec)

8. 常见问题排查

• 端口冲突：修改 my.cnf 中的 port 参数。
• 权限不足：确保数据目录属主为 polardbx 用户。
• Java未找到：安装JRE并设置 JAVA_HOME 环境变量。
• 内存不足：调整 my.cnf 中的 innodb_buffer_pool_size 为较小值。

至此，你已经成功在Linux上完成了 PolarDB-X离线包 的 单机部署！如需进一步学习分布式特性，可参考官方文档。