MariaDB 中文社区

5 分钟快速开始

Docker / Homebrew / 云上一键拉起 MariaDB 的三条最短路径

无论你是想在本地开发、还是直接在云上试一试,这一页都能让你在 5 分钟内连上一个真实可用的 MariaDB。

选一条路

跨平台,几乎没有副作用,强烈推荐新手用这条

启动一个临时实例

docker run -d --name mariadb-dev \
  -e MARIADB_ROOT_PASSWORD=devpass \
  -e MARIADB_DATABASE=playground \
  -p 3306:3306 \
  mariadb:lts

mariadb:lts 始终指向最新 LTS(当前 12.3)。想锁定版本就写 11.8(含 VECTOR)或 11.4。注意 Docker 的 latest 现在也指向最新稳定版(即 12.3),并不是"滚动主线"专用 tag。

连进去

docker exec -it mariadb-dev mariadb -uroot -pdevpass playground

进入交互式 SQL shell 后试一下:

SELECT VERSION();
CREATE TABLE hello (id INT, msg VARCHAR(64));
INSERT INTO hello VALUES (1, '你好 MariaDB');
SELECT * FROM hello;

清理

docker rm -f mariadb-dev
brew install mariadb
brew services start mariadb
mariadb -u root

第一次启动后建议跑一次安全初始化:

sudo mariadb-secure-installation

以 Ubuntu 24.04 为例,从 MariaDB 官方仓库装最新 LTS:

sudo apt update
sudo apt install -y apt-transport-https curl
sudo curl -o /etc/apt/keyrings/mariadb-keyring.pgp \
  https://mariadb.org/mariadb_release_signing_key.pgp
echo "deb [signed-by=/etc/apt/keyrings/mariadb-keyring.pgp] \
  https://deb.mariadb.org/12.3/ubuntu noble main" \
  | sudo tee /etc/apt/sources.list.d/mariadb.sources
sudo apt update
sudo apt install -y mariadb-server
sudo mariadb-secure-installation

不想动本地环境?直接在云上拉一个最便宜的实例:

  • AWS RDS for MariaDBdb.t4g.micro,按需付费
  • 阿里云 RDS for MariaDB — 可买"基础版"几十块/月
  • 腾讯云 TencentDB for MariaDB — 兼容 MySQL 协议,国内访问快
  • MariaDB SkySQL — 官方托管,有免费 trial

详细对照见 云上 MariaDB

你刚刚装的是哪个版本?

SELECT VERSION();
-- 比如返回:11.4.4-MariaDB
你看到的版本是什么建议
12.3.x最新 LTS(2026-05)生产首选
11.8.xLTS,VECTOR GA,支持到 2028仍在维护,要向量就用它
11.4.xLTS,支持到 2029(最后一批 5 年支持)稳妥老项目
12.2.x / 12.1.x / 12.0.x旧滚动主线,已 EOL已被 12.3 取代,别新建
10.11.x上一代 LTS老项目维护用
10.6.x 及以下已 EOL 或临近 EOL(10.6 → 2026-07)尽快升级

详见 版本与分支

给 AI 助手用?

如果你用 Cursor / Claude Code / Windsurf 之类的 Agent,下一步去看 给 AI 开发者——里面有 schema 命名、MCP 接入和让 Agent 安全写库的范式。

遇到 Can't connect / Access denied
99% 是端口被占 / 密码不对 / 防火墙拦了。先 docker logs mariadb-devsudo lsof -i :3306 检查。

本页目录