advantys/workflowgen

WorkflowGen - 业务流程自动化平台

该镜像包含使用IIS和WorkflowGen Windows服务的WorkflowGen服务器。可通过此镜像运行WorkflowGen Web应用、Windows服务或同时运行两者。

⚠️ 平台与数据库支持

WorkflowGen应用： 仅支持Windows容器（所有版本）

生产环境数据库选项：

开发/测试环境数据库选项：

🚨 重要 - 生产环境部署

生产就绪组合：

• ✅ v10：WorkflowGen Windows容器 + https://hub.docker.com/r/advantys/workflowgen-postgres%EF%BC%88Windows%E6%88%96Linux%EF%BC%89
• ✅ v9.3.1：WorkflowGen Windows容器 + https://hub.docker.com/r/advantys/workflowgen-sql
• ✅ v9.3.0及更早：WorkflowGen Windows容器 + https://hub.docker.com/r/advantys/workflowgen-sql
• ✅ v8：WorkflowGen Windows容器 + https://hub.docker.com/r/advantys/workflowgen-sql

混合部署（WorkflowGen Windows容器 + 数据库Linux容器）完全支持生产环境。

数据库详情参见 https://hub.docker.com/r/advantys/workflowgen-sql 和 https://hub.docker.com/r/advantys/workflowgen-postgres%E3%80%82

---

可用标签

最新Dockerfile：

• https://github.com/advantys/workflowgen-docker/blob/master/10.0/windows/windowsservercore-ltsc2019/Dockerfile
• https://github.com/advantys/workflowgen-docker/blob/master/10.0/windows/windowsservercore-ltsc2019/onbuild/Dockerfile
• https://github.com/advantys/workflowgen-docker/blob/master/9.3/windows/windowsservercore-ltsc2019/Dockerfile
• https://github.com/advantys/workflowgen-docker/blob/master/9.3/windows/windowsservercore-ltsc2019/onbuild/Dockerfile

示例标签：

• 10.0.3-win-ltsc2019 - WorkflowGen v10.0.3
• 9.3.1-win-ltsc2019 - WorkflowGen v9.3.1
• 8.3.5-win-ltsc2019 - WorkflowGen v8.3.5
• latest - 最新版本
• -onbuild 后缀 - 可自定义变体

---

环境要求

1. Windows Server 2019 LTSC 或 Windows 10 Pro（需启用Hyper-V）
   • 安装 Docker for Windows 并切换至Windows容器模式
2. 使用与镜像标签匹配的Windows Server版本
   • 示例：Windows Server 2019（1809）搭配 10.0.3-win-ltsc2019
3. WorkflowGen 许可证，需复制到 C:\wfgen\licenses 卷
4. 序列号，通过 WFGEN_APP_SETTING_ApplicationSerialNumber 环境变量设置
5. 数据库：v10使用PostgreSQL（推荐）或SQL Server 2025（预览版）；v9/v8使用SQL Server

---

运行容器

运行前，确保数据库已通过提供的SQL脚本初始化。

powershell
docker run -it --env-file .\workflowgen.env -v C:\path\to\licenses:C:\wfgen\licenses --name wfgen advantys/workflowgen:{version}-win-ltsc2019

将 {version} 替换为实际版本（如 10.0.3、9.3.1）。

---

Docker Compose快速部署

v10搭配PostgreSQL（生产就绪）✅

前置操作：

powershell
# 创建卷
docker volume create licenses
docker volume create wfgdata
docker volume create pgdata

# 复制许可证
$licensesPath = docker volume inspect --format "{{.Mountpoint}}" licenses
Copy-Item ~\Desktop\license.lic $licensesPath

# 生成对称加密密钥（32字符）
[guid]::NewGuid().ToString("N")
# 示例：ca8e4e2b04254aeeadbcfc0724e3b62a

docker-compose.yml：

yaml
services:
  workflowgen:
    image: advantys/workflowgen:10.0.3-win-ltsc2019
    depends_on:
      - database
    environment:
      - WFGEN_DATABASE_CONNECTION_STRING=Host=database;Port=5432;Database=wfgen;Username=wfgen_user;Password=yourStrong(!)Password;
      - WFGEN_DATABASE_CONNECTION_STRING_PROVIDER_NAME=Npgsql
      - WFGEN_APP_SETTING_ApplicationUrl=http://localhost:8888/wfgen
      - WFGEN_APP_SETTING_ApplicationSerialNumber=YOUR_WORKFLOWGEN_SERIAL_NUMBER
      - WFGEN_APP_SETTING_ApplicationSecurityPasswordSymmetricEncryptionKey=ca8e4e2b04254aeeadbcfc0724e3b62a
    ports:
      - 8888:80
    volumes:
      - licenses:C:\wfgen\licenses:RO
      - wfgdata:C:\wfgen\data
  database:
    image: advantys/workflowgen-postgres:10.0.3-postgres-win-ltsc2019
    container_name: database
    environment:
      - PGDATA=C:\wfgen\postgres
      - POSTGRES_INITDB_ARGS=--username=postgres
      - POSTGRES_PASSWORD=yourStrong(!)Password
      - WFGEN_DATABASE_USER_PASSWORD=yourStrong(!)Password
      - WFGEN_ADMIN_PASSWORD=yourStrong(!)Password
    volumes:
      - pgdata:C:\wfgen\postgres
    ports:
      - 5432:5432

