安装选择与部署验收

本页以正式发布 v4.2.5 为验证基线(2026-10-14)。先选择用途和平台,再固定软件版本;安装完成的标准是能够连接、读写且重启后数据仍在,不只是进程或容器已启动。

选择安装方式

用途与平台

安装入口

需要确认

Linux/macOS 本地体验

Docker;macOS 使用 Docker Desktop/Linux 容器

镜像实际支持的 CPU 平台、宿主机资源和持久化目录

Linux 原生运行

二进制包

发布资产中的 x86_64 / arm64、libc 兼容性及校验值

修改内核或构建自己的版本

Linux 源码或macOS 源码

固定源码 tag/commit、Go、C/C++ 工具链和构建依赖

生产集群

集群部署

Operator/CRD、存储、资源、网络、备份和故障演练

v4.2.5 发布资产只有 Linux x86_64 和 arm64 ZIP,没有 musl 或原生 macOS 二进制包。不要拼接不存在的下载地址。源码 go.mod 要求 Go 1.26.4;旧版安装示例中的 1.22.x 不适用于构建 v4.2.5。其他版本检查其自身的 go.mod。

固定并核验版本

  • 保存 MatrixOne release/tag/commit;容器记录 tag、平台与拉取后的 digest,避免把浮动 latest 或 nightly 当作可重复的稳定版本。

  • 从正式发布页选择资产,核对发布元数据中的 SHA-256。下载成功与内容校验是两个步骤;本页未重新下载并运行两个平台的 ZIP。

  • 记录 mo_ctl 版本或安装脚本 commit;工具版本与数据库版本分别记录。不要把 mo_ctl 配置的 Go 检查版本当成已安装的 Go。

  • 二进制的 libc 要求与 Linux 内核版本是不同的条件。检查 uname -m、getconf GNU_LIBC_VERSION 和真实报错;不能靠“内核低于 5.0”推断应下载 musl 包。

一个持久化的 Docker 实验

仅在本地测试环境执行,确认 mo-install-lab 名称和端口 16011 未被占用。这里的 4 GiB/2 CPU 是轻量验收实验配额,不是生产容量或最低硬件认证。SQL 端口只绑定本机;调试端口不对外发布。

mkdir -p "$PWD/mo-install-data"
docker pull matrixorigin/matrixone:4.2.7
docker run -d --name mo-install-lab   --publish 127.0.0.1:16011:6001   --mount type=bind,src="$PWD/mo-install-data",dst=/mo-data   --memory 4g --cpus 2 matrixorigin/matrixone:4.2.7
docker inspect mo-install-lab --format '{{json .Mounts}}'
docker logs --tail 100 mo-install-lab
mysql -h 127.0.0.1 -P 16011 -u root -p

初始本地实验密码为 111。首次启动后重复连接检查,不用固定等待 20 秒作为就绪判断。以下 SQL 仅在刚创建的实验实例中执行:

SELECT VERSION();
-- Expected-Value: 1
SELECT 1;
CREATE DATABASE mo_install_lab;
USE mo_install_lab;
CREATE TABLE ledger(id INT PRIMARY KEY, amount INT);
INSERT INTO ledger VALUES(1,42);
-- Expected-Values: 1, 42
SELECT id,amount FROM ledger;

版本应与固定镜像一致。退出客户端后 docker restart mo-install-lab,重新连接并查询 mo_install_lab.ledger,预期仍为 (1,42)。随后可以在这个实验中停止并删除仅该容器,用相同镜像、固定 hostname 和挂载路径重新创建,再检查同一行;不删除数据目录,不同时让两个进程使用它。容器重建保留数据不等于备份。

Logservice 身份必须保留

默认 Docker hostname 随容器 ID 改变;容器名相同不代表 hostname 相同。v4.2.5 的 Logservice/Raft 目录包含 hostname。实测仅保留 /mo-data、不保留 hostname 时,重建后报 shard not bootstrapped;保留原 hostname 后启动并读到原数据。首次创建即固定 --hostname,后续与 UUID、配置和数据目录一起保留。已有实例先记录 docker inspect --format '{{.Config.Hostname}}' <容器名>;不要清空目录、改写 Raft 文件或创建新节点身份来“修复”。这种本地重建流程不适用于未经验证的集群迁移。

数据与配置边界

默认镜像入口是 /mo-service -debug-http=:12345 -launch /etc/quickstart/launch.toml;该 launch 文件引用 /etc/launch 下的服务配置。挂载数据时确认所有实际数据路径在持久化卷中;自定义配置从同一版本镜像复制并核对引用,见Docker 挂载说明。

首次初始化需要独立空目录;同版本重启或重建应保留已有目录。改变文件服务后端、升级版本或迁移路径需要独立验证,不能重新初始化或覆盖原数据。多个独立实例不能共享同一个本地数据目录。

v4.2.5 在 Linux/amd64 上无需 --privileged 即通过本页连接、写入、重启和重建实验;Docker 版本不匹配应先诊断运行时,不把特权模式作为通用解决办法。旧版源码或配置中的 UUID、相对路径与存储后端也不能不经检查复用。

验收清单与常见失败

检查

通过条件

不通过时先看

发布版本/架构

实际版本与选定资产一致

镜像平台、CPU、动态库、启动日志

TCP 与账号

从预期客户端完成认证

地址绑定、端口、防火墙、密码和租户

SQL 读写

临时库写入再查询一致

SQL 错误、权限、存储可写性、内存/磁盘

持久化

重启和实验容器重建后数据仍在

实际挂载、工作目录、配置中的数据路径

生产准备

独立账号、存储、备份及恢复演练已确认

生产部署前检查

默认账号只用于首次本地体验。接入业务前按密码管理修改初始密码,创建应用账号,配置访问与 TLS。不要把仅能启动的体验实例描述为已具备生产高可用。

验证范围:2026-10-14,官方 v4.2.5 Linux/amd64 镜像、单 CN、4 GiB/2 CPU;确认无特权启动、SQL 读写、重启和同挂载/同 hostname 重建;未固定 hostname 的重建实测失败。未验证原生 macOS/arm64、源码完整构建或生产集群容量。

上述源码/Docker 指南固定并校验安装脚本入口。安装器仍可能拉取其他组件;还需记录实际安装的 mo_ctl commit、依赖及镜像 digest,脚本校验不等于整条工具链已固定。