phelger/phoss-smp-mongodb Docker 镜像 - 轩辕镜像

phoss SMP服务器镜像文档

镜像概述

phoss SMP服务器镜像是一个预配置的Docker镜像，用于快速部署符合PEPPOL（泛欧公共采购在线）和OASIS BDXR（业务文档交换）标准的SMP（服务元数据发布）服务器。该镜像采用MongoDB作为后端存储，提供高效、可扩展的服务元数据管理能力，适用于电子数据交换（EDI）场景中服务元数据的发布、查询和维护。

核心功能和特性

标准支持

• 完全兼容PEPPOL SMP规范（基于OASIS BDXR SMP v1.0和v2.0标准）
• 支持OASIS BDXR业务文档交换框架的元数据发布要求

后端存储

• 集成MongoDB作为主数据存储，提供高可用性和水平扩展能力
• 支持MongoDB副本集配置，确保数据冗余和故障恢复

元数据管理

• 支持服务组（Service Group）、服务元数据（Service Metadata）的创建、查询、更新和删除
• 提供元数据版本控制和历史记录追踪
• 支持数字签名的元数据发布，确保数据完整性和真实性

接口与集成

• 提供RESTful API接口，支持程序化管理元数据
• 兼容PEPPOL网络中的SML（服务元数据定位器）集成
• 支持HTTP/HTTPS协议，确保数据传输安全

可配置性

• 通过环境变量和配置文件灵活调整服务器参数
• 支持自定义日志级别、存储路径和网络配置
• 可扩展的插件架构，支持功能定制

使用场景和适用范围

适用场景

• 电子数据交换（EDI）平台的服务元数据管理
• 供应链系统中交易伙伴的服务信息发布
• ***或公共部门电子采购（如PEPPOL网络）中的元数据注册
• 企业间B2B通信的服务端点发现与管理

适用用户

• EDI服务提供商
• 供应链管理系统开发者
• 参与PEPPOL网络的公共或私营组织
• 需要管理跨组织服务元数据的IT团队

使用方法和配置说明

前提条件

• Docker Engine 19.03+
• Docker Compose（可选，用于多容器部署）
• 可访问的MongoDB实例（独立部署或容器化部署）

Docker快速部署

基本运行命令

bash
docker run -d \
  --name phoss-smp \
  -p 8080:8080 \
  -e MONGODB_URI="mongodb://mongo-host:27017/smp" \
  -e SERVER_PORT=8080 \
  -e LOG_LEVEL=INFO \
  phoss/smp-server:latest

参数说明

• -p 8080:8080: 将容器内8080端口映射到主机8080端口（默认HTTP端口）
• MONGODB_URI: MongoDB连接URI，格式为mongodb://<host>:<port>/<database>
• SERVER_PORT: 服务器监听端口（容器内端口）
• LOG_LEVEL: 日志级别，可选值：DEBUG, INFO, WARN, ERROR

启用HTTPS的部署示例

bash
docker run -d \
  --name phoss-smp-ssl \
  -p 443:8443 \
  -e MONGODB_URI="mongodb://mongo-host:27017/smp" \
  -e SERVER_PORT=8443 \
  -e ENABLE_SSL=true \
  -e SSL_KEYSTORE_PATH="/etc/smp/ssl/keystore.jks" \
  -e SSL_KEYSTORE_PASSWORD="changeit" \
  -v /host/path/to/ssl:/etc/smp/ssl \
  phoss/smp-server:latest

Docker Compose部署（推荐）

docker-compose.yml示例

yaml
version: '3.8'

services:
  smp:
    image: phoss/smp-server:latest
    container_name: phoss-smp
    ports:
      - "8080:8080"
      - "8443:8443"
    environment:
      - MONGODB_URI=mongodb://mongo:27017/smp
      - SERVER_PORT=8080
      - ENABLE_SSL=true
      - SSL_KEYSTORE_PATH=/etc/smp/ssl/keystore.jks
      - SSL_KEYSTORE_PASSWORD=changeit
      - LOG_LEVEL=INFO
    volumes:
      - ./ssl:/etc/smp/ssl
      - smp-data:/var/lib/smp
    depends_on:
      - mongo
    restart: unless-stopped

  mongo:
    image: mongo:5.0
    container_name: smp-mongo
    ports:
      - "27017:27017"
    volumes:
      - mongo-data:/data/db
    restart: unless-stopped

volumes:
  smp-data:
  mongo-data:

启动服务：

bash
docker-compose up -d

配置参数详解

核心环境变量

持久化配置

建议通过数据卷挂载持久化以下目录：

• /var/lib/smp: 服务器运行时数据
• /etc/smp/conf: 自定义配置文件（如需覆盖默认配置）
• /etc/smp/ssl: SSL证书和密钥文件

验证部署

部署完成后，可通过以下方式验证服务状态：

1. 访问HTTP端点：http://<host>:8080/smp/health，返回UP表示服务正常
2. 访问SMP管理界面：http://<host>:8080/smp/admin（默认管理员账号需参考官方文档配置）

进阶配置

如需自定义服务器行为，可挂载配置文件到容器内/etc/smp/conf目录，覆盖默认配置。详细配置项请参考phoss SMP官方文档。

注意事项

• 生产环境中必须启用HTTPS并使用有效的SSL证书
• MongoDB建议配置副本集以确保数据高可用
• 定期备份MongoDB数据，防止元数据丢失
• 根据访问量调整服务器资源（CPU/内存）配置，推荐最低2GB内存

参考链接

• phoss SMP官方文档
• PEPPOL SMP规范
• OASIS BDXR SMP标准
• MongoDB官方文档