概述

Virbox 用户工具是安装在最终用户机器上的一款应用软件,是开发商软件最终运行时环境,是软件和许可之间的桥梁,其屏蔽了一切底层接口,大大提升了软件访问加密锁和云平台的开发效率。而且,客户端内置了多种我公司顶尖安全技术,并且可以随时升级,而升级客户端并不会对开发者已发布的软件造成任何影响。客户端内置了我公司最先进的反黑引擎产品,可以有效打击盗版行为。客户端还包含了展示产品信息、查看许可信息、配置服务类型、升级许可数据、登录云账户、检测修复运行环境等功能,是 Virbox LM 不可或缺的一部分。

版本信息

Virbox 用户工具支持多种常用操作系统,以下表给为支持列表,本文为方便起见,以 Windows 操作系统下的操作为例做说明。Linux 操作手册请参考 Virbox 用户工具 Linux 版用户手册

  • Windows XP SP3 及以上
  • Linux(x86)、Linux(ARM)
  • macOS 10.9.2 及以上
  • Android (设备)

为什么要安装 Virbox 用户工具

  • 内置反黑引擎,安装了 Virbox 用户工具,就相当于安装了一套反黑引擎
  • 内置通道加密,三层加密技术,破解无从入手
  • 主动升级防御,高频更新安全策略,主动推送升级提醒,随时提升安全强度
  • 屏蔽底层接口,统一许可访问接口,提高开发效率
  • 网络锁功能,一锁多端,统一管理
  • 展示开发者和产品信息,易于产品推广

说明

Smart License 不需要安装 Virbox 用户工具

获取安装包

有两种方式获取 Virbox 用户工具安装包。一种是通过官方网站 下载中心 获取最新版本的安装包;一种是通过 Virbox 开发者工具盒 获取安装包,如下图所示,打开文件目录,即可得到安装包。

我们建议您从官网下载最新的安装包使用,因为工具盒中的安装包更新频率比官网上的更新频率要低很多。

安装包所在目录和文件名称

安装客户端

Windows 版

直接安装

双击安装包进行安装,安装过程可选择指定安装目录(建议选择默认路径),我们在 快速入门 中已经讲过了,这里不再做介绍。

命令行安装

Virbox 用户工具支持命令行安装。因为用户工具是需要随着开发者的软件一起发布的,因此可以通过命令行进行静默安装等操作,命令行参数如下描述。

sense_shield_installer_pub.exe [/S] [/c no_driver] [/senseshield_hide_taskbar_icon] [/auto_install] [/not_create_desktop_shortcuts] [add_ss_restart_schtask --ss_restart_schtask_time=06:00:00]

参数列表

参数说明
/S静默安装(注意必须是大写)
/c no_driver不安装加密锁驱动
/auto_install显示安装进度条,安装到默认路径
/not_create_desktop_shortcuts不创建用户工具桌面快捷方式,在 /S 模式下才能生效
/senseshield_hide_taskbar_icon隐藏用户工具托盘图标,在 /S 模式下才能生效
/add_ss_restart_schtask [--ss_restart_schtask_time=06:00:00]添加服务定时重启计划任务(不支持Windows XP 和 Windows Server 2003)

注意

执行命令行参数过程中必须使用“管理员权限”运行,否则会提示“拒绝访问”。


查看命令参数示例:

集成安装包

这里将帮助您在您的安装包中集成打包 Virbox 用户工具,我们通过 NSIS、C代码、C#代码的例子来帮您自实现工具的打包安装。

NSIS 脚本

Function InstallSenseshield
    ;; 静默安装 Virbox 用户工具
    ; 打包 Virbox 用户工具安装包
    File /oname=$TEMP\sense_shield_installer_pub.exe sense_shield_installer_pub.exe
    
    ; 获取当前 Virbox 用户工具文件版本号(用于判断是否执行安装)可忽略
    ${GetFileVersion} "$TEMP\sense_shield_installer_pub.exe" $R0

    ; (同步)后台执行安装过程
    ExecWait '"$TEMP\sense_shield_installer_pub.exe" /S' $0
    DetailPrint "sense_shield_installer_pub.exe $R0 return $0"
    
    ; 判断安装结果是否成功
    IntCmp $0 0 0 ExitInstall ExitInstall
    Return
    
