phoss SMP Server 镜像文档

镜像概述

phoss SMP Server是一个符合Peppol和OASIS BDXR国际标准的服务元数据发布（SMP）服务器。该镜像集成SQL后端存储，专注于电子数据交换（EDI）场景下服务元数据的管理、存储与发布，为交易伙伴提供标准化的服务信息发现机制。

核心功能和特性

标准兼容性

• 全面支持Peppol SMP规范（EN 16931-3）
• 兼容OASIS BDXR SMP v1.0标准，满足跨行业电子数据交换需求

数据存储与管理

• 基于SQL后端的元数据持久化存储，支持主流关系型数据库（如PostgreSQL、MySQL等）
• 提供服务元数据的完整生命周期管理（创建、更新、查询、删除）

接口与集成能力

• 内置RESTful API接口，支持程序化元数据管理
• 兼容标准SMP客户端协议，确保交易伙伴可通过标准化方式查询服务信息

使用场景和适用范围

典型应用场景

• 企业间电子数据交换（EDI）系统的服务元数据中枢
• 跨境贸易、供应链管理等需标准化服务发现的业务场景
• 政府或行业电子政务平台中服务提供方的元数据统一管理

目标用户群体

• 电子数据交换服务提供商
• 参与Peppol或OASIS BDXR生态系统的企业组织
• 需要管理多交易伙伴服务信息的大型企业及政府机构

使用方法和配置说明

基础部署（Docker Run）

通过以下命令快速启动容器，需提前配置外部SQL数据库：

docker run -d \
  --name phoss-smp-server \
  -p 8080:8080 \
  -e DB_TYPE=postgresql \
  -e DB_HOST=your-db-host \
  -e DB_PORT=5432 \
  -e DB_NAME=smp_metadata \
  -e DB_USER=smp_admin \
  -e DB_PASSWORD=your-secure-password \
  phoss/smp-server:latest

参数说明：

• -p 8080:8080：端口映射，将容器8080端口映射至主机，用于Web访问和API通信
• 环境变量配置：
  • DB_TYPE：数据库类型（支持postgresql、mysql等）
  • DB_HOST：数据库服务器地址
  • DB_PORT：数据库服务端口
  • DB_NAME：元数据存储数据库名称
  • DB_USER：数据库访问用户名
  • DB_PASSWORD：数据库访问密码

Docker Compose部署示例

创建docker-compose.yml文件，集成SMP服务器与PostgreSQL数据库：

version: '3.8'
services:
  smp-server:
    image: phoss/smp-server:latest
    container_name: smp-server
    ports:
      - "8080:8080"
    environment:
      - DB_TYPE=postgresql
      - DB_HOST=postgres-db
      - DB_PORT=5432
      - DB_NAME=smp_db
      - DB_USER=smp_user
      - DB_PASSWORD=smp_passwd
    depends_on:
      - postgres-db
    restart: unless-stopped

  postgres-db:
    image: postgres:14-alpine
    container_name: smp-postgres
    environment:
      - POSTGRES_DB=smp_db
      - POSTGRES_USER=smp_user
      - POSTGRES_PASSWORD=smp_passwd
    volumes:
      - postgres-data:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  postgres-data:

启动命令：docker-compose up -d

高级配置（自定义配置文件）

如需精细化配置，可通过挂载配置文件目录实现：

docker run -d \
  --name phoss-smp-server \
  -p 8080:8080 \
  -v /host/path/to/config:/opt/smp-server/config \
  phoss/smp-server:latest

注：宿主机目录/host/path/to/config需包含服务器配置文件（如application.properties），配置项参考官方文档。

访问与验证

容器启动后，通过以下方式访问服务：

• Web管理界面：http://<host-ip>:8080
• API接口：http://<host-ip>:8080/api/v1/metadata

注意事项

• 生产环境需确保数据库高可用性，建议使用数据库集群或主从架构
• 建议通过反向代理（如Nginx）配置HTTPS加密，增强数据传输安全性
• 首次启动前需确认数据库已完成初始化，且容器网络可正常访问数据库服务