ESP32 新手入门：40 元 1 小时，让 Arduino 开发板连上 WiFi 还能被浏览器访问
2026/9/11 4:51:52
如何十分钟跑起 OpenMetadata？Docker 本地部署完全指南
【免费下载链接】OpenMetadataThe Open Context Layer for Data and AI , OpenMetadata is the open platform for building trusted data context and business semantics for humans, AI assistants, and agents.项目地址: https://gitcode.com/GitHub_Trending/op/OpenMetadata
OpenMetadata 是一个开源的元数据管理平台，帮你把散落在各处数据库、BI、数据湖里的资产信息统一收集、管理起来，方便探索和分析。想在本地快速搭一套试试？用 Docker 是最省事的方式：不用自己装数据库、搜索引擎，一条命令把整套服务拉起来即可。下面按「环境自检 → 一键部署 → 验证访问 → 日常维护」四个环节走一遍。
部署前环境自检
开始之前，先对照下面的清单确认你的机器是否满足条件：
| 检查项 | 要求 | 说明 |
|---|---|---|
| 操作系统 | macOS / Linux / Windows | Windows 需先装好 WSL2 |
| Docker | 20.10.0 及以上 | 运行docker --version核对 |
| Docker Compose | v2.1.1 及以上 | 运行docker compose version核对 |
| 硬件资源 | 至少 6 GiB 内存 + 4 个 vCPU | 建议按这个规格给 Docker 分配 |
⚠️ Windows 用户必须走 WSL2：先安装 WSL2 和 Ubuntu 22.04 LTS，再装 Docker Desktop for Windows；然后在 Ubuntu 里执行sudo apt install python3-pip python3-venv补齐 Python 环境。
自检只有两条命令：
docker --version docker compose version两个版本号都达标，就可以继续了。
获取对应的 Compose 编排文件
OpenMetadata 提供 MySQL 和 PostgreSQL 两套数据库方案，各有一份对应的编排文件，按需下载其一即可：
# 默认 MySQL 版 curl -sL -o docker-compose.yml https://下载地址/docker-compose.yml # PostgreSQL 版 curl -sL -o docker-compose-postgres.yml https://下载地址/docker-compose-postgres.yml不确定选哪个？先用 MySQL 默认版，体验上没有差别。 需要参考编排内容本身，可以查看仓库里的 docker/docker-compose-quickstart/docker-compose.yml、docker/docker-compose-quickstart/docker-compose-postgres.yml，数据库初始化脚本在 docker/mysql/ 和 docker/postgresql/。
一键启动整套服务
拿到文件后，在文件所在目录执行：
# MySQL 版 docker compose -f docker-compose.yml up --detach # PostgreSQL 版 docker compose -f docker-compose-postgres.yml up --detach--detach表示后台运行。启动过程需要一两分钟：OpenMetadata 会自动建库、建表、建索引并完成初始化，不用手动干预。
稍等片刻用docker ps看一眼，确认这些容器都处于运行状态：
| 容器名 | 作用 |
|---|---|
| openmetadata_server | OpenMetadata 主服务 |
| openmetadata_ingestion | Airflow 摄取工作流 |
| openmetadata_mysql | 元数据存储（MySQL 版） |
| openmetadata_elasticsearch | 全文搜索索引 |
首次登录与端口账号速查
一切就绪后，浏览器直接访问http://localhost:8585，用管理员账号登录：
| 服务 | 访问地址 | 默认账号 | 默认密码 |
|---|---|---|---|
| OpenMetadata UI | http://localhost:8585 | admin@open-metadata.org | admin |
| Airflow UI | http://localhost:8080 | admin | admin |
登录成功后你会看到资产探索页面，表、血缘、标签等元数据都在这里呈现：
想换 Airflow 的管理员账号？在启动前设置环境变量AIRFLOW_ADMIN_USER和AIRFLOW_ADMIN_PASSWORD即可。
日常运维命令速查
日常停停启启，只需要记住这几个动作：
| 场景 | 命令 |
|---|---|
| 暂停服务（保留数据） | docker compose stop |
| 恢复服务 | docker compose start |
| 删除容器（保留数据卷） | docker compose down |
| 彻底重置（连数据卷一起删） | docker compose down --volumes |
故障速查
| 现象 | 可能原因 | 处理 |
|---|---|---|
| 提示 "compose" 不是 docker 命令 | 没装 Compose V2 插件 | 单独安装 Docker Compose V2 后重试 |
| 网络创建报错 | 本地残留了未清理的 Docker 网络 | 执行docker network prune，注意这会清掉所有未使用的自定义网络 |
| Windows 下文件挂载异常 | WSL2 挂载选项不正确 | 在/etc/wsl.conf中加入[automount]段和options = "metadata,case=force"，重启 WSL2 生效 |
部署完成，接下来做什么
以上四步走完，一套可用的 OpenMetadata 就在本地跑起来了。⚠️ 再啰嗦一句：这是本地开发环境的配置，等要上生产之前，记得改掉默认管理员密码、配置 HTTPS，并设好访问控制，别把默认账号带出去。
接下来你可以：
- 在 UI 里浏览各类数据资产，熟悉平台功能；
- 接入自己的数据源，体验元数据自动摄取；
- 通过 REST API 做二次开发和扩展；
- 配置自动化的摄取工作流，让元数据持续保鲜。
【免费下载链接】OpenMetadataThe Open Context Layer for Data and AI , OpenMetadata is the open platform for building trusted data context and business semantics for humans, AI assistants, and agents.项目地址: https://gitcode.com/GitHub_Trending/op/OpenMetadata
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考