跳到主要内容

用户手册

来源：生产部署包 userManual_Chinese/用户手册.pdf（VirboxLME-080000000000090D-2026.06.10），112 页。安装、登录、签发主路径见 Windows 安装 与 签发、加壳与激活。本文补界面规则和运维步骤。截图以交付包 PDF 为准。

安装与卸载​

双击「Virbox LM 私有化授权中心.exe」，按向导安装。桌面生成 Internet 快捷方式。登录账号 root，密码 virbox2021。

卸载：安装目录里的「卸载.exe」，或开始菜单 / 卸载程序。再次安装是覆盖安装；个别文件冲突可以跳过。

概览​

登录后默认进入概览。

平台资源按许可形式汇总。软许可（授权码）和硬件锁是两种形式。鼠标指向蓝色卡片上的数字，数字变红后可点进详情。

单机许可：1 个单机授权码扣 1 个许可数。另外统计绑定设备数、借阅许可数的剩余和总数。

集团许可：1 个集团授权码扣 1 个许可数。另外统计并发用户数和集团借阅数。

概览底部工具资料：

  • 开发者工具盒：缓存、在线更新、离线导入和导航客户端 SDK。
  • C2D/D2C 反查：已有文件但要看内容时使用。C2D 含本地硬件信息，由最终用户生成，用来兑换授权文件。D2C 是针对特定软许可或硬件锁的授权文件。软许可由用户自助生成 C2D，再访问用户许可中心兑换。硬件锁由开发者生成 D2C，生成过程不用 C2D。
  • 平台帮助中心、OpenAPI 手册。
  • 升级控制锁：上传升级文件。

产品​

每个要授权的程序、动态库、方法或功能模块分配一个 License ID（许可 ID），类型 unsigned int。发布保护和许可之前先规划 ID。

创建产品：

  • 许可 ID、产品名称（检索用）、显示名称（Virbox 用户工具里显示）。
  • 产品 Logo 只支持 PNG，尺寸 160×120。由 40×120 和 120×120 两张图拼接。
  • 产品描述显示在用户工具中。

数据区不能脱离许可单独存在。一条许可下可以配置数据区和模块区。文件上传和 key/value 两种模式最终只能选一种。两种模式可以写出相同内容。

每个数据区 64KB。每条许可有三类数据区：

  • 只读区：登录许可后可读，使用中不能用函数写入。
  • 读写区：登录后可读可写。
  • 公开区：Virbox 用户工具可直接读，不用登录许可。

key/value：Key 和 Value 用可打印 ASCII。显示名称给许可管理员看，一般为中文。一个 Key 只能归入一个分组，三个区可以分别建分组。分隔符连接一对 Key 和 Value，连接符把多对串起来。例如分隔符为冒号、连接符为分号时，存储内容是 Key1:Value1;Key2:Value2。Key 列和分隔符可以隐藏，签发人员只看显示名称。

模板与许可​

销售模板分授权码模板和硬件锁模板。模板上可看许可条款、64 子模块、数据区和临时权限。卡片或列表展示，支持搜索和刷新。

授权码许可：发布、详情、列表。列表可刷新、批量更新、导出。设置项包括用户信息、权限分配、批量共享、自动共享、取消共享、设置标签。更多里可以删除、锁定/解锁。搜索支持标签和高级筛选。

硬件锁许可：单条发布，或批量发布（先选用户锁，再选模板）。详情里可下载 D2C。列表的更多操作：删除锁内指定许可、清空锁内所有许可。

授权扣减记录按授权码模糊查。发布时不扣点，授权码许可绑定后才扣点。

硬件锁管理​

用户锁要先从 SaaS 导出生产数据再导入。私有化侧初始没有用户锁数据。路径：SaaS 用户锁管理 → 批量操作 → 导出用户锁生产数据。

也可以开启公有云用户锁同步。系统设置里填写公有云 appid/secret 后，联网时每天 3 点把公有云用户锁同步过来。

搜索支持外壳编号、备注名称、联系方式。可用标签筛选。激活类型和当前状态下拉可筛选。

变更锁：

  • 变更为永久锁：放弃丢锁管控。
  • 变更为激活锁：启用丢锁管控。
  • 挂失：只针对激活锁。挂失后云平台不再定期激活，这把锁自挂失起最多再用 14 天。取消挂失后恢复定期激活。
  • 锁定：永久锁和激活锁都可以锁。在线使用时云平台直接锁定。永久锁如果离线，锁定要等它联网才生效。激活锁离线最多再用 14 天，到期联网激活时被锁定。
  • 解锁：恢复已锁定的锁。
  • 部分中间状态可以撤回。

批量勾选后变更状态。状态变更要等用户端定时联网检查（最长 12 小时），或联网插拔锁。

