OceanBase on 吾爱主机

OceanBase 从零开始：核心概念、上手路径，以及和 MySQL 的关键差异

Fri, 17 Jul 2026 01:00:00 +0800

如果你已经会 MySQL，第一次接触 OceanBase 时，最容易卡住的不是“SQL 怎么写”，而是：

它看起来很像 MySQL，为什么连接方式、资源模型、高可用和运维概念完全不是一回事？

本文面向零基础到 MySQL 初中级同学，用一条从概念到上手的路径讲清楚：

OceanBase 是什么
和 MySQL 在架构、租户、连接、兼容性上的核心差异
从连接、建库建表到基础 SQL 的最小实践
什么场景该把 OceanBase 当“更强的 MySQL”，什么场景不能这么想

说明：本文以 OceanBase 社区版（MySQL 模式） 为主。官方文档明确：社区版仅提供 MySQL 模式；企业版还支持 Oracle 模式。

一、先建立正确心智模型

1. MySQL 的常见心智模型

很多人对 MySQL 的默认理解是：

一台机器 / 一个 mysqld 实例
 └── 多个 database
 └── 多个 table

连接通常很直接：

mysql -h127.0.0.1 -P3306 -uroot -p

你连上的，基本就是“这个实例本身”。

2. OceanBase 的心智模型

OceanBase 更接近：

一个集群（Cluster）
 └── 多个节点（OBServer）
 └── 多个可用区（Zone）
 └── 多个租户（Tenant） ← 应用视角下更像“数据库实例”
 └── 多个 database
 └── 多个 table / 分区

关键变化只有一句话：

在 OceanBase 里，应用通常不是“连一台 MySQL 机器”，而是“连某个租户”。

官方文档把租户定义为：集群内互相隔离的数据库“实例”。对应用来说，一个租户近似一个独立数据库实例；租户之间数据、权限、资源隔离。

二、OceanBase 是什么

OceanBase 是蚂蚁集团开源的分布式关系型数据库，基于 Paxos 类共识协议与分布式架构，提供高可用和水平扩展能力，可运行在普通服务器集群上。

官方强调的关键能力包括：

水平扩展
高可用（RPO=0、RTO 秒级恢复目标）
MySQL 兼容，便于迁移
HTAP（同一套系统同时服务事务与分析负载）
多租户资源隔离

你可以把“上手阶段”理解成两层：

层	你感受到的
SQL 层	很像 MySQL：`CREATE DATABASE` / `CREATE TABLE` / `SELECT`
系统层	更像分布式数据库：集群、Zone、租户、Unit、副本、OBProxy

三、和 MySQL 的核心差异总览

维度	MySQL（常见单机/主从）	OceanBase
基本部署单元	实例（mysqld）	集群 + 租户
应用连接对象	实例	租户（经直连或 OBProxy）
默认端口（常见）	`3306`	直连 `2881`，经 ODP/OBProxy 常见 `2883`
用户写法	`root`	`root@tenant` 或 `user@tenant#cluster`
扩展方式	垂直扩容 / 读写分离 / 分库分表	原生分区、多节点、副本扩展
高可用机制	主从复制、MGR 等	基于 Multi-Paxos 的多副本日志流
多业务隔离	多实例 / 多库 + 权限	原生多租户 + 资源池
存储引擎模型	InnoDB 等可插拔引擎	自研分布式存储与事务体系
SQL 兼容	原生 MySQL	MySQL 模式兼容 5.7/8.0 大部分能力，但非 100%
社区版模式	MySQL	仅 MySQL 模式

一句话：

MySQL 更像“一台关系库”；OceanBase 更像“一个可多租户的分布式数据库平台”。

四、架构差异：为什么它不像单机 MySQL

1. Shared-Nothing 集群

官方系统架构文档指出，OceanBase 常用无共享（Shared-Nothing）模式：

节点对等
每个节点都有自己的 SQL / 存储 / 事务能力
表可水平拆分为多个分区（Partition）
分区数据落在 Tablet，修改通过日志流（Log Stream）持久化
主从副本通过 Multi-Paxos 保持一致性

这意味着：

