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:ltsmariadb: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-devbrew 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 MariaDB —
db.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.x | LTS,VECTOR GA,支持到 2028 | 仍在维护,要向量就用它 |
11.4.x | LTS,支持到 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-dev、sudo lsof -i :3306 检查。