安装选择与部署验收¶
本页以正式发布 v4.2.5 为验证基线(2026-10-14)。先选择用途和平台,再固定软件版本;安装完成的标准是能够连接、读写且重启后数据仍在,不只是进程或容器已启动。
选择安装方式¶
用途与平台 |
安装入口 |
需要确认 |
|---|---|---|
Linux/macOS 本地体验 |
Docker;macOS 使用 Docker Desktop/Linux 容器 |
镜像实际支持的 CPU 平台、宿主机资源和持久化目录 |
Linux 原生运行 |
发布资产中的 x86_64 / arm64、libc 兼容性及校验值 |
|
修改内核或构建自己的版本 |
固定源码 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,脚本校验不等于整条工具链已固定。