PLC转SECS网关License授权

发布于 2026-06-11

心动不如行动！

ZSquare Gateway License v1.0

适用范围: ZSquare Gateway v1.0.0
JDK 版本: 1.8（项目统一版本）
最后更新: 2026-06-11

1. 整体流程

获取“试用版”与“够用版”的方法及整体流程。

sequenceDiagram
    Note over Customer: 下载或发送邮件
索取fingerprint.bat文件
    Note over Customer: 双击fingerprint.bat文件
获取 Machine Code
    Customer->>+Vendor: 发送邮件给厂商
    Note over Vendor: 根据提供的 Machine Code
生成 license.lic文件
    Vendor-->>-Customer: 回复邮件给客户
    Note over Customer: license.lic文件
放到项目config目录下
    Note over Customer: Windows OS 命令行提示窗
java -jar gateway.jar start
    Customer->>+Vendor: 运行正常与否，把结果与需求反馈给厂商！
    Vendor-->>-Customer: 根据反馈回复客户。

客户侧只需要 Java 运行环境来跑 Gateway 本身

取指纹用的是 PowerShell 脚本，不需要 Java。

2. 客户侧操作

2.1 取机器码（fingerprint）

客户只需双击运行，不需要装任何东西。

交付物中附带两个文件：

gateway/
├── fingerprint.bat    ← 双击运行
└── fingerprint.ps1    ← PowerShell 脚本（.bat 调用它）

输出示例：

Machine Code: B945-C075-E8C0-1E72

Components:
  Motherboard UUID: AD437871-29F6-4784-BEFC-996D4739CCA1
  MAC Address:      B0:6E:BF:4B:2E:18

Send the Machine Code to wenzhe.zhao@z-square.cn to request a license.

把 Machine Code 发给 wenzhe.zhao@z-square.cn 即可。

2.2 安装 License

收到 license.lic 后，放到 config/ 目录：

gateway/
├── config/
│   └── license.lic      ← 放这里
└── gateway.jar

2.3 启动与验证

# 启动
java -jar gateway.jar start

# 查看 license 状态
java -jar gateway.jar license status

# 输出:
# === ZSquare Gateway License ===
# Customer:     CUST-2026-0001
# Type:         PERMANENT
# Status:       VALID
# ================================

License 文件查找优先级：

1. -Dlicense.path=/path/to/license.lic

2. 环境变量 LICENSE_PATH

3. 默认 config/license.lic

3. 厂商侧操作

3.1 一键生成（推荐）

双击 docs/devops/generate-license.bat，按提示输入即可：

Customer ID:  CUST-2026-0001
License type: [1] PERMANENT  [2] TRIAL : 1
Machine Code: B945-C075-E8C0-1E72
Motherboard UUID: AD437871-...
→ 确认 → 生成 license.lic

脚本自动校验输入格式、检查私钥和 classpath，防止新人拼错命令。

参数说明：

参数	必填	说明
`--customer`	✅	客户编号，如 `CUST-2026-0001`
`--type`	✅	`PERMANENT` 或 `TRIAL`
`--motherboard-uuid`	✅	客户机器的 UUID（来自邮件）
`--machine-code`	✅	客户发来的机器码（记录用途）
`--expire`	TRIAL必填	过期日期 `yyyy-MM-dd`，如 `2026-07-11`
`--key`	可选	私钥路径，默认 `license_private.pem`
`--output`	可选	输出路径，默认 `license.lic`

3.2 License 文件格式

{
  "productId": "ZSquare-Gateway",
  "customerId": "CUST-2026-0001",
  "machineCode": "B945-C075-E8C0-1E72",
  "motherboardUUID": "AD437871-...",
  "licenseType": "PERMANENT",
  "issueDate": "2026-07-11",
  "expireDate": null,
  "version": 1
}
===SIGNATURE===
Base64 RSA-SHA256 signature

4. 最终交付物结构（模拟）

zsquare-gateway-v1.0.0.zip
├── jre/                   ← JDK 1.8 精简版 (~40MB)
├── config/
│   └── license.lic        ← 客户放入
├── logs/
├── fingerprint.bat        ← 双击取机器码
├── fingerprint.ps1        ← PowerShell 脚本
├── start.bat              ← 双击启动
├── stop.bat               ← 停止
├── gateway.jar
└── deps/                  ← 第三方依赖 JAR

5. FAQ

Q: fingerprint.ps1 需要什么运行环境？

A: 零依赖。Windows 7 及以上自带 PowerShell 2.0+，双击 fingerprint.bat 即可运行。

Q: 客户机器没有 PowerShell 怎么办？

A: Windows 7 是 2009 年发布的，之后所有 Windows 版本都预装 PowerShell。不存在"没有"的情况。如果客户用的是 Windows XP，请在 .bat 中用 wmic 命令替代（联系我们提供 XP 版脚本）。

Q: 指纹变了怎么办（比如换主板）？

A: 客户重新运行 fingerprint.bat，把新机器码发给厂商，重新生成 license.lic 覆盖即可。

← 返回列表