volumes:
  licenses:
    external: true
  wfgdata:
  pgdata:

启动：

powershell
docker compose up -d

访问： http://localhost:8888/wfgen（用户名：`wfgen_admin`，密码：`yourStrong(!)Password`）

---

v9搭配SQL Server（开发/测试）⚠️

前置操作：

powershell
# 创建卷
docker volume create licenses
docker volume create wfgdata
docker volume create sqldata

# 复制许可证
$licensesPath = docker volume inspect --format "{{.Mountpoint}}" licenses
Copy-Item ~\Desktop\license.lic $licensesPath

# 生成对称加密密钥
[guid]::NewGuid().ToString("N")
# 示例：ca8e4e2b04254aeeadbcfc0724e3b62a

docker-compose.yml：

yaml
services:
  workflowgen:
    image: advantys/workflowgen:9.3.1-win-ltsc2019
    depends_on:
      - database
    environment:
      - WFGEN_DATABASE_CONNECTION_STRING=Data Source=database;Network Library=DBMSSOCN;Initial Catalog=WFGEN;User ID=WFGEN_USER;Password=yourStrong(!)Password;
      - WFGEN_APP_SETTING_ApplicationUrl=http://localhost:8888/wfgen
      - WFGEN_APP_SETTING_ApplicationSerialNumber=YOUR_WORKFLOWGEN_SERIAL_NUMBER
      - WFGEN_APP_SETTING_ApplicationSecurityPasswordSymmetricEncryptionKey=ca8e4e2b04254aeeadbcfc0724e3b62a
    ports:
      - 8888:80
    volumes:
      - licenses:C:\wfgen\licenses:RO
      - wfgdata:C:\wfgen\data
  database:
    image: advantys/workflowgen-sql:9.3.1-express-win-ltsc2019
    container_name: database
    environment:
      - ACCEPT_EULA=Y
      - SA_PASSWORD=yourStrong(!)Password
      - WFGEN_DATABASE_USER_PASSWORD=yourStrong(!)Password
      - WFGEN_ADMIN_PASSWORD=yourStrong(!)Password
    volumes:
      - sqldata:C:\wfgen\sql
    ports:
      - 1433:1433

volumes:
  licenses:
    external: true
  wfgdata:
  sqldata:

启动：

powershell
docker compose up -d

访问： http://localhost:8888/wfgen（用户名：`wfgen_admin`，密码：`yourStrong(!)Password`）

---

v10搭配Linux PostgreSQL（仅数据库 - 生产就绪）✅

docker-compose.yml：

yaml
services:
  database:
    image: advantys/workflowgen-postgres:10.0.3-postgres-debian-bookworm
    container_name: database
    environment:
      - PGDATA=/var/lib/postgresql/data
      - POSTGRES_INITDB_ARGS=--username=postgres
      - POSTGRES_PASSWORD=yourStrong(!)Password
      - WFGEN_DATABASE_USER_PASSWORD=yourStrong(!)Password
      - WFGEN_ADMIN_PASSWORD=yourStrong(!)Password
    volumes:
      - pgdata:/var/lib/postgresql/data
    ports:
      - 5432:5432

volumes:
  pgdata:

WorkflowGen连接字符串：

ini
WFGEN_DATABASE_CONNECTION_STRING=Host=database;Port=5432;Database=wfgen;Username=wfgen_user;Password=yourStrong(!)Password;
WFGEN_DATABASE_CONNECTION_STRING_PROVIDER_NAME=Npgsql

---

v10搭配Linux SQL Server 2025（仅数据库 - 开发/测试）⚠️

⚠️ 不用于生产 - SQL Server 2025为预览版。生产环境请使用PostgreSQL。

docker-compose.yml：

yaml
services:
  database:
    image: advantys/workflowgen-sql:10.0.3-ubuntu-24.04
    container_name: database
    environment:
      - ACCEPT_EULA=Y
      - SA_PASSWORD=yourStrong(!)Password
      - WFGEN_DATABASE_USER_PASSWORD=yourStrong(!)Password
      - WFGEN_ADMIN_PASSWORD=yourStrong(!)Password
    volumes:
      - sqldata:/var/opt/mssql
    ports:
      - 1433:1433

