2.6. 激活和注册 Pyarmor
Contents
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 会首先显示注册信息并请求确认,如果确认无误,输入 yes 并 Enter 继续下面的注册步骤,其他任何输入都会终止注册过程。
注册成功之后会同时生成一个名字类似 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. 升级老版本许可证
升级老版本的许可证请参考 升级老版本许可证