0. 有奖征文活动
OceanBase 社区正在组织一个以 “OBD 单机部署上手体验” 为主题的有奖征文活动，参与方式详见：https://ask.oceanbase.com/t/topic/35630223。
征文奖金超级丰厚，具体有多么丰厚？更多详情👉「2025 OceanBase 布道师计划」
1. 概述
本文主要分享在 Windows 笔记本上的 Linux 子系统 Ubuntu 上部署 OB 社区版单机版的过程以及相关原理讲解。
本次部署没有部署 OCP ，OB 集群的部署是依赖 obd web 平台做的。部署后会自动启动 OB-Dashboard （进程是 obshell ，Http 端口是 2886 )。通过 OB-Dashbaord 也可以做一些简单的 OB 单节点运维。
2. 环境准备
部署环境是 Windows 笔记本上的一个 WSL 子系统，选择的是 Ubuntu-22.04 。大概 16C 22G 内存资源，1T 空间。
d:\Download>wsl -l -v NAME STATE VERSION* Ubuntu-22.04 Running 2
复制代码
2.1 资源检查
OB 社区版运行最小资源规格官网说明是 2C4G 。考虑到 OB 的多租户能力，这里就不测试这种小规格了，个人在生产部署最低要求 8C16G。
进入 Ubuntu 系统后，核实一下机器资源。
mq@OBPILOT:~$ lscpuArchitecture: x86_64 CPU op-mode(s): 32-bit, 64-bit Address sizes: 48 bits physical, 48 bits virtual Byte Order: Little EndianCPU(s): 16 On-line CPU(s) list: 0-15Vendor ID: AuthenticAMD Model name: AMD Ryzen 7 7840U w/ Radeon 780M Graphics CPU family: 25 Model: 116 Thread(s) per core: 2 Core(s) per socket: 8 Socket(s): 1 Stepping: 1 BogoMIPS: 6587.24 Flags: fpu vme de pse tsc msr pae mce cx8 apic sep mtrr pge mca cmov pat pse36 clflush mmx fxsr sse sse2 ht syscall nx mmxext fxsr_opt pdpe1gb rdtscp lm constant_tsc rep_good nopl tsc_reliable nonstop_tsc cpuid extd_apicid pni pclmulqdq ssse3 fma cx16 sse4_1 sse4_2 movbe popcnt aes xsave avx f16c rdrand hypervisor lahf_lm cmp_legacy svm cr8_legacy abm sse4a misalignsse 3dnowprefetch osvw topoext perfctr_core ssbd ibrs ibpb stibp vmm call fsgsbase bmi1 avx2 smep bmi2 erms invpcid avx512f avx512dq rdseed adx smap avx512ifma clflushopt clwb avx512cd sha_ni avx512bw avx512vl xs aveopt xsavec xgetbv1 xsaves avx512_bf16 clzero xsaveerptr arat npt nrip_save tsc_scale vmcb_clean flushbyasid decodeassists pausefilter pfthre shold v_vmsave_vmload avx512vbmi umip avx512_vbmi2 gfni vaes vpclmulqdq avx512_vnni avx512_bitalg avx512_vpopcntdq rdpid fsrmVirtualization features: Virtualization: AMD-V Hypervisor vendor: Microsoft Virtualization type: fullCaches (sum of all): L1d: 256 KiB (8 instances) L1i: 256 KiB (8 instances) L2: 8 MiB (8 instances) L3: 16 MiB (1 instance)Vulnerabilities: Gather data sampling: Not affected Itlb multihit: Not affected L1tf: Not affected Mds: Not affected Meltdown: Not affected Mmio stale data: Not affected Reg file data sampling: Not affected Retbleed: Not affected Spec rstack overflow: Mitigation; safe RET Spec store bypass: Mitigation; Speculative Store Bypass disabled via prctl and seccomp Spectre v1: Mitigation; usercopy/swapgs barriers and __user pointer sanitization Spectre v2: Mitigation; Retpolines; IBPB conditional; IBRS_FW; STIBP always-on; RSB filling; PBRSB-eIBRS Not affected; BHI Not affected Srbds: Not affected Tsx async abort: Not affected
复制代码
CPU 是 AMD 的，其中关键信息是 16 个 逻辑 CPU，CPU Flags 支持 avx2、avx512 相关指令集。
mq@OBPILOT:~$ free -h total used free shared buff/cache availableMem: 23Gi 548Mi 22Gi 14Mi 236Mi 22GiSwap: 4.0Gi 0B 4.0Gi
复制代码
OB 社区版在 github 开源,开源地址：https://github.com/oceanbase/oceanbase 。
mq@OBPILOT:~/obce/ob-deploy$ ping github.comPING github.com (20.205.243.166) 56(84) bytes of data.64 bytes from 20.205.243.166: icmp_seq=3 ttl=110 time=85.0 ms64 bytes from 20.205.243.166 (20.205.243.166): icmp_seq=4 ttl=110 time=84.5 ms64 bytes from 20.205.243.166: icmp_seq=5 ttl=110 time=84.0 ms64 bytes from 20.205.243.166 (20.205.243.166): icmp_seq=6 ttl=110 time=86.2 ms64 bytes from 20.205.243.166: icmp_seq=7 ttl=110 time=87.1 ms64 bytes from 20.205.243.166 (20.205.243.166): icmp_seq=8 ttl=110 time=89.3 ms^C64 bytes from 20.205.243.166: icmp_seq=9 ttl=110 time=88.5 ms
--- github.com ping statistics ---9 packets transmitted, 7 received, 22.2222% packet loss, time 35399msrtt min/avg/max/mdev = 84.003/86.359/89.261/1.865 msmq@OBPILOT:~/obce/ob-deploy$
复制代码
mq@OBPILOT:~/obce/ob-deploy$ gcc --versiongcc (Ubuntu 11.4.0-1ubuntu1~22.04.2) 11.4.0Copyright (C) 2021 Free Software Foundation, Inc.This is free software; see the source for copying conditions. There is NOwarranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
复制代码
mq@OBPILOT:~/obce/ob-deploy$ sudo ufw statusStatus: inactive
复制代码
2.2 下载软件
部署下载地址： https://www.oceanbase.com/softwarecenter
OB 软件后期通过部署软件自动下载。
CentOS/RHEL/Fedora 等使用 RPM 包管理系统（.rpm 文件），Ubuntu/Debian 等使用 Debian 包管理系统（.deb 文件）。这两种格式互不兼容，Ubuntu 的 dpkg 和 apt 无法直接安装或管理 RPM 文件。
官网 OBD 的软件包只有 RPM 格式，分别支持 x86 版和 ARM 版。 所以这里有多个途径可以在 Ubuntu 下使用 RPM 包。
安装 rpm 命令
将 rpm 文件转换为 deb 文件
提取 RPM 包内容手动安装。
这里首先演示一下 3 ，这样能理解 rpm 包的原理。
首先安装提取 RPM 包所需要的软件。
sudo apt updatesudo apt install rpm2cpio cpio
复制代码
然后创建目录 ob-deploy 并提取文件到目录中。
mkdir ob-deploycd ob-deployrpm2cpio ../ob-deploy-3.6.0-3.el7.x86_64.rpm | cpio -idmv
复制代码
查看解压缩的目录结构，也能看出原 RPM 包安装的时候文件会复制到的目标目录。
mq@OBPILOT:~/obce/ob-deploy$ tree -L 3.├── etc│ └── profile.d│ └── obd.sh└── usr ├── bin │ └── obd └── obd ├── config_parser ├── example ├── lib ├── mirror ├── optimize ├── plugins ├── web └── workflows
13 directories, 2 files
复制代码
所以，手动将这些目录文件复制到系统目录。
sudo cp -r etc/* /etc/sudo cp -r usr/* /usr/which obd
obd --version
mq@OBPILOT:~/obce/ob-deploy$ which obd/usr/bin/obdmq@OBPILOT:~/obce/ob-deploy$ obd --versionOceanBase Deploy: 3.6.0REVISION: b36013bb09a84516e56db51dba78a9d9096735e7BUILD_BRANCH: HEADBUILD_TIME: Sep 04 2025 10:50:58OURCECopyright (C) 2025 OceanBaseLicense Apache 2.0: Apache version 2 or later <https://www.apache.org/licenses/LICENSE-2.0>.This is free software: you are free to change and redistribute it.There is NO WARRANTY, to the extent permitted by law.
复制代码
3. 安装部署
3.1 前置部署
mq@OBPILOT:~/obce/ob-deploy$ sudo ufw disableFirewall stopped and disabled on system startup
复制代码
sudo apt updatesudo apt install -y gcc make libssl-dev python3 python3-pip libaio1 libaio-dev
复制代码
# 创建自定义配置文件sudo tee /etc/sysctl.d/99-custom.conf << EOFvm.swappiness=0net.core.somaxconn=2048vm.overcommit_memory=0fs.file-max=6573688EOF
# 应用所有配置sudo sysctl --system
复制代码
sudo useradd -m -s /bin/bash -g admin adminsudo passwd admin
复制代码
Ubuntu 里默认没有 admin 用户，但是可能有个 admin 用户组，并且默认有 sudo 权限。这个也符合 OB 运维需求，admin 用户有 sudo 权限，能减少切换 root 的次数，降低误操作风险。这里各个客户公司安全规范不一，可以不一样。
mq@OBPILOT:~$ sudo su - adminTo run a command as administrator (user "root"), use "sudo <command>".See "man sudo_root" for details.
Welcome to Ubuntu 22.04.5 LTS (GNU/Linux 5.15.167.4-microsoft-standard-WSL2 x86_64)
* Documentation: https://help.ubuntu.com * Management: https://landscape.canonical.com * Support: https://ubuntu.com/pro
System information as of Mon Sep 8 17:09:42 CST 2025
System load: 0.19 Processes: 55 Usage of /: 4.5% of 1006.85GB Users logged in: 1 Memory usage: 3% IPv4 address for eth0: 172.20.143.100 Swap usage: 0%
* Strictly confined Kubernetes makes edge and IoT secure. Learn how MicroK8s just raised the bar for easy, resilient and secure K8s cluster deployment.
https://ubuntu.com/engage/secure-kubernetes-at-the-edge
This message is shown once a day. To disable it please create the/home/admin/.hushlogin file.admin@OBPILOT:~$ sudo date
[sudo] password for admin: Mon Sep 8 17:09:59 CST 2025
复制代码
WSL 子系统 Ubuntu 默认没有启动 SSHD 服务，还需要安装一下。
sudo apt updatesudo apt install openssh-server
复制代码
启动服务 SSH 。
# 手动启动sudo service ssh start
# 检查状态sudo service ssh status
# 停止服务sudo service ssh stop
mq@OBPILOT:~$ sudo service ssh status● ssh.service - OpenBSD Secure Shell server Loaded: loaded (/lib/systemd/system/ssh.service; enabled; vendor preset: enabled) Active: active (running) since Mon 2025-09-08 17:14:11 CST; 2min 52s ago Docs: man:sshd(8) man:sshd_config(5) Main PID: 4696 (sshd) Tasks: 1 (limit: 28835) Memory: 1.7M CGroup: /system.slice/ssh.service └─4696 "sshd: /usr/sbin/sshd -D [listener] 0 of 10-100 startups"
Sep 08 17:14:11 OBPILOT systemd[1]: Starting OpenBSD Secure Shell server...Sep 08 17:14:11 OBPILOT sshd[4696]: Server listening on 0.0.0.0 port 22.Sep 08 17:14:11 OBPILOT sshd[4696]: Server listening on :: port 22.Sep 08 17:14:11 OBPILOT systemd[1]: Started OpenBSD Secure Shell server.
复制代码
通常 OB 有两个主要目录。数据目录放在 /data/1 ，（事务）日志目录放在 /data/log1 。生产环境这两个目录要用独立的磁盘和文件系统。这里是测试环境，就共用一块盘和文件系统了。
sudo mkdir -p /data && sudo chown -R admin.admin /data
复制代码
3.2 OBD 白屏部署 OB 单机版
这里就部署在当前用户（普通用户mq下），个人认为部署在 root 下是很危险的。
mq@OBPILOT:~$ sudo obd web startstart OBD WEB in 0.0.0.0:8680please open http://127.0.1.1:8680
复制代码
这里注意我是用 sudo 命令启动的。 用跟不用区别很大，不用，就是安装到当前用户下；用，就是可以安装到不同用户下（我也不想安装到 root 用户下）。
这里提示的访问地址是 127.0.0.1 ，由于是虚拟机，外面肯定无法访问这个地址。所以还需要查看虚拟机地址。
mq@OBPILOT:~$ ip addr1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN group default qlen 1000 link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00 inet 127.0.0.1/8 scope host lo valid_lft forever preferred_lft forever inet 10.255.255.254/32 brd 10.255.255.254 scope global lo valid_lft forever preferred_lft forever inet6 ::1/128 scope host valid_lft forever preferred_lft forever2: eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc mq state UP group default qlen 1000 link/ether 00:15:5d:73:e0:00 brd ff:ff:ff:ff:ff:ff inet 172.20.143.100/20 brd 172.20.143.255 scope global eth0 valid_lft forever preferred_lft forever inet6 fe80::215:5dff:fe73:e000/64 scope link valid_lft forever preferred_lft forever
复制代码
里面真实 IP 是 172.20.143.100 ，所以访问地址是： http://172.20.143.100:8680/
看到这个页面，就成功了四分之一。点击“开启体验之旅”。
这里 OBD WEB 提供了 OB 的部署、OB 云平台的部署以及组件的管理。本文主要探索 OB 单机部署，所以不选择 【OB 云平台】，选第一个【OB 及配套工具】。
后面会进入 OB 部署向导页面。
3.2.1 部署配置
集群名称很重要，后期不能改。
版本的选择，如果是正式业务用，就查看官网 Release Note 里。一般首先用 LTS 版本（4.2.5 或 4.3.5 ），然后选择倒数第二个 BP 版本。
负载类型有 OLTP、OLAP、HTAP、OBKV 等。选错了也没关系。这个选择只是影响一些参数的设置，并且这些参数后期都可以改。
这些组件的作用在生产的运维，都很有必要。 有 OCP 的场景里，这些组件都在后台默默的工作（除了 OBConfigServer）；没有 OCP 的场景里，组件的作用就浮出水面了。
所有组件除了 OBConfigServer 外大家都能理解，OBConfigServer 应该是一个“服务”，用于 OB RS 的元信息的注册、查询和存储。以前手动部署 OB 集群的时候，缺陷就是 RS 是写死 IP 的，有了这个服务，OBProxy 就可以写死这个服务的 API 地址动态获取 OB 集群的 RS 地址。
3.2.2 节点配置
这里只有一个节点，并且尽量不要用 127.0.0.1 那个地址，改用实际的 IP 。
部署用户名就用常用的 admin 用户。不要用 root！
部署目录就用常用的默认目录：/home/admin/obcedemo 。
3.2.3 集群配置
模式配置如果是生产服务器，就选择“最大占用”；开发测试环境选择“最小可用”。这个是给不熟悉 OB 的人使用。选错不要紧，后面还可以改相应参数。
OBShell 端口 2886 后面会有用。
即使是初学者，也建议配置这些参数。否则后面磁盘和内存被用去大半会让人很意外。这里的每个参数都有其用处，可以参考图中配置。
小内存规格下，参数product_mode 设置为 False 。
主要就设置一下密码，其他参数都保持默认。
主要就是小内存环境限制一下 OBProxy 的内存。如果是生产环境，还要调大这个内存参数 proxy_mem_limited 。
后面参数按页面提示输入相应的。( 这里 vip_address 有个前端 BUG ，格式检查不过。可以收起这个“更多配置” 绕过这个问题
3.2.4 预检查
3.2.5 开始部署
点击下面的“部署按钮”。
3.2.6 创建业务租户
创建成功如下。
3.2.7 租户连接
验证租户连接需要命令obclient 。先安装一下。
mkdir obclient && cd obclientrpm2cpio ../obclient-2.2.11-22025090217.el7.x86_64.rpm |cpio -idmvsudo cp -r u01/obclient/bin/* /usr/local/bin/
复制代码
4. OB 社区版体验
4.1 巡检 OB 体验环境
命令行下还是使用 obd 命令查看部署信息。
mq@OBPILOT:~$ sudo obd cluster display obcedemoGet local repositories and plugins okOpen ssh connection okConnect to ob-configserver ok+--------------------------------------------------------------------+| ob-configserver |+----------------+------+----------------+----------+--------+-------+| server | port | vip_address | vip_port | status | pid |+----------------+------+----------------+----------+--------+-------+| 172.20.143.100 | 8080 | 172.20.143.100 | 8080 | active | 27382 |+----------------+------+----------------+----------+--------+-------+curl -s 'http://172.20.143.100:8080/services?Action=GetObProxyConfig'Connect to observer 172.20.143.100:2881 okWait for observer init ok+--------------------------------------------------+| oceanbase-ce |+----------------+---------+------+-------+--------+| ip | version | port | zone | status |+----------------+---------+------+-------+--------+| 172.20.143.100 | 4.3.5.3 | 2881 | zone1 | ACTIVE |+----------------+---------+------+-------+--------+obclient -h172.20.143.100 -P2881 -uroot@sys -p'*******' -Doceanbase -A
cluster unique id: b8c970ad-2f63-50f3-9b9e-7c77262e05ee-199314d5555-03050304
Connect to obproxy ok+--------------------------------------------------------------------+| obproxy-ce |+----------------+------+-----------------+-----------------+--------+| ip | port | prometheus_port | rpc_listen_port | status |+----------------+------+-----------------+-----------------+--------+| 172.20.143.100 | 2883 | 2884 | 2885 | active |+----------------+------+-----------------+-----------------+--------+obclient -h172.20.143.100 -P2883 -uroot@proxysys -p'***********' -Doceanbase -A
Connect to Obagent ok+-------------------------------------------------------------------+| obagent |+----------------+--------------------+--------------------+--------+| ip | mgragent_http_port | monagent_http_port | status |+----------------+--------------------+--------------------+--------+| 172.20.143.100 | 8089 | 8088 | active |+----------------+--------------------+--------------------+--------+Connect to Prometheus ok+----------------------------------------------------------+| prometheus |+----------------------------+-------+------------+--------+| url | user | password | status |+----------------------------+-------+------------+--------+| http://172.20.143.100:9090 | admin | '*********' | active |+----------------------------+-------+------------+--------+Connect to grafana ok+----------------------------------------------------------------------+| grafana |+----------------------------------------+-------+------------+--------+| url | user | password | status |+----------------------------------------+-------+------------+--------+| http://172.20.143.100:3000/d/oceanbase | admin | '********' | active |+----------------------------------------+-------+------------+--------+Connect to Alertmanager ok+------------------------------------------------------------+| alertmanager |+----------------------------+-------+--------------+--------+| url | user | password | status |+----------------------------+-------+--------------+--------+| http://172.20.143.100:9093 | admin | '*********' | active |+----------------------------+-------+--------------+--------+obshell program health check okdisplay ob-dashboard ok+---------------------------------------------------------+| ob-dashboard |+----------------------------+------+------------+--------+| url | user | password | status |+----------------------------+------+------------+--------+| http://172.20.143.100:2886 | root | '********' | active |+----------------------------+------+------------+--------+
Trace ID: 6acb9326-8df4-11f0-8bd2-00155dd330c2If you want to view detailed obd logs, please run: obd display-trace 6acb9326-8df4-11f0-8bd2-00155dd330c2
复制代码
这个命令会把密码明文输出，这个很不好。上面 * 是我改过 的。产品其实可以将密码的背景色和前景色设置为一样，让密码不是那么“直白” 但是可以被复制。
admin@OBPILOT:~/obcedemo$ pwd/home/admin/obcedemoadmin@OBPILOT:~/obcedemo$ tree -L 2.├── alertmanager│ ├── LICENSE -> /home/admin/.obd/repository/alertmanager/0.28.1/c5fe05fcc8263b83f6d0602a871d7e1a7a79bdb8//./LICENSE│ ├── NOTICE -> /home/admin/.obd/repository/alertmanager/0.28.1/c5fe05fcc8263b83f6d0602a871d7e1a7a79bdb8//./NOTICE│ ├── alertmanager -> /home/admin/.obd/repository/alertmanager/0.28.1/c5fe05fcc8263b83f6d0602a871d7e1a7a79bdb8//./alertmanager│ ├── alertmanager.yaml│ ├── alertmanager.yml -> /home/admin/.obd/repository/alertmanager/0.28.1/c5fe05fcc8263b83f6d0602a871d7e1a7a79bdb8//./alertmanager.yml│ ├── amtool -> /home/admin/.obd/repository/alertmanager/0.28.1/c5fe05fcc8263b83f6d0602a871d7e1a7a79bdb8//./amtool│ ├── data│ ├── log│ ├── run│ └── web_config.yaml├── grafana│ ├── bin│ ├── conf│ ├── data│ ├── log -> /home/admin/obcedemo/grafana/data/log│ ├── plugins-bundled│ ├── public│ ├── run│ └── scripts├── obagent│ ├── backup│ ├── bin│ ├── conf│ ├── log│ ├── pkg_store│ ├── position_store│ ├── run│ ├── site-packages│ ├── task_store│ └── tmp├── obconfigserver│ ├── bin│ ├── conf│ ├── log│ └── run├── obproxy│ ├── bin│ ├── control-config│ ├── etc│ ├── lib│ ├── log│ ├── obproxyd.sh│ ├── run│ └── sharding-config├── oceanbase│ ├── admin│ ├── audit│ ├── bin│ ├── etc│ ├── etc2│ ├── etc3│ ├── lib│ ├── log│ ├── log_obshell│ ├── run│ └── store -> /data/1└── prometheus ├── console_libraries ├── consoles ├── data ├── log ├── prometheus -> /home/admin/.obd/repository/prometheus/2.37.1/d5fe6d40b6ccd6de9de036fd294966d044a3c328/prometheus ├── prometheus.yaml ├── prometheusd.sh ├── promtool -> /home/admin/.obd/repository/prometheus/2.37.1/d5fe6d40b6ccd6de9de036fd294966d044a3c328/promtool ├── rules ├── run └── web_config.yaml
56 directories, 13 files
admin@OBPILOT:~/obcedemo/oceanbase$ cd oceanbase/admin@OBPILOT:~/obcedemo/oceanbase$ tree bin -L 1bin├── import_srs_data.py -> /home/admin/.obd/repository/oceanbase-ce/4.3.5.3/01caa84d50b07cc5d09d3a34be2d543dd72e708f/bin/./import_srs_data.py├── import_time_zone_info.py -> /home/admin/.obd/repository/oceanbase-ce/4.3.5.3/01caa84d50b07cc5d09d3a34be2d543dd72e708f/bin/./import_time_zone_info.py├── observer -> /home/admin/.obd/repository/oceanbase-ce/4.3.5.3/01caa84d50b07cc5d09d3a34be2d543dd72e708f/bin/./observer└── obshell -> /home/admin/.obd/repository/oceanbase-ce/4.3.5.3/01caa84d50b07cc5d09d3a34be2d543dd72e708f/bin/./obshell
0 directories, 4 files
admin@OBPILOT:~/obcedemo/oceanbase$ ll storelrwxrwxrwx 1 admin admin 7 Sep 10 09:39 store -> /data/1/admin@OBPILOT:~/obcedemo/oceanbase$ tree storestore├── clog -> /data/log1/clog├── slog│ ├── server│ │ └── 1│ ├── tenant_1│ │ └── 1│ ├── tenant_1001│ │ └── 1│ └── tenant_1002│ └── 1└── sstable └── block_file
7 directories, 5 files
复制代码
上面是 OB 相关的目录。这些目录有个需要注意的点就是 observer 和 obproxy 以及相关产品的可执行文件、个别脚本文件实际上都是软连接，真实的文件存在隐藏目录 ~/.obd 下。千万不要删除这个隐藏目录，也不要以为删除了软件目录就清理干净了。
最好的清理方法是用 obd 命令去清理。
admin@OBPILOT:~/obcedemo/oceanbase$ tree store/clog/tenant_1* -L 2store/clog/tenant_1└── 1 ├── log └── metastore/clog/tenant_1001└── 1 ├── log └── metastore/clog/tenant_1002├── 1│ ├── log│ └── meta└── 1001 ├── log └── meta
复制代码
上面就是 OB 4.2 讲的比较多的事务日志流的文件夹。每个租户一个大文件夹。
mq@OBPILOT:~$ sudo ss -tulnp | awk '!seen[$5]++'Netid State Recv-Q Send-Q Local Address:Port Peer Address:PortProcessudp UNCONN 0 0 127.0.0.53%lo:53 0.0.0.0:* users:(("systemd-resolve",pid=132,fd=13))udp UNCONN 0 0 10.255.255.254:53 0.0.0.0:*udp UNCONN 0 0 127.0.0.1:323 0.0.0.0:*udp UNCONN 0 0 [::1]:323 [::]:*tcp LISTEN 0 128 0.0.0.0:2884 0.0.0.0:* users:(("obproxy",pid=28181,fd=18))tcp LISTEN 0 1024 0.0.0.0:2885 0.0.0.0:* users:(("obproxy",pid=28181,fd=103))tcp LISTEN 0 1024 0.0.0.0:2881 0.0.0.0:* users:(("observer",pid=27477,fd=199))tcp LISTEN 0 1024 0.0.0.0:2882 0.0.0.0:* users:(("observer",pid=27477,fd=99))tcp LISTEN 0 1024 0.0.0.0:2883 0.0.0.0:* users:(("obproxy",pid=28181,fd=98))tcp LISTEN 0 128 0.0.0.0:22 0.0.0.0:* users:(("sshd",pid=250,fd=3))tcp LISTEN 0 244 127.0.0.1:5432 0.0.0.0:* users:(("postgres",pid=904,fd=5))tcp LISTEN 0 1024 [::]:2885 [::]:* users:(("obproxy",pid=28181,fd=106))tcp LISTEN 0 2048 *:2886 *:* users:(("obshell",pid=27993,fd=9))tcp LISTEN 0 1024 [::]:2882 [::]:* users:(("observer",pid=27477,fd=103))tcp LISTEN 0 1024 [::]:2883 [::]:* users:(("obproxy",pid=28181,fd=100))tcp LISTEN 0 2048 *:3000 *:* users:(("grafana-server",pid=28755,fd=12))tcp LISTEN 0 128 [::]:22 [::]:* users:(("sshd",pid=250,fd=4))tcp LISTEN 0 2048 *:8080 *:* users:(("ob-configserver",pid=27382,fd=7))tcp LISTEN 0 2048 *:8088 *:* users:(("ob_monagent",pid=28351,fd=7))tcp LISTEN 0 2048 *:8089 *:* users:(("ob_mgragent",pid=28350,fd=7))tcp LISTEN 0 2048 *:9093 *:* users:(("alertmanager",pid=28857,fd=3))tcp LISTEN 0 2048 *:9090 *:* users:(("prometheus",pid=28639,fd=3))
复制代码
OBSERVER 本身很简单，单进程软件，就监听 2881 和 2882 . OBProxy 也是单进程软件，监听 2883、2884、2885 。 OBSHELL 进程监听 2886 。每个端口都有特殊的用途。具体参考官网文档。
4.2 OB_CONFIGSERVER 体验
ob_configserver 是为了方便没有 OCP 的情况下 OB 集群（多节点）的 RootService 服务地址的获取。OB 集群的参数 obconfig_url 就是为此设计，通常在生产环境这个内容是 OCP 的一个 API 地址。如果没有部署 OCP ，那就需要单独的一个服务提供这个 RoootService 元信息的读和写。
通常 OB 集群的参数 rootservice_list 会记录这个集群的 RootService 地址，这个参数是 observer 启动初始化时指定的参数。这个参数的弊端在于写死了，如果后期 SYS 租户换机器了，RootService 地址也会变化，但是这个参数不会变。
所以 OB 集群还有个参数 obconfig_url 是一个 API ，这个 API 可以获取这个集群的 RootService 地址。当 OB 集群的 SYS 租户成员发生变动时（也就是 RootService 地址发生变动）, OB 集群会通过这个 API 写入新的地址。
如果没有部署 OCP 了，那就部署一个单独的服务 ob_configserver 。下面通过这个 API 读取一下值。
这里面就是显示的 RootService 地址。
在 OBProxy 启动的时候也需要 OB 集群的 RootService 地址。同样的 OBProxy 也有两个类似参数。目前 Dashboard 还不支持查看 OBProxy 参数，我们就到命令行下去查看。
admin@OBPILOT:~/obcedemo/obproxy$ mysql -h127.1 -uroot@proxysys -P2883 -p -c -AEnter password: Welcome to the MySQL monitor. Commands end with ; or \g.Your MySQL connection id is 786432005Server version: 5.6.25
Copyright (c) 2000, 2025, Oracle and/or its affiliates.
Oracle is a registered trademark of Oracle Corporation and/or itsaffiliates. Other names may be trademarks of their respectiveowners.
Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
mysql> show proxyconfig like '%rootservice_list%';+------------------+---------------------+------------------------------------------------------------------------------------------------------------------+-------------+---------------+-------+--------------+| name | value | info | need_reboot | visible_level | range | config_level |+------------------+---------------------+------------------------------------------------------------------------------------------------------------------+-------------+---------------+-------+--------------+| rootservice_list | 172.20.143.100:2881 | a list of servers against which election candidate is checked for validation, format ip1:sql_port1;ip2:sql_port2 | true | SYS | | LEVEL_GLOBAL |+------------------+---------------------+------------------------------------------------------------------------------------------------------------------+-------------+---------------+-------+--------------+1 row in set (0.00 sec)
mysql> show proxyconfig like '%obproxy_config_server_url%';+---------------------------+-------------------------------------------------------------+---------------------------------------+-------------+---------------+-------+--------------+| name | value | info | need_reboot | visible_level | range | config_level |+---------------------------+-------------------------------------------------------------+---------------------------------------+-------------+---------------+-------+--------------+| obproxy_config_server_url | http://172.20.143.100:8080/services?Action=GetObProxyConfig | url of config info(rs list and so on) | true | SYS | | LEVEL_GLOBAL |+---------------------------+-------------------------------------------------------------+---------------------------------------+-------------+---------------+-------+--------------+1 row in set (0.00 sec)
mysql>
复制代码
同样，我们要看看读取这里的 API 地址返回信息。
这个里面就记录了这个 OBProxy 集群能连接的 OB 集群对应的参数 obconfig_url 值。也就是前面的 API 地址。
所以，这两个 API 就是 ob_configserver 服务提供的。
下面是巡检 ob_configserver 服务
首先确认 ob_configserver 已经启动。
mq@OBPILOT:~$ sudo ss -tulnp | awk '!seen[$5]++' |grep 8080tcp LISTEN 0 2048 *:8080 *:* users:(("ob-configserver",pid=27382,fd=7))
复制代码
然后查看 ob_configserver 参数。
admin@OBPILOT:~/obcedemo/obconfigserver$ cat conf/ob-configserver.yamllog: level: info filename: /home/admin/obcedemo/obconfigserver/log/ob-configserver.log maxsize: 30 maxage: 7 maxbackups: 10 localtime: true compress: trueserver: address: 0.0.0.0:8080 run_dir: runvip: address: 172.20.143.100 port: 8080storage: database_type: sqlite3 connection_url: /home/admin/obcedemo/obconfigserver/.data.db?cache=shared&_fk=1
复制代码
这个参数里指定了 VIP 地址，这个可以是实际物理 IP ，也可以是虚拟 IP 。在生产环境，如果 OB 集群是多节点的，这个应该是负载提供的 VIP，后端对应有部署 ob_configserver 的 地址 IP（可以独立部署在虚拟机上，也可以部署在 OB 节点上）。
参数文件里还提示了 ob_configserver 的日志。
查看日志就可以看到这个 API 周期性的被调用读取（GET）。如果是写入信息，那就是 POST 。GET 和 POST 是 HTTP 协议的内容。如果 API 有问题，这个日志里就有明细。
4.3 OB Dashboard 体验
mq@OBPILOT:~$ ps -ef|grep obshelladmin 27960 1 0 09:48 ? 00:00:00 /home/admin/obcedemo/oceanbase/bin/obshell daemon --ip 172.20.143.100 --port 2886admin 27993 27960 0 09:48 ? 00:00:10 /home/admin/obcedemo/oceanbase/bin/obshell server --ip 172.20.143.100 --port 2886mq 53601 421 0 11:08 pts/0 00:00:00 grep obshell
复制代码
obshell 进程监听端口是 2886 , 这是 http 协议访问，访问地址： http://172.20.143.100:2886/
这个密码是 sys 租户的 root 密码。
登陆后首页是集群管理，只支持当前集群。
这个时候能做的运维有参数管理、停止集群。
租户管理下可以新建租户。这个很常见就不用演示了。
租户下可以新建数据库和新建用户。
可以上传软件包。一般来说要把当前 OB 集群版本和 obshell 版本软件上传上去，以后才可以升级。
没有软件包删除入口，功能还有待完善。
OB-Dashboard 的运维也是参考 OCP 的框架，只不过是更精简一些。运维操作都以任务流形式存在。任务流的细节目前看还比较粗糙。
包括集群的参数管理和租户的参数管理。
集群的参数影响的是整个集群。
租户的参数管理只影响当前租户。
5. 总结
总体上来说 OB 社区版如果是测试学习，可以在笔记本上单机部署，并且不需要部署 OCP ，使用 OB-Dashboard 可以做一些简单的基础运维。
当然性能监控这些就还有待产品完善。如果是生产环境多节点集群，还是建议用专门的服务器部署一台社区版的 OCP 用于 OB 集群的运维。
使用 OBD 命令运维还是过于偏技术细节，有一定复杂度和风险。
最后为大家推荐这个 OceanBase 开源负责人老纪的公众号「老纪的技术唠嗑局」，会持续更新和 #数据库、#AI、#技术架构 相关的各种技术内容。欢迎感兴趣的朋友们关注！
「老纪的技术唠嗑局」不仅希望能持续给大家带来有价值的技术分享，也希望能和大家一起为开源社区贡献一份力量。如果你对 OceanBase 开源社区认可，点亮一颗小星星✨吧！你的每一个 Star，都是我们努力的动力。
评论