前言端午假期来临这正是技术充电的好时机。恰逢今天2026年6月18日第六届腾讯犀牛鸟开源人才培养计划正式开启本文将手把手教你用一行命令配置与安装腾讯开源分布式数据库 OpenTenBase并带你通过犀牛鸟开源任务实现技术变强拿腾讯面试绿通与精美周边礼包。项目相关技术文章已被 openEuler 社区官方收录感谢openEuler社区的认可。项目团队在华为云平台上使用 openEuler 系统进行了完整的兼容性验证测试确保国产数据库与国产操作系统的深度适配。已发布文章CSDN一、环境要求在开始之前请确认你的服务器满足以下最低条件。这些要求是根据实际部署经验总结的低于这个配置可能会遇到各种莫名其妙的问题。项目要求操作系统Ubuntu 20.04/22.04/24.04、Debian 11/12、Rocky Linux 8/9、AlmaLinux 8/9、CentOS 7/8、Fedora 39/40、openEuler 22.03/24.03CPU 架构x86_64 或 ARM64aarch64两种架构均有完整的二进制包支持内存单节点至少 2GB多节点至少 4GB内存不够的解决方案见第六节磁盘至少 10GB 可用空间建议使用固态硬盘以获得更好的读写性能权限需要 root 或 sudo 权限安装过程涉及系统级目录和 systemd 服务注册网络能访问外网即可中国用户自动使用国内 CDN 加速无需额外配置小贴士如果你使用的是云服务器阿里云、腾讯云、华为云等推荐选择 Ubuntu 22.04 或 Rocky 9这两个发行版的测试覆盖最完善。二、背景为什么要用 OpenTenBase-Packages2.1 OpenTenBase 是什么OpenTenBase 是腾讯开源的分布式数据库基于 PostgreSQL 内核深度定制开发支持 HTAP混合事务/分析处理工作负载。它在腾讯内部经历了多年的大规模生产验证具备强一致性分布式事务、透明水平扩展、自动数据分片、跨节点 JOIN 等核心能力非常适合中大规模业务场景比如电商订单、金融交易、物联网数据等对数据一致性和扩展性有较高要求的应用。2.2 以前部署有多痛苦但长期以来OpenTenBase 的部署体验对新手非常不友好主要体现在以下几个方面源码编译耗时漫长官方仅提供源码编译方式完整编译一次至少需要 30 分钟而且在编译之前还需要手动安装大量依赖库如 readline、zlib、openssl、libxml2 等不同发行版的依赖包名还不一样经常卡在依赖缺失这一步Docker 方案局限性大社区虽然有 Docker Compose 方案但对于需要裸机部署的生产环境并不适用而且 Docker 网络配置对新手来说又是一个门槛版本切换困难不同版本的编译产物互相冲突想在同一台机器上测试多个版本几乎不可能ARM 架构支持缺失国产化浪潮下越来越多的服务器采用 ARM 架构但官方的编译指南在 ARM 平台上经常出错很多感兴趣的开发者在编译阶段就放弃了。2.3 OpenTenBase-Packages 的解决方案OpenTenBase-Packages 项目就是为了彻底解决上述问题而诞生的。项目地址GitHub - CDUESTC-OpenAtom-Open-Source-Club/OpenTenBase-Packages: OpenTenBase 分布式数据库跨平台软件包仓库 — DEB/RPM for 15 Linux distros, x86_64 ARM64 · GitHub它构建了一个跨平台的 APT/RPM 软件包仓库核心设计理念是让安装 OpenTenBase 和安装 nginx 一样简单。项目提供一行命令安装体验覆盖 14 Linux 发行版同时支持 x86_64 和 ARM64 双架构并且同时兼容 v5.0、v2.6.0、v2.5.0 三个大版本。所有软件包均经过 GPG 签名确保完整性和安全性同时集成了 systemd 服务管理开箱即用。三、一行命令安装下面是真正的跟着做就行部分。请根据你的操作系统选择对应的安装方式。3.1 Ubuntu / Debian 系统第一步添加软件源打开终端执行以下命令。这个脚本会自动检测你的系统版本配置对应的 APT 源并导入 GPG 签名密钥curl -sSL https://raw.githubusercontent.com/CDUESTC-OpenAtom-Open-Source-Club/OpenTenBase-Packages/main/scripts/setup-apt.sh | sudo bash预期输出末尾几行[INFO] 检测到系统: Ubuntu 22.04 (jammy) [INFO] 正在导入 GPG 公钥... OK [INFO] 正在写入 APT 源配置... OK OpenTenBase APT 仓库已配置完成 请执行: sudo apt update sudo apt install opentenbase第二步更新索引并安装sudo apt update sudo apt install opentenbase预期输出命中:1 https://packages.opentenbase.org/apt jammy InRelease 正在读取软件包列表... 完成 正在下载 opentenbase (5.0) ... 正在设置 opentenbase (5.0) ...看到上面这个输出说明安装成功。整个过程通常不超过两分钟。3.2 RHEL / CentOS / Rocky / Alma / Fedora 系统第一步添加软件源同样的思路执行 RPM 系列的配置脚本curl -sSL https://raw.githubusercontent.com/CDUESTC-OpenAtom-Open-Source-Club/OpenTenBase-Packages/main/scripts/setup-rpm.sh | sudo bash预期输出[INFO] 检测到系统: Rocky Linux 9 [INFO] 正在导入 GPG 公钥... OK [INFO] 正在写入 RPM 源配置... OK OpenTenBase RPM 仓库已配置完成 请执行: sudo dnf install opentenbase第二步安装sudo dnf install opentenbase注意CentOS 7 用户请将dnf替换为yum因为 CentOS 7 默认没有安装 dnf。四、多版本切换OpenTenBase-Packages 支持在同一台机器上安装多个版本并随时切换这在版本升级、功能对比测试等场景下非常实用。比如你在开发新功能时想同时验证 v5.0 和 v2.6 的行为差异不需要准备两台机器。# 切换到 v5.0最新版 opentenbase-ctl switch 5.0 # 切换到 v2.6稳定版 opentenbase-ctl switch 2.6切换完成后建议通过以下命令确认当前生效的版本opentenbase-ctl version预期输出OpenTenBase v5.0注意切换版本后需要重启服务才能生效sudo systemctl restart opentenbase五、三种部署模式实战安装好 OpenTenBase 之后接下来就是部署了。根据你的使用场景项目提供了三种部署模式。从简单到复杂一步一步来。模式一单节点部署适合开发测试这是最简单的方式在一台机器上运行一个完整的 OpenTenBase 实例所有组件GTM、Coordinator、Datanode合并在一个进程中。适合本地开发调试、功能验证等场景。第一步初始化opentenbase-ctl init --modesingle --port5432预期输出[INFO] 初始化单节点模式... [INFO] 数据目录: /var/lib/opentenbase/data [INFO] 端口: 5432 [INFO] 初始化完成第二步启动服务并设置开机自启sudo systemctl start opentenbase sudo systemctl enable opentenbase验证服务是否正常运行sudo systemctl status opentenbase预期输出● opotenbase.service - OpenTenBase Database Server Loaded: loaded (/etc/systemd/system/opotenbase.service; enabled) Active: active (running) since Fri 2025-01-10 10:30:00 CST第三步连接测试使用 psql 客户端连接到本地数据库psql -h 127.0.0.1 -p 5432 -U opotenbase -d postgres预期输出psql (PostgreSQL) 14.x Type help for help. postgres#到这里单节点部署完成。你可以开始建库建表、写入数据、测试查询了。这是最快的上手方式。模式二单机多节点部署适合测试环境如果你需要测试分布式特性比如分片表、跨节点查询等单节点模式就不够用了。单机多节点模式在一台机器上模拟完整的分布式集群包含 GTM全局事务管理器、Coordinator协调节点和多个 Datanode数据节点。第一步初始化集群下面的命令会初始化一个包含 1 个 GTM、1 个 Coordinator 和 2 个 Datanode 的集群opentenbase-ctl init --modecluster-single \ --gtm-port20001 \ --coordinator-port5432 \ --datanodes2 \ --datanode-ports23001,23002预期输出[INFO] 初始化单机集群模式... [INFO] GTM 端口: 20001 [INFO] Coordinator 端口: 5432 [INFO] Datanode 数量: 2 [INFO] Datanode 端口: 23001, 23002 [INFO] 初始化完成第二步启动所有节点opentenbase-ctl start --all预期输出[INFO] 启动 GTM 节点... [OK] [INFO] 启动 Coordinator 节点... [OK] [INFO] 启动 Datanode 1... [OK] [INFO] 启动 Datanode 2... [OK] [INFO] 所有节点已启动第三步注册数据节点启动之后还需要在 Coordinator 上注册 Datanode这样 Coordinator 才知道数据应该分发到哪些节点。连接到 Coordinatorpsql -h 127.0.0.1 -p 5432 -U opotenbase -d postgres执行以下 SQL 注册数据节点CREATE NODE datanode_1 WITH (TYPEdatanode, HOST127.0.0.1, PORT23001); CREATE NODE datanode_2 WITH (TYPEdatanode, HOST127.0.0.1, PORT23002);第四步验证集群状态SELECT * FROM pgxc_node;预期输出node_name | node_type | host | port ------------------------------------------- coordinator1 | C | 127.0.0.1 | 5432 datanode_1 | D | 127.0.0.1 | 23001 datanode_2 | D | 127.0.0.1 | 23002 (3 rows)能看到上面的结果说明集群部署成功。现在你可以创建分布式表测试数据分片和跨节点查询了。模式三多机多节点部署适合生产环境在生产环境中我们需要将不同的节点部署在不同的物理机或虚拟机上以实现真正的高可用和水平扩展。下面以三台机器为例进行说明。节点IP 地址角色说明节点 A192.168.1.10GTM Coordinator全局事务管理 SQL 协调节点节点 B192.168.1.11Datanode-1数据节点 1存储分片数据节点 C192.168.1.12Datanode-2数据节点 2存储分片数据前置条件请务必逐项检查三台机器都已按照第三章完成 OpenTenBase 安装并且安装版本一致三台机器之间网络互通能互相 ping 通对方 IP防火墙已开放相关端口20001GTM、5432Coordinator、23001 和 23002Datanode可以使用telnet IP 端口逐个验证三台机器的系统时间已同步分布式事务依赖精确的时钟同步建议安装 chrony 或 ntpd确保三台机器的/etc/hosts或 DNS 能正确解析对方的主机名第一步节点 A — 初始化 GTM Coordinator在节点 A192.168.1.10上执行opentenbase-ctl init --modegtm-coordinator \ --gtm-port20001 \ --coordinator-port5432启动节点 A 上的所有服务opentenbase-ctl start --all第二步节点 B — 初始化 Datanode-1在节点 B192.168.1.11上执行。注意这里需要指定 GTM 的地址这样数据节点才能加入全局事务opentenbase-ctl init --modedatanode \ --datanode-port23001 \ --gtm-host192.168.1.10 \ --gtm-port20001启动节点 Bopentenbase-ctl start --all第三步节点 C — 初始化 Datanode-2在节点 C192.168.1.12上执行同样的操作只是端口不同opentenbase-ctl init --modedatanode \ --datanode-port23002 \ --gtm-host192.168.1.10 \ --gtm-port20001启动节点 Copotenbase-ctl start --all第四步在 Coordinator 上注册远程数据节点所有节点启动之后回到节点 A连接到 Coordinator注册远程的数据节点psql -h 192.168.1.10 -p 5432 -U opotenbase -d postgres注册远程数据节点CREATE NODE datanode_1 WITH (TYPEdatanode, HOST192.168.1.11, PORT23001); CREATE NODE datanode_2 WITH (TYPEdatanode, HOST192.168.1.12, PORT23002);最后验证集群拓扑SELECT * FROM pgxc_node;预期输出node_name | node_type | host | port ---------------------------------------------- coordinator1 | C | 192.168.1.10 | 5432 datanode_1 | D | 192.168.1.11 | 23001 datanode_2 | D | 192.168.1.12 | 23002 (3 rows)多机集群部署完成。这就是生产环境推荐的部署架构。后续如果需要扩展只需新增机器、初始化 Datanode、然后在 Coordinator 上注册即可整个过程不需要停机。六、常见错误与解决方案以下是在安装和部署过程中最常遇到的问题基本上都是环境相关的问题对照排查即可解决。错误 1GPG 公钥下载失败现象W: GPG error: https://packages.opotenbase.org ... NO_PUBKEY E: 无法验证签名原因网络不稳定导致 GPG 公钥下载中断或者公司内网的防火墙拦截了 CDN 请求。解决方案首先检查网络连接是否正常然后重新运行安装脚本如果中国 CDN 被拦截安装脚本内置了自动回退机制会切换到 GitHub 源重新下载耐心等待即可如果还是不行可以手动导入 GPG 公钥curl -fsSL https://packages.opotenbase.org/gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/opotenbase.gpg错误 2apt update 报 404 错误现象E: 仓库 http://xxx.xxx.xxx focal Release 没有 Release 文件 W: 无法获取 http://xxx.xxx.xxx/dists/focal/...原因这个问题通常不是 OpenTenBase 导致的。很可能是你系统中安装的其他第三方软件源比如某个旧版的 Docker 源、Wine 源等已经失效了。解决方案仔细看报错信息中的 URL确认是哪个源报的 404大概率不是 OpenTenBase 的移除或禁用失效的第三方源# 列出所有第三方源 ls /etc/apt/sources.list.d/ # 删除有问题的源将 xxx 替换为实际的文件名 sudo rm /etc/apt/sources.list.d/xxx.list # 重新更新 sudo apt update错误 3找不到安装包现象E: 无法定位软件包 opotenbase原因软件源配置中的发行版代号codename与实际系统不匹配。比如你的系统是 Ubuntu 22.04jammy但配置文件里写的是 focal。解决方案先确认你的系统版本代号# Ubuntu / Debian 用户执行 lsb_release -cs # RHEL 系列用户执行 cat /etc/os-release检查 OpenTenBase 源配置中的代号是否正确cat /etc/apt/sources.list.d/opotenbase.list确保里面的focal/jammy/noble等代号与你的系统一致。如果不确定最简单的方法是重新运行一遍setup-apt.sh脚本会自动检测并写入正确的配置。错误 4内存不足导致 OOM现象Out of memory (OOM) Killed process ... (postgres)或者服务启动后立即退出日志中出现内存分配失败的错误。原因OpenTenBase 默认配置对内存要求较高在 2GB 以下内存的机器上比如低配云服务器特别是在多节点模式下很容易触发 OOM Killer。解决方案使用项目提供的低内存部署脚本它会自动调整各组件的内存参数deploy-lowmem-datanode.sh或者手动降低shared_buffers参数# 编辑配置文件 sudo vi /var/lib/opotenbase/data/postgresql.conf # 找到 shared_buffers 并修改为较小的值 shared_buffers 128MB # 默认可能是 256MB 或更高修改完成后重启服务使配置生效sudo systemctl restart opotenbase建议多节点模式下建议至少 4GB 内存。如果条件允许8GB 会更加稳定。七、 实力加分packages 工具助你速通犀牛鸟挑战在端午假期成功部署好 OpenTenBase 环境后你就有了一个绝佳的机会可以在真实的开源大项目中实践今天6月18日正式启动的第六届腾讯犀牛鸟开源人才培养计划中OpenTenBase作为核心课题项目开放了实战任务。不论你是想丰富简历的在校生还是对数据库内核感兴趣的开发者这都是一个绝佳的锻炼机会。你可以通过解决真实的开源 issue 或者课题挑战来白嫖官方证书、鹅厂周边公仔、键盘甚至是高额项目奖金与腾讯面试优先绿通不过通关的前提是快速搭建好稳定运行的数据库开发环境。如果按照传统的源码编译方式去折腾很容易在第一步就被劝退。这正是我们KCOS开放原子开源社团电子科技大学成都学院开放原子开源社团维护OpenTenBase-Packages的意义所在——我们帮你做好了所有平台的打包与 CDN 加速两行命令即刻备妥环境。如果你在开发和参与开源贡献的过程中遇到了任何关于部署或者配置的坑都欢迎来我们社团的项目仓库提 issue 交流GitHub 项目地址GitHub - CDUESTC-OpenAtom-Open-Source-Club/OpenTenBase-Packages: OpenTenBase 分布式数据库跨平台软件包仓库 — DEB/RPM for 15 Linux distros, x86_64 ARM64 · GitHub如果这个项目对你有帮助请顺手给咱们社团点个Star也欢迎关注我们的公众号与我们同行八、项目关键数据截至目前OpenTenBase-Packages 项目已实现以下关键指标指标数据软件包数量156 个支持发行版15 个Ubuntu、Debian、Rocky、Alma、CentOS、Fedora、openEulerCI 测试套件38 套覆盖所有发行版和架构组合每次提交自动运行CPU 架构x86_64 ARM64aarch64版本覆盖v5.0 / v2.6.0 / v2.5.0安全机制所有软件包经过 GPG 签名验证集成 systemd 服务管理国内加速基于 Cloudflare R2 CDN国内下载速度从 50KB/s 提升至 8MB/s项目由KCOS开放原子开源社团电子科技大学成都学院开放原子开源社团持续维护欢迎社区贡献。九、总结OpenTenBase-Packages 解决了分布式数据库最后一公里的问题——让安装部署不再是拦路虎让开发者能把精力集中在业务逻辑上而不是环境搭建上。无论你是初次接触 OpenTenBase 的学生还是需要快速搭建测试环境的运维工程师这个项目都能帮你省下大量时间。总结五大核心亮点一行安装告别漫长的源码编译过程apt install opotenbase或dnf install opotenbase两分钟内完成安装彻底消除了依赖缺失、编译失败等常见痛点全版本兼容v5.0、v2.6.0、v2.5.0 三个版本可共存安装一行命令即可切换方便版本对比和升级测试非常适合需要做版本迁移验证的团队跨平台覆盖14 发行版、x86_64 和 ARM64 双架构基本覆盖了所有主流 Linux 服务器环境包括基于 ARM 架构的国产操作系统三种部署模式单节点、单机多节点、多机多节点从个人开发测试到企业生产环境提供了完整的渐进式覆盖路径中国加速基于 Cloudflare R2 和 CDN 的加速方案国内用户下载速度提升 150-200 倍无需任何额外配置即可享受高速下载如果你正在评估或使用 OpenTenBase强烈建议试用这个项目。如果在安装或部署过程中遇到任何问题可以在 GitHub 仓库提 Issue维护者会及时响应。同时也欢迎提交 PR 参与贡献无论是添加新发行版支持、修复文档错误还是分享你的使用经验都非常有价值。项目地址GitHub - CDUESTC-OpenAtom-Open-Source-Club/OpenTenBase-Packages: OpenTenBase 分布式数据库跨平台软件包仓库 — DEB/RPM for 15 Linux distros, x86_64 ARM64 · GitHub