softproject/x4_server

X4 BPMS Docker镜像文档

镜像概述和主要用途

X4 BPMS是一个中央数字化平台，可在业务和技术层面实现业务流程数字化，连接人员、系统和设备，消除手动流程。该Docker镜像用于部署X4业务流程管理系统（X4 BPMS），其核心组件为X4 Server，集成了流程引擎、ESB、Web应用和控制中心等子组件，支持低代码业务流程建模与自动化。

核心功能和特性

X4 Server核心组件

X4 Server是X4 BPMS的核心元素，作为中央组件负责存储项目和业务流程，并通过集成的虚拟执行系统（Virtual Execution System）控制流程执行。X4 Server许可证包含以下子组件：

• X4 ESB（企业服务总线）
• X4 BPM（业务流程管理）
• X4 WebApp（Web应用）
• X4 Control Center（控制中心）

低代码建模：建模而非编程

通过X4 Designer（中央建模工具）实现直观建模，无需编程：

• 设计业务流程
• 定义业务规则
• 建模集成流程
• 配置适配器
• 映射数据模型
• 无需编程知识创建企业Web应用

X4 Designer下载

使用场景和适用范围

适用于需要快速实现业务流程数字化与自动化的企业，尤其是：

• 希望减少手动流程、提升效率的业务部门
• 需要集成多系统和设备但缺乏专业开发资源的团队
• 希望通过低代码平台快速构建和部署流程应用的组织

详细使用方法和配置说明

快速开始

从7.x版本开始，X4 Server需与Keycloak镜像配合使用以提供身份验证机制。推荐使用Docker Compose部署：

yaml
---
services:
  keycloak:
    image: softproject/keycloak
    container_name: keycloak_container
    hostname: keycloak.localhost
    ports:
      - "8085:8085"
    networks:
      - internal
    environment:
      - KEYCLOAK_ADMIN=admin
      - KEYCLOAK_ADMIN_PASSWORD=demo
  x4:
    image: softproject/x4_server
    container_name: x4_container
    hostname: x4.localhost
    volumes:
      - "./x4.license:/opt/X4/x4.license" # X4许可证绑定，需放置有效的许可证文件
      - "./configurations:/opt/X4/configurations" # Keycloak配置文件绑定
      - "./logs:/opt/X4/wildfly/standalone/log" # 日志目录绑定
      # - "./X4Config.xml:/opt/X4/X4config.xml" # X4配置文件绑定（启动前需准备文件）
      - "./deployments:/opt/X4/deployments" # 部署目录绑定（用于添加x4apps）
      - "./X4DB/1:/opt/X4/X4DB/1" # 项目数据绑定
    ports:
      - "8080:8080"
    depends_on:
        - keycloak
    networks:
        - internal
networks:
    internal:

Keycloak集成配置

需在/opt/X4/configurations目录下创建keycloak_config.json配置文件（通过卷挂载实现），内容示例：

json
{
  "connection": {
    "realm": "X4Realm",
    "auth-server-url": "http://keycloak:8085/auth/",
    "resource": "X4",
    "credentials": {
      "secret": "60304a13-8fa6-4899-94a2-0c10562768ec"
    }
  }
}

注意：7.2及以上版本无需包含"rest-api-credentials"配置段。

修改Keycloak密钥

为增强安全性，需修改默认密钥：

1. 登录Keycloak管理控制台
2. 导航至"Realm Settings"（领域设置）
3. 选择目标领域
4. 进入"Credentials"（凭据）选项卡
5. 点击"RSA"或"ECDSA"更新密钥

环境变量配置

默认使用H2数据库，可通过以下环境变量配置其他数据库：

注意：切换数据库时需确保已通过迁移工具准备好数据库，迁移工具可从Update Tool下载。

完整Docker Compose示例（含PostgreSQL）

以下示例集成Keycloak、PostgreSQL和X4 Server：

yaml
---
services:
  keycloak:
    image: softproject/keycloak
    container_name: keycloak_container
    hostname: keycloak.localhost
    ports:
      - "8085:8085"
    networks:
      - internal
    environment:
      - KEYCLOAK_ADMIN=admin
      - KEYCLOAK_ADMIN_PASSWORD=demo

  postgres_db:
    image: postgres:latest
    container_name: postgres_container
    hostname: postgres_db # 同一网络内可通过主机名访问
    environment:
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=postgres
      - POSTGRES_DB=X4
    ports:
      - "5432:5432"
    networks:
      - internal
    volumes:
      - ./postgres_data:/var/lib/postgresql/data # 数据库数据持久化

  x4:
    image: softproject/x4_server
    container_name: x4_container
    hostname: x4.localhost
    environment:
      - DATABASE_MODE=postgresql
      - DATABASE_USER=postgres
      - DATABASE_PASSWORD=postgres
      - DATABASE_HOST=postgres_db
      - DATABASE_PORT=5432
    volumes:
      - "./x4.license:/opt/X4/x4.license" # X4许可证绑定
      - "./configurations:/opt/X4/configurations" # Keycloak配置绑定
      - "./logs:/opt/X4/wildfly/standalone/log" # 日志目录绑定
      - "./X4Config.xml:/opt/X4/X4config.xml" # X4配置文件绑定
      - "./deployments:/opt/X4/deployments" # 部署目录绑定
      - "./X4DB/1:/opt/X4/X4DB/1" # 项目数据绑定
    ports:
      - "8080:8080"
    depends_on:
        - keycloak
        - postgres_db
    networks:
        - internal
networks:
    internal:

系统要求

系统要求详情

申请试用版

免费使用X4 BPMS完整功能30天，体验流程自动化的便捷性：

申请试用版

联系我们

如需了解更多产品和服务信息：

联系我们，我们将竭诚为您提供帮助。

更多链接

• 下载中心
• 官方文档