数据天然可分布到多节点
故障切换依赖副本选举，而不是简单“切到另一台 mysqld”
建表时的分区设计，会直接影响数据分布与扩展性

2. 多租户：最容易被 MySQL 同学忽略的概念

在 OceanBase 中：

集群初始化后会有系统租户 sys
sys 保存集群元数据，本身也是 MySQL 兼容模式租户
业务一般应在普通租户里建库建表，而不是把所有业务都堆在 sys

创建业务租户的典型顺序是：

Unit Config（资源规格）
 → Resource Pool（资源池）
 → Tenant（租户）

这和 MySQL 里“直接 CREATE DATABASE”完全不同。
MySQL 的 database 更像命名空间；OceanBase 的 tenant 更像独立实例边界。

3. OBProxy / ODP：应用如何“像访问单机库一样”访问分布式库

为了让应用尽量少感知分区和副本分布，OceanBase 提供 ODP（OceanBase Database Proxy，又称 OBProxy）：

应用通常连代理
代理把 SQL 路由到合适节点
对应用更接近“连一个入口地址”

这对应 MySQL 生态里的 proxy / 中间件角色，但在 OceanBase 里它更常作为标准访问路径出现。

五、连接差异：最容易踩坑的地方

1. Docker 体验环境（最简单）

快速体验可用官方镜像：

docker run -p 2881:2881 --name oceanbase-ce -e MODE=mini -d oceanbase/oceanbase-ce
docker logs oceanbase-ce | tail -1 # 期望 boot success!

连接示例：

# 系统租户 root
docker exec -it oceanbase-ce obclient -h127.0.0.1 -P2881 -uroot

# 或宿主机 mysql 客户端
mysql -h127.0.0.1 -P2881 -uroot
mysql -h127.0.0.1 -P2881 -uroot@test

2. 正式连接写法：用户名里有租户

官方文档给出两类常见连接：

直连 OBServer（默认端口常为 2881）

mysql -h<observer_ip> -P2881 -u用户名@租户名 -p

注意：

直连时 -u 应是 用户名@租户名
不要在直连用户名里带集群名，否则可能报错
普通租户直连时，目标节点上需要有该租户资源

通过 ODP/OBProxy（默认端口常为 2883）

mysql -h<odp_ip> -P2883 -u用户名@租户名#集群名 -p

用户名还可能写成：

集群名:租户名:用户名
集群名-租户名-用户名
集群名.租户名.用户名

这和 MySQL 的 root@'%' 完全不是同一套语义。

3. 客户端选择

可用 obclient
也可用 MySQL 客户端连接 MySQL 模式租户
官方文档提到当前支持的 MySQL 客户端版本包括 5.5 / 5.6 / 5.7（以你使用版本的文档为准）

六、从零上手：MySQL 同学 10 分钟路径

下面假设你已经能连上一个 MySQL 模式租户。

1. 看有哪些库

SHOW DATABASES;

体验环境里常见会看到 oceanbase、test、information_schema、mysql 等。

2. 创建业务库

CREATE DATABASE demo DEFAULT CHARACTER SET utf8mb4 READ WRITE;
USE demo;

这和 MySQL 非常像。

3. 建表、写入、查询

CREATE TABLE users (
 id INT PRIMARY KEY,
 name VARCHAR(64) NOT NULL,
 created_at DATETIME DEFAULT CURRENT_TIMESTAMP
);

INSERT INTO users (id, name) VALUES
 (1, 'alice'),
 (2, 'bob');

SELECT id, name FROM users WHERE id = 1;
UPDATE users SET name = 'alice2' WHERE id = 1;
DELETE FROM users WHERE id = 2;

官方 MySQL 模式基础文档也覆盖了：

CREATE DATABASE / SHOW DATABASES
CREATE TABLE / SHOW TABLES / SHOW CREATE TABLE
ALTER TABLE
INSERT / UPDATE / DELETE / TRUNCATE
多表查询、聚合、EXPLAIN 等

4. 看建表细节时的“OceanBase 味道”

在 OceanBase 里执行：

SHOW CREATE TABLE users\G

你可能会看到比 MySQL 更“重”的表属性，例如副本数、压缩、Tablet 相关参数等。
这说明：SQL 表面兼容，元数据与存储参数并不等同于 InnoDB。