批量操作：

  • 导出证书链：按时间周期或连续外壳编号。用开发者管理工具或 API 远程签发时需要证书链。在本平台发布和更新许可不需要证书链。
  • 导入用户锁信息：下载模板填写后上传，可同时加标签。
  • 导出用户锁信息：含商业信息，要超级管理员验证码。
  • 全部开启或关闭在线自动升级。该功能默认关闭。
  • 导入开发者管理工具许可记录。库文件：C:\ProgramData\senseshield\DeveloperManagerTool\db\sense.db。产品 ID 已存在则跳过，不改私有化侧产品数据，不处理产品包。许可记录对应的用户锁在私有化侧不存在则跳过。记录可手动下载 D2C，逻辑与本平台签出的许可一致。查看入口：许可管理 → 硬件锁许可 → 升级历史；或硬件锁管理 → 用户锁管理 → 升级历史。

用户锁详情有基本信息、归属信息和许可信息（状态变更、许可概要、升级历史）。基本信息不能改。可改备注、联络方式、是否自动升级和标签。升级历史的操作列可下载 D2C。

控制锁即开发锁。它有软件保护和发布许可的权限，要单独保管。

账号、权限、任务、标签​

右上角开发者名称打开系统菜单。

开发者信息：账号、开发者名称、用户工具上的显示名称、Logo、官网、简介。关键信息是开发者编号，以及调用 OpenAPI 的 appid/secret。修改信息要先输入超级管理员密码。

账号信息：超级管理员或管理员。可改登录密码、看绑定邮箱和手机、设置密保问题。超级管理员找回密码目前只走密保问题，否则要初始化数据库账号密码。

权限按角色和产品模板细分。一个管理员只能有一种角色。选角色后带出角色权限，可以临时改。

模块权限：产品、模板、许可的查看、创建、更新、删除。更新权限含锁定、解锁和设备强制解绑。另有下载数据区、手动共享、同角色自动共享。硬件锁管理含用户锁（改备注、导出证书链）和控制锁信息（可看每把控制锁的初始 PIN）。

产品权限可以是全部产品，或按产品单独授权，并限制用某模板发布的数量。

子管理员默认拥有全部用户锁。分配用户锁后，只拥有分到的锁。可以禁用登录或删除管理员。

四个默认角色：产品经理、开发人员、经销商、销售经理。默认角色可编辑、可删除。产品经理管理被授权及自己创建的产品、模板和自己发布的许可；是否可发布、是否同角色自动共享，由超级管理员设置。开发人员可看被授权的产品和模板，管自己发布的许可，许可不可共享。经销商和销售经理不能看产品和模板，管自己发布的许可；经销商可手动共享。

有同角色共享的角色换成别的角色时，会取消此前自动共享出去和共享进来的许可。新角色若开启同角色自动共享，则把该账号下的许可共享给同角色其他人。

编辑角色时询问是否应用到该角色下全部管理员。

任务中心：导入、导出是任务。涉及商业机密的任务要超级管理员校验。完成后在任务中心下载。批量发布硬件锁的结果也在这里。

标签可用于许可、用户和硬件锁，数量不限。默认可选 18 种颜色。删除标签会确认。

配置管理可隐藏左侧的模板、许可、用户锁、控制锁入口，并切换时间显示到日、到分或到秒。重置恢复默认。

系统设置​

  • 私有云平台端口：默认 18124，可改。
  • 与 SS 通信端口：默认 12345，可改。授权码在线绑定/解绑、硬件锁在线升级、丢锁补锁都走 SS。用户工具要配置 IP:端口。
  • 公有云用户锁信息：选同步后填写公有云 appid/secret，每日 3 点同步。
  • 授权方式：控制锁或云锁。云锁要连接授权服务。
  • 控制锁 PIN：默认 12345678，可改。控制锁授权时要验证。
  • 授权服务 host：深盾私有化授权服务地址。
  • 缓存：Redis 或 Memory。选 Redis 时在 deployment.properties 里配置。
  • 本地写锁：打开发布许可直接写入锁内。2.14 及以上可在页面开；更早版本改配置文件。
  • 会话保持：不能小于 600 秒。
  • 报警通知邮件：程序错误发到配置的邮箱。
  • 重启系统：重启私有化授权中心。

用户许可中心：http://<ip>:<端口>/sn/login.html。例如 http://localhost:18124/sn/login.html。用授权码和图片验证码登录。支持授权码离线绑定和离线解绑。

在线借阅​

开发者中心发布或更新授权码时，在扩展功能里开启在线借阅。默认关闭。

  • 借出许可数：可借出的许可总数。每个借出许可是一个短码 XXX-XXX-XXX，一把借阅码只绑一台机器。已绑定的可以主动归还或过期自动归还。
  • 强制回收许可数：在原有同时绑定设备之外额外扩充的数量。约定强制回收许可数不大于借出许可数，并应尽量小。
  • 管理员个数：默认 10，不超过 100。
  • 禁止激活授权码：默认开启。开启后原授权码不能绑到设备，只允许借阅码绑定。

