difi/oxalis

Oxalis镜像说明

镜像概述

Oxalis是泛欧公共采购在线（PEPPOL）接入点，最初由SendRegning开发，现由挪威公共管理和电子政务机构Difi维护。它基于PEPPOL样本实现增强，可作为独立PEPPOL解决方案或API组件嵌入自有系统，支持AS2协议收发文档，默认将入站消息持久化到文件系统（可自定义持久化方式）。

核心功能

Oxalis包含三个核心组件：

1. oxalis-inbound（war包）：运行在Tomcat上的入站接入点，通过AS2协议接收PEPPOL文档，默认存储为XML文件。
2. oxalis-outbound（jar包）：用于发送PEPPOL业务文档的组件，可集成到任意需要发送PEPPOL文档的系统。
3. oxalis-standalone（命令行工具）：发送PEPPOL文档的示例工具，支持批量发送文件。

使用场景

• 企业发送PEPPOL标准电子发票或其他业务文档。
• 接收来自PEPPOL网络合作伙伴的业务文档。
• 作为集成组件嵌入自有业务系统，实现PEPPOL文档交换能力。

配置说明

基础部署（Docker）

Docker Run示例

bash
docker run -d \
  -p 443:443 \
  -v /your/local/oxalis_home:/oxalis_home \
  -e OXALIS_HOME=/oxalis_home \
  difi/oxalis

说明：

• -v映射本地OXALIS_HOME目录，需包含oxalis.conf配置文件。
• -p映射HTTPS端口（默认443，若前端有SSL卸载可调整）。

关键配置步骤

1. 准备Tomcat环境（镜像内部可能已包含，若需外部部署需确保Tomcat支持SSL）。
2. 创建OXALIS_HOME目录并配置oxalis.conf。
3. 部署oxalis.war到Tomcat（或通过Docker镜像直接运行）。
4. 使用oxalis-standalone工具发送测试文档。

故障排除

• 握手失败：升级Oxalis到3.1.0+版本以兼容POODLE补丁服务器。
• TransformerFactoryImpl未找到：确保Oxalis与VEFA validator在不同JVM进程运行。
• PKIX路径错误：检查接收方SSL证书链是否完整。
• Tomcat空指针异常：升级Tomcat到较新版本。

安全配置

• oxalis/as2：开放互联网访问（HTTPS带有效证书）。
• oxalis/status：限制为内部访问（用于调试）。
• oxalis/statistics：仅允许DIFI收集统计数据（HTTPS带证书）。

源码构建（可选）

1. 安装Maven 3和JDK 8。
2. 拉取GitHub代码：git clone https://github.com/difi/oxalis.git。
3. 构建：mvn clean install -Pdist。
4. 生成的 artifacts位于oxalis-dist/oxalis-distribution/target/目录。