七、兼容性：像 MySQL，但不是 100% MySQL

官方《与 MySQL 兼容性对比》说明：

OceanBase 的 MySQL 模式兼容 MySQL 5.7/8.0 的绝大部分功能和语法；因架构差异或需求优先级，部分功能未支持。

1. 相似度高的部分

通常对应用最友好的部分：

常见数值 / 时间 / 字符 / JSON 等数据类型
SELECT / INSERT / UPDATE / DELETE
多表连接、子查询、聚合分组
存储过程、函数、触发器等大部分 PL 能力
information_schema、mysql 中的大量视图（但不是逐列完全等价）

因此：

很多基于 MySQL 协议的驱动可直接连
简单 CRUD 业务迁移门槛较低
你会有“这不就是 MySQL 吗”的错觉

2. 必须注意的差异

官方明确提到的差异方向包括：

类别	差异点
SQL 语法	例如不支持 `SELECT ... FOR SHARE ...`
TRUNCATE	不支持在事务处理与表锁定过程中操作
系统视图	不保证所有视图/列含义都与 MySQL 相同
存储引擎	不是 InnoDB 插件体系，而是自研分布式存储事务体系
优化器	执行计划与优化策略不同
分区 / 备份恢复	能力模型与操作路径不同
架构相关功能	因分布式架构，部分单机 MySQL 习惯不能照搬

3. 实战迁移建议

从 MySQL 迁到 OceanBase 时，不要只做“能不能连上”：

先验证协议层：驱动、连接池、ORM
再验证 SQL 层：慢 SQL、锁、事务边界、分页、HINT
再验证运维层：备份恢复、监控指标、扩缩容、租户资源
最后验证边界语法：冷门函数、系统表、复制相关特性、特定锁语法

一句话：

兼容的是“MySQL 使用体验”，不是“MySQL 内核实现”。

八、对象模型对比：database 相同，边界不同

MySQL

Instance
 └── Database
 └── Table / View / Procedure

权限、连接、资源，常常都围绕“实例 + 账号”展开。

OceanBase

Cluster
 └── Tenant（资源与权限边界更强）
 └── Database
 └── Table / Index / Procedure
 └── sys 租户（集群元数据）

对 MySQL 同学最实用的迁移记忆：

你在 MySQL 想做的事	在 OceanBase 更常见的对应
新建一个业务实例	新建一个业务租户
在实例里建库	在租户里 `CREATE DATABASE`
给业务分配 CPU/内存	调整 Unit Config / Resource Pool
连业务库	连 `user@tenant`
做高可用	规划 Zone / 副本 / 主备切换，而不是只配主从

九、一个最小对比实验（帮助真正理解差异）

实验 A：同一套 CRUD

在 OceanBase MySQL 模式租户执行：

CREATE DATABASE shop DEFAULT CHARACTER SET utf8mb4;
USE shop;

CREATE TABLE orders (
 order_id BIGINT PRIMARY KEY,
 user_id BIGINT NOT NULL,
 amount DECIMAL(10,2) NOT NULL,
 status VARCHAR(16) NOT NULL
);

INSERT INTO orders VALUES
 (1001, 1, 19.90, 'PAID'),
 (1002, 2, 39.00, 'CREATED');

SELECT * FROM orders WHERE status = 'PAID';

你会发现：
如果只看 SQL，这和 MySQL 几乎没区别。

实验 B：连接串差异

MySQL：

mysql -h127.0.0.1 -P3306 -uroot -p shop

OceanBase 直连某租户：

mysql -h127.0.0.1 -P2881 -uroot@test -p shop

OceanBase 经 ODP：

mysql -h127.0.0.1 -P2883 -uroot@test#cluster_name -p shop

你会发现：
真正拉开差距的，是“你连到了哪里”和“资源边界在哪里”。

实验 C：多租户隔离

在 sys 中创建两个业务租户后：

root@tenant1 里建表
root@tenant2 里看不到那张表

官方多租户示例正是用这种方式证明：
租户之间资源、数据、权限隔离。

这比 MySQL 里“两个 database 互相授权”要更接近“两个实例”。