用开启了借阅的授权码登录用户许可中心，在权限管理添加管理员。登录账号是邮箱，密码 6 到 20 位。各管理员借出许可数之和不能超过授权码的借出许可数。已管理借阅码的管理员不能删除。邮件通知要自行配置发件人：VirboxLM Enterprise\virbox-service\developerCenterWeb\conf\email.properties。邮箱要先开 SMTP 并生成客户端密码。说明页：https://developer-new.lm.virbox.com/doc/email/help.html。每个授权码的管理员入口不同。

管理员登录后生成借阅码。可设借阅时长（从激活起最多 m 天）或具体结束时间、强制认证天数（n 天内至少联网认证一次）、用户名称、邮箱、备注，并批量生成。有效借阅码含未绑定未过期、已绑定未过期。归档含过期和已回收。

回收：未使用或认证过期的可手动回收。已绑定、未过期、离线也未到期的，在设置了强制回收许可数且仍有剩余时可以强制回收。每回收一个，有效列表减一条，归档加一条，剩余可生成数加 1，已生成有效数减 1。用户解绑了被强制回收的借阅码后，已用强制回收数减 1。把授权码的强制回收许可数改成 M 时，M 不能大于当前已用总数。

试用许可​

试用许可是授权码软许可，周期最长 90 天。支持免激活，也支持在线激活。

免激活：下载 D2C，随软件打包，安装后释放到指定目录，用命令行工具或 API 自动激活。升级包在许可详情下载，一直有效。

在线激活：把授权码公开，用户领取后在线激活。

创建：销售模板 → 授权码模板，许可类型选试用许可。发布：许可管理 → 授权码许可。时间跨度最大 90 天，绑定后最长使用 90 天。快速上手里的「无限签发 1 到 90 天」要先开通产品推广模块。

数据备份与恢复​

数据库在安装目录 mysql-5.7.27-winx64。默认路径 C:\Program Files\VirboxLM Enterprise\mysql-5.7.27-winx64。用户名 root，密码 admin，端口 3307。

cd "C:\Program Files\VirboxLM Enterprise\"
./data_backup.ps1
./data_restore.ps1 <path to data_backup.sql>

本地写锁​

在网页或 OpenAPI 签发硬件锁许可时，把许可直接写入插入的精锐 5。写锁电脑要能访问私有化服务。

写锁端安装带 WebServer、且允许远程 IP 访问的 Virbox 用户工具定制版。默认 HTTP 9080，HTTPS 9081。探测：

(Invoke-WebRequest -URI "http://localhost:9080/v1/api/wbsrv/getVersion").RawContent

Linux：curl "http://localhost:9080/v1/api/wbsrv/getVersion"。返回 code 为 0 即正常。

服务器：

  1. 安装私有化授权中心，版本不低于 1.7.0.65701，并插入控制锁。
  2. 2.14 以下：在 C:\Program Files\VirboxLM Enterprise\virbox-service\deployment.properties 末尾加 user.lock.local.update.enabled=true。2.14 及以上：系统功能 → 服务设置 → 开启本地写锁。
  3. 重启 VirboxService。

客户端：

  1. 安装支持 WebServer 且允许远程 IP 的用户工具，版本不低于 2.6.0.65674。安装包在生产包 Virbox UserTools\Windows。
  2. 把同目录的 web_server.json 拷到 C:\Program Files (x86)\senseshield\ss\service，与 senseshield.exe 同级。文件不用改。
  3. 重启 Sense Shield Service。

使用：登录后创建产品和硬件锁模板。许可管理 → 硬件锁许可 → 发布许可或批量发布。插入精锐 5，按 F5 刷新（页面不会在插锁后自动刷新）。右下角绿色提示「已启用本地写锁」表示客户端工具版本正确。选模板确定。回到签发页，锁号前绿点为成功，红点为失败。

root 可在权限管理里分配写锁账号和权限。

多因素认证​

默认只校验密码，默认不开启 MFA。开启要超级管理员在右上角 → 安全设置里配置，并至少一种认证方式。

不开启或开启时，找回密码的规则相同：超级管理员只靠密保问题，否则初始化数据库账号；子管理员可由超级管理员改密码，或自己用密保找回。超级管理员换绑账号只验密码。子管理员可由超级管理员改账号，或自己用密码换绑。

12 小时内密码输错 3 次，开启图形验证码。

登录时使用 MFA 的范围：

  • 强制所有用户：每次登录都要密码加短信或邮箱。免多重验证的周期由「保存 MFA 验证状态」决定。
  • 依赖每个用户的独立设置。
  • 仅异常登录：更换设备或登录地址时。
  • 不开启：只验密码。

短信支持阿里云、腾讯云。开发商先注册短信账号、拿 AppID 和 AppSecret、申请签名，再在平台配置。邮箱要保证平台能访问邮件服务器，配置后可以测试。验证码发到当前账号的手机或邮箱。