volumes:
  sqldata:

WorkflowGen连接字符串：

ini
WFGEN_DATABASE_CONNECTION_STRING=Data Source=database;Initial Catalog=WFGEN;User ID=WFGEN_USER;Password=yourStrong(!)Password;TrustServerCertificate=True

---

配置说明

数据库连接字符串

v10：PostgreSQL（生产推荐）

ini
WFGEN_DATABASE_CONNECTION_STRING=Host=database;Port=5432;Database=wfgen;Username=wfgen_user;Password=<password>;
WFGEN_DATABASE_CONNECTION_STRING_PROVIDER_NAME=Npgsql

v10：SQL Server 2025（仅开发/测试）

ini
WFGEN_DATABASE_CONNECTION_STRING=Data Source=database;Initial Catalog=WFGEN;User ID=WFGEN_USER;Password=<password>;TrustServerCertificate=True

注意：SQL Server提供程序默认为System.Data.SqlClient，无需额外指定。

v9、v8：SQL Server

ini
WFGEN_DATABASE_CONNECTION_STRING=Data Source=database;Network Library=DBMSSOCN;Initial Catalog=WFGEN;User ID=WFGEN_USER;Password=<password>;

注意：

• Network Library=DBMSSOCN强制使用TCP/IP协议（容器必需）
• 生产环境：使用Linux SQL Server容器（v9.3.1对应SQL Server 2022，v8/v9.3.0及更早对应SQL Server 2019）
• 开发/测试：使用Windows SQL Server Express 2017容器

web.config配置

通过环境变量配置web.config设置：WFGEN_APP_SETTING_<name>

示例：

ini
WFGEN_APP_SETTING_ApplicationUrl=https://example.com/wfgen

iisnode配置（Node应用）

配置IISNode：WFGEN_IISNODE_<app name>_<setting name>

示例：

ini
WFGEN_IISNODE_AUTH_loggingEnabled=true

iisnode特殊选项

WFGEN_ENABLE_IISNODE_OPTION_<app name> - exposelogs值可通过HTTP暴露日志（仅调试用）

自定义连接字符串

添加自定义连接字符串：WFGEN_CUSTOM_CONNECTION_STRING_<name>=<connection_string>
默认提供程序为System.Data.SqlClient。

指定自定义提供程序：

ini
WFGEN_CUSTOM_CONNECTION_STRING_<name>_PROVIDER_NAME=<provider_name>

示例（PostgreSQL）：

ini
WFGEN_CUSTOM_CONNECTION_STRING_MyCustomDB=Host=myserver;Port=5432;Database=mydb;Username=user;Password=pass;
WFGEN_CUSTOM_CONNECTION_STRING_MyCustomDB_PROVIDER_NAME=Npgsql

密钥管理

Docker Secrets和Kubernetes Secrets支持：任何环境变量可添加_FILE后缀，其值为包含实际值的文件路径。

注意：带与不带_FILE后缀的变量互斥。

Docker Swarm示例：

powershell
# 创建密钥
docker secret create ApplicationSecurityPasswordSymmetricEncryptionKey "84c953d4eac14da2ba93c010e85c76e0"
docker secret create WFGEN_DATABASE_CONNECTION_STRING "Host=database;Port=5432;Database=wfgen;Username=wfgen_user;Password=secretPassword;"
docker secret create ApplicationSerialNumber "YOUR_SERIAL_NUMBER"

# 创建WorkflowGen服务（v10搭配PostgreSQL）
docker service create `
    --env WFGEN_APP_SETTING_ApplicationSecurityPasswordSymmetricEncryptionKey_FILE=C:\ProgramData\Docker\secrets\ApplicationSecurityPasswordSymmetricEncryptionKey `
    --env WFGEN_DATABASE_CONNECTION_STRING_FILE=C:\ProgramData\Docker\secrets\WFGEN_DATABASE_CONNECTION_STRING `
    --env WFGEN_DATABASE_CONNECTION_STRING_PROVIDER_NAME=Npgsql `
    --env WFGEN_APP_SETTING_ApplicationSerialNumber_FILE=C:\ProgramData\Docker\secrets\ApplicationSerialNumber `
    --secret ApplicationSecurityPasswordSymmetricEncryptionKey `
    --secret WFGEN_DATABASE_CONNECTION_STRING `
    --secret ApplicationSerialNumber `
    --mount "type=volume,src=licenses,dst=C:\wfgen\licenses,readonly" `
    advantys/workflowgen:10.0.3-win-ltsc2019

---

特殊环境变量