十、什么时候适合用 OceanBase，什么时候继续 MySQL

更适合考虑 OceanBase 的场景

需要水平扩展，单机 MySQL + 分库分表成本高
需要更强的金融级高可用与多副本一致性
希望一套系统兼顾 TP 与部分 AP
多业务要强隔离，但又想统一运维平台（多租户）
已有大量 MySQL 协议应用，希望降低改造成本

更适合继续 MySQL 的场景

单机或轻量业务，数据量和可用性要求不高
团队只熟悉传统 mysqld 运维，短期不想引入分布式复杂度
深度依赖某些 MySQL 专有行为 / 插件 / 生态工具且未验证兼容
本地开发只需要极轻量依赖（虽然也可用 OceanBase Docker，但 MySQL 更轻）

十一、学习路线建议

如果你是 MySQL 背景，建议按这个顺序学：

先跑起来：Docker / obd demo
先会连：user@tenant、2881 / 2883
先当 MySQL 用：建库建表 CRUD
再学租户与资源：Unit / Resource Pool / sys 与普通租户
再学分布式：分区、副本、Zone、OBProxy 路由
最后做迁移评估：兼容性清单 + 压测 + 备份恢复演练

配套阅读：

本站另一篇：OceanBase 多平台搭建教程
官方 MySQL 兼容性文档
官方系统架构与多租户文档

十二、速查对照表

主题	MySQL	OceanBase
默认连接	`root@host:3306`	`root@tenant@host:2881` 或经 ODP `2883`
业务隔离	database / 多实例	tenant
管理入口	实例管理员	常先登 `sys` 做集群与租户管理
扩展	加配 / 分库分表	分区 + 多节点 + 资源单元
高可用	复制拓扑	Multi-Paxos 多副本
SQL 习惯	原生 MySQL	高度兼容，但要做差异验证
社区版模式	MySQL	仅 MySQL 模式

总结

OceanBase 对 MySQL 同学并不“难在 SQL”，而难在换模型：

把“实例”理解升级成“集群 + 租户”
把“连上 mysqld”升级成“连上正确的租户入口”
把“兼容 MySQL”理解成“协议与常用 SQL 友好，不等于内核相同”
先用 CRUD 建立信心，再用租户、分区、副本理解它的分布式能力

掌握这四步后，你就不会再把 OceanBase 误当成“换了皮的 MySQL”，也能更准确判断它该用在什么地方。

参考资料

OceanBase 官方仓库 README（中英文，MySQL 兼容与快速开始）：https://github.com/oceanbase/oceanbase
OceanBase 官方文档：系统架构（oceanbase-doc / V4.3.5）
OceanBase 官方文档：与 MySQL 兼容性对比
OceanBase 官方文档：SQL 基础操作（MySQL 模式）
OceanBase 官方文档：体验多租户特性
OceanBase 官方文档：通过 MySQL 客户端连接 OceanBase 租户
OceanBase Docker 镜像：https://hub.docker.com/r/oceanbase/oceanbase-ce
OceanBase 中文文档中心：https://www.oceanbase.com/docs/oceanbase-database-cn

OceanBase 多平台搭建教程：Linux / Windows / macOS / Docker 从零到可连接

Fri, 17 Jul 2026 00:00:00 +0800

OceanBase 是蚂蚁集团开源的分布式关系型数据库，兼容 MySQL 协议，适合本地体验、开发联调与集群试验。很多人第一次上手时最困惑的不是“它强在哪”，而是：

我在 Linux / Windows / macOS 上，到底该用哪一种方式装？

本文按官方社区推荐路径，整理一套可复用的多平台搭建方法：优先讲最快跑起来，再讲更接近生产部署的方式，并给出连接验证与常见排错。

说明：本文以 OceanBase 社区版（CE） 的官方开源安装路径为主，面向学习与开发环境。官方 Docker 镜像明确标注仅供测试，不建议直接用于生产。

一、先选对安装路径

