sdmxio/fmr-mysql

Fusion Metadata Registry (内置 MySQL)

镜像概述

本镜像是 Fusion Metadata Registry (FMR) 的单镜像部署版本，内置了 MySQL 数据库。FMR 是一款免费使用的 SDMX 结构元数据注册中心、数据建模平台以及数据处理引擎，专为官方统计数据的生产者、收集者和报告者设计。

注意：对于大多数正式的生产环境部署，建议使用分离数据库的镜像 sdmxio/fmr。

核心功能与特性

1. 元数据注册中心：作为 SDMX 结构元数据的受控存储库，为自动化元数据驱动的数据处理系统提供单一真实数据源，支持数据收集、标准化和统计数据协调，实现 SDMX Registry 规范。
2. 数据处理服务：提供三种集成的元数据驱动数据处理服务：数据验证、数据转换（跨结构映射）以及 SDMX 数据传输格式之间的转换。支持通过 Web UI 交互或通过 REST API 集成到自动化流程中。
3. 元数据编写与维护：提供交互式 Web 用户界面，协助元数据管理员浏览、编写和维护其结构元数据模型。
4. 数据建模：使用 SDMX 元模型对数据域进行交互式建模。

版本特性支持

Version 11 支持：

• SDMX 2.0、2.1 和 3.0
• SDMX-ML (XML) 2.0、2.1 和 3.0 数据与结构传输格式
• SDMX-JSON 1 和 2 数据与结构传输格式
• SDMX-CSV 1 和 2 数据与结构传输格式

Version 12 新增特性：

• 语义版本控制 (Semantic versioning)
• 元数据时间旅行 (Metadata time travel)
• OIDC / SSO 身份验证
• 通过改进内存管理支持大型元数据
• 支持从 FMR 11 进行内容迁移

使用场景

本内置数据库的独立镜像主要适用于以下场景：

• 轻量级的临时生产工作负载
• 个人使用（如桌面数据建模、数据验证和映射）
• 能力建设与培训练习
• 系统测试与评估

前置条件

必需

• 无（镜像已内置 MySQL 数据库，开箱即用）

可选（针对高级或外部集成配置）

• 独立的 SQL 数据库服务（MySQL 5.7+、SQL Server 或 Oracle），需预先配置专用 Schema 供 FMR 持久化元数据。
• 目录服务（Active Directory 或 LDAP）

部署与使用方法

快速启动 (Docker Run)

下载镜像并启动名为 fmr 的容器：

shell
docker run --name fmr -p 8080:8080 docker.xuanyuan.run/sdmxio/fmr-mysql:latest

启动后，请在浏览器中访问 http://localhost:8080/。 注意：容器初次启动需要 1 到 2 分钟的时间来初始化数据库，请耐心等待。

默认管理员账户：

• 用户名：root
• 密码：password

登录系统后，即可管理、创建、加载和维护 SDMX 结构。

停止容器：

shell
docker stop fmr

Docker Compose 部署示例

如果您偏好使用 Docker Compose 进行编排，可以参考以下 docker-compose.yml 配置：

yaml
version: '3.8'

services:
  fmr:
    image: docker.xuanyuan.run/sdmxio/fmr-mysql:latest
    container_name: fmr
    ports:
      - "8080:8080"
    environment:
      - SERVER_URL=http://localhost:8080
    restart: unless-stopped

启动服务：

shell
docker-compose up -d

配置说明

环境变量

修改服务器 URL 示例： 如果服务将通过 https://fmr.mydomain.org:8080 对外发布，请在创建容器时设置 SERVER_URL 环境变量：

shell
docker container create --name fmr \
  --publish 8080:8080 \
  -e SERVER_URL=https://fmr.mydomain.org:8080 \
  sdmxio/fmr-mysql:latest
  
docker start fmr

故障排除

Windows 环境下容器启动失败或高负载下崩溃： 这通常是由于分配给 Docker 的内存资源不足导致的。在 Windows 的 Docker Desktop 中，默认内存限制可能为 2GB，这对于运行 FMR 是不够的。 解决方法：打开 Docker Desktop 设置，进入 Resources -> Advanced，将内存（Memory）限制增加到至少 4GB。

许可证与更多信息

• Web 应用程序：Public License Agreement
• 源代码：Apache 2.0
• 版权：Copyright Bank for International Settlements 2025 all rights reserved. (使用本软件即表示您同意许可条款)

Fusion Metadata Registry 是 sdmx.io 开源软件生态系统的一部分，由 BIS Open Tech 发布，旨在促进国际合作，分享统计和***软件作为公共产品。

• 官方文档与 Wiki：FMR Wiki
• 社区论坛：SDMX User Forum (LinkedIn)
• 技术支持***：***