2.6. 激活和注册 Pyarmor

2.6.1. 第一次注册登记

首先参考 许可模式和许可证 购买合适的许可证。购买完成之后,一个名称为 pyarmor-regcode-xxxx.txt激活文件 将会很快发送到注册邮箱中,这个文件用于第一次的注册登记。

在第一次注册的时候,需要使用 -p 指定许可证绑定的产品名称,对于非商业化产品中的应用,使用产品名称 non-profits ,该许可证不能被应用于商用产品中。

注册登记需要网络连接。

2.6.1.1. 内部使用的注册方式

如果该许可证只在内部使用,而不会在任何商业产品中使用,可以使用下面的方式注册:

$ pyarmor reg -p non-profits pyarmor-regcode-xxxx.txt

2.6.1.2. 在商用产品中使用的注册方式

假设许可证将被用来保护产品 Robot Studio ,那么使用下面的命令进行初始登记注册:

$ pyarmor reg -p "Robot Studio" pyarmor-regcode-xxxx.txt

Pyarmor 会首先显示注册信息并请求确认,如果确认无误,输入 yesEnter 继续下面的注册步骤,其他任何输入都会终止注册过程。

注册成功之后会同时生成一个名字类似 pyarmor-regfile-xxxx.zip注册文件 ,这个文件被用来在其他设备上进行注册。

激活文件 在第一次注册成功之后就无法继续使用,后续在任何设备上注册请使用 注册文件 。请妥善保管并备份注册文件,一旦丢失,Pyarmor 并不提供找回服务。

一旦注册成功之后,许可证绑定的产品名称就不能在进行修改。

2.6.1.3. 绑定许可证到正在开发的产品

如果产品还在开发中,没有正式开始销售,允许初始化登记的时候设定产品的名称为 TBD 。例如:

$ pyarmor reg -p "TBD" pyarmor-regcode-xxxx.txt

绑定的产品名称为 TBD 的许可证,必须在产品销售之前,使用下面的命令设置为正确的产品名称:

$ pyarmor reg -p "Robot Studio" pyarmor-regcode-xxxx.txt

2.6.2. 在其他设备上面注册

一旦初始登记完成之后,就会得到一个 注册文件 ,通常名称为 pyarmor-regfile-xxxx.zip

拷贝这个压缩文件到其他需要注册的设备,然后运行下面的命令进行注册:

$ pyarmor reg pyarmor-regfile-xxxx.zip

查看注册信息:

$ pyarmor -v

2.6.2.1. 在 Docker 或者 CI pipeline 中注册

在 Docker 或者 CI pipeline 中注册 Pyarmor 的基本方法同上,但是同时运行的 Pyarmor 的 Docker 数量有限制,不能超过 100 个。

只允许在开发设备上安装和注册 Pyarmor。如果 Docker 镜像需要发送给客户,那么不允许在上面安装和注册 Pyarmor

2.6.3. 使用集团版许可证

在 8.2 版本加入.

初始登记

购买集团版许可证之后,一个 pyarmor-regcode-xxxx.txt激活文件 会发送到注册邮箱中,这个文件用于第一次的注册登记。

集团版许可证的第一次注册登记需要在有网络的设备上进行,首先安装 Pyarmor 8.2 以上版本,然后运行下面的命令进行初始登记,初始登记必须指定许可证绑定的产品名称,不允许使用 "TBD",这里假设产品名称是 Robot:

$ pyarmor reg -p Robot pyarmor-regcode-xxxx.txt

登记成功之后会生成相应的注册文件 pyarmor-regfile-xxxx.zip ,这个注册文件可用于后续的注册命令。

离线设备注册文件

每一个集团版许可证组最多可以有 100 个离线设备,每一个设备有一个编号,依次从 1 到 100。

为了在离线设备上注册 Pyarmor,需要为每一台设备分别生成相应的离线注册文件。

例如,为第一台设备生成离线注册文件,首先在第一台设备运行下面的命令,生成一个组内的设备文件 pyarmor-group-device.1:

$ pyarmor reg -g 1

然后把这个文件拷贝到进行初始登记的机器上面,并存放在指定目录 .pyarmor/group/ 下面,再使用下面的命令生成离线注册文件 pyarmor-device-regfile-xxxx.1.zip:

$ mkdir -p .pyarmor/group
$ cp pyarmor-group-file.1 .pyarmor/group/

$ pyarmor reg -g 1 /path/to/pyarmor-regfile-xxxx.zip

这条命令执行成功之后会生成第一台设备的离线注册文件 pyarmor-device-regfile-xxxx.1.zip

离线设备注册

一旦生成离线设备注册文件之后,就可以拷贝到离线设备上面,运行下面的命令进行注册:

$ pyarmor reg pyarmor-device-regfile-xxxx.1.zip

查看注册信息:

$ pyarmor -v

如果还有其他需要注册的离线设备,请依次使用设备编号 2,3... 按照上面的步骤进行。

2.6.4. 升级老版本许可证

升级老版本的许可证请参考 升级老版本许可证