平台	最推荐方式	备选方式	说明
Linux	`all-in-one` + `obd demo`	Docker / OBD 自定义集群	官方 all-in-one 仅支持 Linux
macOS	Docker Desktop + `oceanbase-ce`	远程 Linux 开发机	本机不建议硬编译 observer 当第一选择
Windows	Docker Desktop	WSL2 + Linux 方案	原生 Windows 不适合当主路径
任意平台（快速体验）	Docker `oceanbase/oceanbase-ce`	quay.io / ghcr.io 镜像源	单实例、端口 `2881`
Kubernetes	`ob-operator`	—	容器化生产/类生产集群请走 operator

资源底线（很重要）

不同路径对资源要求不同，至少记住两档：

Docker 官方镜像（测试）
- 主机建议至少 2 物理核 + 8GB 内存
obd demo 本地单节点
- 至少 2 CPU、6GB 可用内存、54GB 可用磁盘
- 端口 2881 / 2882 未被占用

机器太小会导致 bootstrap 卡住、容器反复重启，看起来像“命令写错了”，其实是资源不足。

二、通用概念：端口、租户、客户端

搭好后，通常这样连接：

项目	常见值
协议	MySQL 兼容
SQL 端口	`2881`
系统租户	`sys`
示例业务租户	`test`（Docker 镜像常见）
客户端	`obclient` 或标准 `mysql` 客户端

常用连接示例：

# 系统租户 root
mysql -h127.0.0.1 -P2881 -uroot

# 普通租户 root（Docker 文档示例）
mysql -h127.0.0.1 -P2881 -uroot@test

如果你本机没有 mysql 客户端，可用容器内置客户端：

docker exec -it oceanbase-ce obclient -h127.0.0.1 -P2881 -uroot

三、最快路径：Docker（Linux / Windows / macOS 通用）

这是跨平台体验 OceanBase 最省事的方式。
官方提供镜像：

Docker Hub：oceanbase/oceanbase-ce
备选：quay.io/oceanbase/oceanbase-ce
备选：ghcr.io/oceanbase/oceanbase-ce

官方说明：该镜像用于快速搭建测试环境，只支持单实例；若在 Kubernetes 中运行，请改用 ob-operator。

1. 前置条件

已安装并可运行 Docker（Linux Docker Engine / Docker Desktop）
主机资源满足：约 2 核 + 8GB 内存
本机 2881 端口空闲

2. 启动实例

# mini 模式：适合快速体验（官方 README 推荐写法）
docker run -p 2881:2881 --name oceanbase-ce -e MODE=mini -d oceanbase/oceanbase-ce

Docker Hub 文档还给出了其他模式：

# 使用容器更多资源
docker run -p 2881:2881 --name oceanbase-ce -e MODE=normal -d oceanbase/oceanbase-ce

# slim / fastboot 模式
docker run -p 2881:2881 --name oceanbase-ce -e MODE=slim -d oceanbase/oceanbase-ce

若 Docker Hub 拉取慢，可切换镜像源：

docker run -p 2881:2881 --name oceanbase-ce -e MODE=mini -d quay.io/oceanbase/oceanbase-ce
# 或
docker run -p 2881:2881 --name oceanbase-ce -e MODE=mini -d ghcr.io/oceanbase/oceanbase-ce

3. 等待 bootstrap 完成

首次启动可能需要几分钟。查看日志末尾：

docker logs oceanbase-ce | tail -1

期望看到：

boot success!

4. 连接验证

# 方式 A：容器内客户端
docker exec -it oceanbase-ce obclient -h127.0.0.1 -P2881 -uroot

# 方式 B：宿主机 mysql 客户端
mysql -h127.0.0.1 -P2881 -uroot
mysql -h127.0.0.1 -P2881 -uroot@test

进入后可执行：

SHOW DATABASES;
SELECT version();

5. 常用运维命令

docker ps -a | grep oceanbase-ce
docker logs -f oceanbase-ce
docker restart oceanbase-ce
docker stop oceanbase-ce
docker rm -f oceanbase-ce

6. 初始化 SQL（可选）

官方镜像支持挂载初始化脚本目录：

docker run -p 2881:2881 --name oceanbase-ce \
 -v /path/to/init-sql:/root/boot/init.d \
 -d oceanbase/oceanbase-ce