ExitInstall:
    ; TODO 安装错误处理

FunctionEnd
VB

C 代码示例

#include <stdio.h>
#include <Windows.h>

int main()
{
	int ret = 0;
	char *silent_install_cmd = "\"C:\\Program Files (x86)\\senseshield\\ss_dev\\Redistribute\\sense_shield_installer_pub.exe\" /S";
	ret = system(silent_install_cmd);
	switch (ret)
	{
	case 0:
		printf("安装成功\n");
		// 静默安装成功,在此处编写后续处理代码
		break;
	case 3:
		printf("已安装版本高于当前版本\n");
		break;
	case 4:
		printf("无法终止运行中进程,重启电脑后重新安装\n");
		break;
	case 5:
		printf("安装文件丢失\n");
		break;
	case 6:
		printf("x64系统驱动文件重命名失败\n");
		break;
	default:
		printf("未知错误\n");
		break;
	}

	getchar();
}
CPP

C# 代码示例

using System.Diagnostics;

namespace SSPubPackageSilentInstallDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            string package_path = @"C:\Program Files (x86)\senseshield\ss_dev\Redistribute\sense_shield_installer_pub.exe";
            string silent_params = "/S";
            
            Process process = Process.Start(package_path, silent_params);
            process.WaitForExit();
            switch (process.ExitCode)
            {
                case 0:
                    Console.WriteLine("安装成功\n");
                    // 静默安装成功,在此处编写后续处理代码
                    break;
                case 3:
                    Console.WriteLine("已安装版本高于当前版本\n");
                    break;
                case 4:
                    Console.WriteLine("无法终止运行中进程,重启电脑后重新安装\n");
                    break;
                case 5:
                    Console.WriteLine("安装文件丢失\n");
                    break;
                case 6:
                    Console.WriteLine("x64系统驱动文件重命名失败\n");
                    break;
                default:
                    Console.WriteLine("未知错误\n");
                    break;
            }

            Console.ReadKey();
        }
    }
}
C#

Linux 版

安装包版本

基于 Debian 软件包的 .deb 安装包,分 x86 和 x64 两个版本,可用于 Debian、Ubuntu 等系统。

基于 RPM 软件包管理器的 .rpm 安装包,分 x86 和 x64 两个版本。

安装方式

Linux 安装包相关详细命令如下:


rpm格式

(例  senseshield-2.2.0.31501.i386.rpm)

deb格式

(例 senseshield-2.2.0.31501-i386.deb)

备注

注意

1 必须使用管理员权限进行安装/升级/覆盖/卸载等操作。

2 安装之前,要确定当前目录下存在安装包文件,输入ls命令查看即可。

如果不在,需要cd 命令切换到安装包文件所在目录。

安装

rpm -ivh senseshield-2.2.0.31501.i386.rpm(带后缀)

dpkg -i senseshield-2.2.0.31501-i386.deb(带后缀)

root权限

升级

rpm -Uvh 高版本的rpm安装包名字(带后缀)

dpkg -i高版本deb安装包名字(带后缀)

root权限

强制覆盖

rpm -ivh  --force 要安装的包名(带后缀)

dpkg -i要安装的包名(带后缀)

root权限

卸载

rpm -e senseshield (不带后缀)

dpkg -P senseshield (不带后缀)

root权限

查看包信息

rpm -qi senseshield (不带后缀)

dpkg -l senseshield (不带后缀)

权限不限

其他

关于 rpm 和 dpkg命令的详细参数,可在系统下自行查看。查看命令如下:

rpm --help

dpkg --help

安装完成后,使用查看服务状态命令查询状态,service senseshieldd status 或者 systemctl status senseshield,详见下文 Virbox 许可服务服务管理。

macOS 版

macOS 版本目前仅支持直接双击安装的方式,其他方式暂不支持。

小结

当环境部署完成后,就可以正常运行我们的软件了,详细介绍请看 下一节