注意：官方文档提醒，初始化脚本中不要直接改 root 密码；若要改密码，应使用镜像提供的环境变量（如 OB_TENANT_PASSWORD，以当前镜像说明为准）。

四、Linux 原生：all-in-one + OBD（官方推荐体验路径）

如果你有一台 Linux 服务器或虚拟机，想更接近“真集群工具链”，优先用官方 all-in-one。

1. 一键安装 all-in-one

官方 README 明确：仅 Linux。

# 需要能访问外网
bash -c "$(curl -s https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/download-center/opensource/oceanbase-all-in-one/installer.sh)"
source ~/.oceanbase-all-in-one/bin/env.sh

2. 一键拉起演示实例

obd demo

obd demo 会在本机部署并启动一个 OceanBase 实例。部署完成后：

obclient -h127.0.0.1 -uroot -P2881

3. 单独安装 OBD（CentOS/RHEL 系）

如果你不走 all-in-one，也可以单独装 OceanBase Deployer：

sudo yum install -y yum-utils
sudo yum-config-manager --add-repo https://mirrors.aliyun.com/oceanbase/OceanBase.repo
sudo yum install -y ob-deploy
source /etc/profile.d/obd.sh

然后同样可用：

obd demo

4. `obd demo` 前自检清单

端口 2881、2882 空闲
可用内存 ≥ 6GB
CPU ≥ 2
可用磁盘 ≥ 54GB
系统时间正常、主机名可解析

资源不够时，OBD 往往会在预检阶段失败；先把机器规格补齐再重试，比反复改 YAML 更有效。

五、Windows 搭建

Windows 原生不适合作为 OceanBase observer 主部署平台。实操建议两条路：

方案 A：Docker Desktop（最简单）

安装 Docker Desktop for Windows
确保 WSL2 后端已启用（Docker Desktop 默认推荐）
在 PowerShell / Windows Terminal 执行：

docker run -p 2881:2881 --name oceanbase-ce -e MODE=mini -d oceanbase/oceanbase-ce
docker logs oceanbase-ce

看到 boot success! 后连接：

docker exec -it oceanbase-ce obclient -h127.0.0.1 -P2881 -uroot

Windows 上若本机没有 mysql 客户端，优先用容器内 obclient。

方案 B：WSL2 + Linux 路径

适合希望练习 obd / all-in-one 的同学：

安装 WSL2 与 Ubuntu（或其他受支持发行版）
给 WSL 分配足够内存（建议在 .wslconfig 中提高 memory）
在 WSL 内按上文 Linux all-in-one / Docker 步骤执行

注意：WSL 的磁盘 I/O 与内存限制会影响 bootstrap 时间，尽量把数据放在 Linux 文件系统内，不要跨挂载到很慢的 Windows 目录。

六、macOS 搭建

macOS 上同样优先 Docker：

1. 安装 Docker Desktop for Mac

Intel / Apple Silicon 都可使用 Docker Desktop
在 Docker Desktop → Settings → Resources 中给足 CPU/内存（建议 ≥ 2 CPU、8GB）

2. 启动 OceanBase

docker run -p 2881:2881 --name oceanbase-ce -e MODE=mini -d oceanbase/oceanbase-ce

拉取慢时可换：

docker run -p 2881:2881 --name oceanbase-ce -e MODE=mini -d ghcr.io/oceanbase/oceanbase-ce

3. 连接

docker exec -it oceanbase-ce obclient -h127.0.0.1 -P2881 -uroot

4. macOS 特别提醒

官方 all-in-one 标注 Linux Only，不要在 macOS 上硬套那条 installer 当主路径
Apple Silicon 上若镜像/依赖偶发兼容问题，优先换官方备用镜像源，或使用远程 Linux 机器做部署练习
开发联调可把应用跑在 macOS，数据库跑在 Docker 容器；应用连接 127.0.0.1:2881

七、进阶：Kubernetes 与多节点

当你已经不满足“本机单实例体验”，可以往这两类走：

1. Kubernetes：`ob-operator`

官方 README 推荐使用 ob-operator 在 K8s 中部署管理 OceanBase。
适合：

想练容器化运维
需要更接近云原生的生命周期管理
本地 kind/k3s/自建集群实验

快速入口见：https://oceanbase.github.io/ob-operator

2. OBD 自定义集群

obd demo 只是快速单机演示。真正做多副本/多节点时，应使用 OBD 的集群配置与命令组（镜像仓库、集群启停、升级等）。
这已经超出“第一次搭起来”的范围，但方向应是：

先用 Docker / obd demo 跑通连接
再学 OBD 配置文件与集群拓扑
最后再上 K8s operator

八、连接后的最小验收清单

不管你用哪种平台，搭完后建议做同一套验收：

-- 1. 能登录
SELECT 1;

-- 2. 看版本信息
SELECT version();

-- 3. 建库建表
CREATE DATABASE demo;
USE demo;
CREATE TABLE t1(id INT PRIMARY KEY, name VARCHAR(64));
INSERT INTO t1 VALUES (1, 'oceanbase');
SELECT * FROM t1;

宿主机侧再确认：

# 端口监听
# Linux
ss -lntp | grep 2881
# macOS
lsof -iTCP:2881 -sTCP:LISTEN

九、常见问题排查

1. 容器一直起不来 / 没有 `boot success!`

优先检查：

内存是否低于 8GB（Docker 场景）
磁盘是否紧张
docker logs oceanbase-ce 是否有 OOM / 权限 / 存储错误
是否重复占用容器名 oceanbase-ce

处理：

docker rm -f oceanbase-ce
docker run -p 2881:2881 --name oceanbase-ce -e MODE=mini -d oceanbase/oceanbase-ce

2. `2881` 端口冲突

# 换宿主机端口映射，例如 12881 -> 2881
docker run -p 12881:2881 --name oceanbase-ce -e MODE=mini -d oceanbase/oceanbase-ce
mysql -h127.0.0.1 -P12881 -uroot

3. Docker Hub 拉取失败

依次尝试：

quay.io/oceanbase/oceanbase-ce
ghcr.io/oceanbase/oceanbase-ce
配置可用的镜像加速 / 代理

4. 能进容器但不能从宿主机连接

确认 -p 2881:2881 已映射
Windows/macOS 确认 Docker Desktop 正在运行
云服务器还要放行安全组/防火墙入站规则

5. `obd demo` 预检失败

对照官方条件逐项查：

内存、CPU、磁盘是否达标
2881/2882 是否被占用
是否在非 Linux 环境误跑 all-in-one

十、平台选型建议（实战版）

你的目标	建议
30 分钟内先连上跑 SQL	Docker `MODE=mini`
在 Linux 服务器练官方部署工具	all-in-one + `obd demo`
Windows 笔记本本地体验	Docker Desktop
macOS 开发机联调	Docker Desktop
学习 K8s 运维	ob-operator
准备生产环境	不要直接用体验镜像；按正式部署/高可用架构与官方生产文档规划

一句话总结：

跨平台先 Docker；Linux 深造用 OBD；生产上集群/K8s，不要拿体验镜像硬上。

十一、精简命令速查

Docker（全平台）

docker run -p 2881:2881 --name oceanbase-ce -e MODE=mini -d oceanbase/oceanbase-ce
docker logs oceanbase-ce | tail -1
docker exec -it oceanbase-ce obclient -h127.0.0.1 -P2881 -uroot

Linux all-in-one

bash -c "$(curl -s https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/download-center/opensource/oceanbase-all-in-one/installer.sh)"
source ~/.oceanbase-all-in-one/bin/env.sh
obd demo
obclient -h127.0.0.1 -uroot -P2881

OBD RPM（CentOS/RHEL）

sudo yum install -y yum-utils
sudo yum-config-manager --add-repo https://mirrors.aliyun.com/oceanbase/OceanBase.repo
sudo yum install -y ob-deploy
source /etc/profile.d/obd.sh
obd demo

总结

OceanBase 的“多平台搭建”并不要求你在每个 OS 上都原生编译一套数据库：

Docker 是 Linux / Windows / macOS 的最大公约数，适合快速体验与开发联调。
Linux all-in-one + OBD 更接近官方部署工具体验，适合服务器环境。
Windows / macOS 应把精力放在 Docker Desktop（或 WSL2）而不是强行原生部署。
需要容器编排时，转向 ob-operator，而不是把 oceanbase-ce 体验镜像直接当生产方案。

先保证“能启动、能连接、能建表”，再进入租户管理、资源规格、多副本和高可用，路径会清晰很多。

参考资料

OceanBase 官方仓库 README（中英文 Quick Start / Docker / all-in-one）：https://github.com/oceanbase/oceanbase
OceanBase Docker 镜像说明（Docker Hub oceanbase/oceanbase-ce）：https://hub.docker.com/r/oceanbase/oceanbase-ce
OceanBase Docker 镜像仓库文档：https://github.com/oceanbase/docker-images
OceanBase Deployer（OBD）中文 README：https://github.com/oceanbase/obdeploy
ob-operator 文档：https://oceanbase.github.io/ob-operator
OceanBase 中文文档中心：https://www.oceanbase.com/docs/oceanbase-database-cn
快速体验入口：https://open.oceanbase.com/quickStart

OceanBase on 吾爱主机

OceanBase 从零开始：核心概念、上手路径，以及和 MySQL 的关键差异

一、先建立正确心智模型

1. MySQL 的常见心智模型

2. OceanBase 的心智模型

二、OceanBase 是什么

三、和 MySQL 的核心差异总览

四、架构差异：为什么它不像单机 MySQL

1. Shared-Nothing 集群

2. 多租户：最容易被 MySQL 同学忽略的概念

3. OBProxy / ODP：应用如何“像访问单机库一样”访问分布式库

五、连接差异：最容易踩坑的地方

1. Docker 体验环境（最简单）

2. 正式连接写法：用户名里有租户

直连 OBServer（默认端口常为 2881）

通过 ODP/OBProxy（默认端口常为 2883）

3. 客户端选择

六、从零上手：MySQL 同学 10 分钟路径

1. 看有哪些库

2. 创建业务库

3. 建表、写入、查询

4. 看建表细节时的“OceanBase 味道”

七、兼容性：像 MySQL，但不是 100% MySQL

1. 相似度高的部分

2. 必须注意的差异

3. 实战迁移建议

八、对象模型对比：database 相同，边界不同

MySQL

OceanBase

九、一个最小对比实验（帮助真正理解差异）

实验 A：同一套 CRUD

实验 B：连接串差异

实验 C：多租户隔离

十、什么时候适合用 OceanBase，什么时候继续 MySQL

更适合考虑 OceanBase 的场景

更适合继续 MySQL 的场景

十一、学习路线建议

十二、速查对照表

总结

参考资料

OceanBase 多平台搭建教程：Linux / Windows / macOS / Docker 从零到可连接

一、先选对安装路径

资源底线（很重要）

二、通用概念：端口、租户、客户端

三、最快路径：Docker（Linux / Windows / macOS 通用）

1. 前置条件

2. 启动实例

3. 等待 bootstrap 完成

4. 连接验证

5. 常用运维命令

6. 初始化 SQL（可选）

四、Linux 原生：all-in-one + OBD（官方推荐体验路径）

1. 一键安装 all-in-one

2. 一键拉起演示实例

3. 单独安装 OBD（CentOS/RHEL 系）

4. obd demo 前自检清单

五、Windows 搭建

方案 A：Docker Desktop（最简单）

方案 B：WSL2 + Linux 路径

六、macOS 搭建

1. 安装 Docker Desktop for Mac

2. 启动 OceanBase

3. 连接

4. macOS 特别提醒

七、进阶：Kubernetes 与多节点

1. Kubernetes：ob-operator

2. OBD 自定义集群

八、连接后的最小验收清单

九、常见问题排查

1. 容器一直起不来 / 没有 boot success!

2. 2881 端口冲突

3. Docker Hub 拉取失败

4. 能进容器但不能从宿主机连接

5. obd demo 预检失败

十、平台选型建议（实战版）

十一、精简命令速查

Docker（全平台）

Linux all-in-one

OBD RPM（CentOS/RHEL）

总结

4. `obd demo` 前自检清单

1. Kubernetes：`ob-operator`

1. 容器一直起不来 / 没有 `boot success!`

2. `2881` 端口冲突

5. `obd demo` 预检失败