签名与信任
插件包自带签名，因此无论它来自插件目录、上传、离线插件包目录还是集群中的另一个节点，Nginx UI 都能知道是谁发布了它。签名者决定插件包的信任等级，而信任等级决定 Nginx UI 是否以及如何安装它。
签名使用 minisign。
为插件包签名
密钥只需创建一次，各个文件的用途参见签名密钥：
nginx-ui plugin key init --id io.github.example.mydns然后在插件包的其他所有文件都确定后，用签名密钥为每个插件包签名：
nginx-ui plugin pack ./mydns io.github.example.mydns-1.0.0.tar.gz --key signing.key
# 或者直接为已有的插件包签名
nginx-ui plugin sign io.github.example.mydns-1.0.0.tar.gz --key signing.key这两个命令会把签名密钥的证书打进插件包，证书从插件目录、--signer 指定的目录或密钥所在目录中查找。证书属于其他插件或其他密钥时，命令会拒绝执行，误用主密钥签名时就会出现这种情况。加密的私钥使用 NGINX_UI_PLUGIN_SIGN_PASSWORD 中的密码读取。
签名会在插件包根目录添加两个文件：
| 文件 | 内容 |
|---|---|
plugin.sums | 插件包其他所有文件的 SHA-256。 |
plugin.sums.minisig | plugin.sums 的 minisign 签名。 |
之后对任何文件的修改都需要重新签名。同一版本的每个插件包都要单独签名。
手动签名
plugin.sums 每个普通文件一行，格式与 sha256sum 的输出相同：
<sha256> <path>- 64 个小写十六进制数字、两个空格，然后是相对于插件包根目录、以
/分隔的路径； - 每行以换行符结尾；不能有回车、空行、字节顺序标记或注释；
- 按路径的字节顺序排序（
LC_ALL=C sort），每个路径只出现一次； - 列出每个普通文件（包括空文件），但不包括根目录下的
plugin.sums和plugin.sums.minisig。不列出目录。
然后用 minisign -S -m plugin.sums 签名。两种 minisign 签名算法都可以接受。
Nginx UI 如何检查插件包
| 插件包包含 | 结果 |
|---|---|
| 没有签名，或只有两个文件中的一个 | 未签名 |
| Nginx UI 不认识的密钥所做的签名 | 未签名 |
| 无法解析的签名，或无法用它声明的密钥验证的签名 | 无效 |
有效的签名，但 plugin.sums 与文件不符 | 无效 |
| 有效的签名且文件相符 | 由该密钥签名 |
警告
无效的插件包在签名之后被修改过。Nginx UI 总是拒绝它，即使在开发者模式下也是如此。plugin.sums 恰好列出插件包的所有普通文件及其正确的 SHA-256 时，才算相符。
Nginx UI 会在安装前展示插件包时检查一次，在安装时再检查一次，对任何来源都是如此。插件目录中的校验和永远不能代替签名检查：它只能说明下载到的是插件目录所指的文件。
信任等级
| 签名者 | 等级 |
|---|---|
| Nginx UI 项目的官方插件签名密钥 | official |
| 项目担保且未被吊销的合作伙伴密钥 | verified |
插件包所来自的目录条目的 author_public_key、Nginx UI 可信发布者列表中的密钥，或者它们认证的签名密钥 | community |
| 没有签名，或签名者未知 | unsigned |
等级排序为 unsigned < community < verified < official。插件目录和运维人员都不能把密钥提升到 community 以上。插件目录条目中的 trust 标签只用于显示，从不授予等级。
官方插件签名密钥是一把独立的密钥，与签名 Nginx UI 发行版的密钥分开：它为插件、合作伙伴证书和合作伙伴密钥环签名，但从不用于验证 Nginx UI 的升级包。
各等级允许的内容：
official和verified正常安装，并可以自动更新。community只有在运维人员允许社区插件时才能安装，并且需要用户确认插件包是由作者而不是 Nginx UI 项目签名的。上传或复制到离线目录的插件包，只有当它的密钥在可信发布者列表中时才是community。unsigned只能在开发者模式下安装。
Nginx UI 会记录每个已安装插件的等级和签名者的密钥 ID，并显示出来。更新的插件包等级低于已安装插件时属于降级：自动更新会拒绝它，用户手动更新时会先收到警告。Nginx UI 自动安装的插件（例如 DNS-01 插件）必须是 official。
以社区作者身份发布
大多数插件都是社区插件。它们的目录条目登记作者的主密钥，插件包则由主密钥认证过的签名密钥签名。主密钥离线保存，几乎不会更换；签名密钥可以放在 CI 中，更换时不需要改动插件目录。官方插件目录只收录按这种方式签名的社区插件包。
- 创建密钥并认证签名密钥，参见签名密钥。
- 用签名密钥为每个插件包签名。
- 把主公钥（
.pub文件中的 base64 那一行）作为author_public_key放进目录条目，参见插件目录。从该条目下载、由该密钥或它认证的签名密钥签名的插件包就是community。 - 不通过插件目录安装你的插件包的人，需要把你的主公钥添加到 偏好设置 > 插件 > 可信发布者。
签名密钥
用签名密钥签名的插件包会带上它的证书，即插件包根目录下的两个文件：
| 文件 | 内容 |
|---|---|
plugin.signer | 签名密钥的 minisign 公钥，与 .pub 文件相同。 |
plugin.signer.minisig | 主密钥对该文件的签名。 |
签名的可信注释指明这把密钥可以签名的那一个插件：
signer:io.github.example.mydnsnginx-ui plugin key init --id <插件 ID> 一次写出所有文件：
| 文件 | 存放位置 |
|---|---|
primary.key | 离线存储或密码管理器，并做好备份。不要放进代码仓库或 CI。 |
primary.pub | 其中 base64 的那一行就是目录条目的 author_public_key。 |
signing.key | CI 的 secret。 |
signing.pub | 无需特别保存，证书中已包含它。 |
plugin.signer、plugin.signer.minisig | 放在插件源码旁边，pack 和 sign 会把它们打进每个插件包。 |
除非 NGINX_UI_PLUGIN_PRIMARY_PASSWORD 或 NGINX_UI_PLUGIN_SIGN_PASSWORD 中设置了密码，私钥以不加密的形式写出，并且只有所有者可读。之后可以用 minisign -C -s primary.key 加上密码。
也可以只用 minisign 生成同样的文件：
minisign -G -p primary.pub -s primary.key
minisign -G -p signing.pub -s signing.key
cp signing.pub plugin.signer
minisign -S -m plugin.signer -x plugin.signer.minisig -s primary.key \
-t "signer:io.github.example.mydns"在用 signing.key 签名之前，两个证书文件要原样放进每个插件包，让 plugin.sums 列出它们。一把签名密钥可以为多个插件签名，每个插件各有一份证书：nginx-ui plugin key certify signing.pub --id <另一个插件 ID> --primary primary.key。
当 Nginx UI 信任的该插件包的主密钥能验证证书、可信注释指明的是插件包本身的插件，并且目录条目的 revoked_signers 中没有这把签名密钥时，Nginx UI 接受这份证书。这时插件包是 community，并以主密钥记录。证书验证失败本身不会带来信任：插件包按实际签名它的密钥判断。
更换与吊销签名密钥
例行更换或换了电脑时，新建一把由主密钥认证的签名密钥，再用它为下一个版本签名即可：
nginx-ui plugin key rotate --id io.github.example.mydns --primary primary.key --force目录条目不需要改动，旧版本仍然依靠各自携带的证书通过验证。
签名密钥可能已经泄露时，在开发者中心中该插件的签名者页面吊销它，这会把它的密钥 ID 加入目录条目的 revoked_signers，无需审核。对于你自己的插件目录，nginx-ui plugin key revoke signing.pub 会给出要添加的那一行。Nginx UI 不再信任由它签名的插件包，插件目录也会把由它签名的版本标记为已撤回，正在运行这些版本的节点会收到更新提示。
主密钥不能用这种方式更换。换成新的 author_public_key 后，所有旧版本都不再有可信的签名，所以请离线保存并备份主密钥。
合作伙伴插件
与 Nginx UI 项目合作的组织用自己的密钥签名，项目用官方插件签名密钥为这个密钥担保。它们的插件包在任何 Nginx UI 上都能得到 verified，即使该 Nginx UI 从未见过这个合作伙伴。
合作伙伴证书
合作伙伴的插件包带有其密钥的证书，即插件包根目录下的两个文件：
| 文件 | 内容 |
|---|---|
plugin.partner | 合作伙伴的 minisign 公钥，格式与 .pub 文件相同。 |
plugin.partner.minisig | 项目官方插件签名密钥对该文件的签名。 |
签名的可信注释写明合作伙伴的名称，还可以写明证书的最后有效日期：
partner:example-corp
partner:example-corp;expires:2027-09-30名称使用字母、数字、点和连字符。日期是 UTC 日历日期：证书在当天结束前一直有效。项目使用 nginx-ui plugin certify 签发证书，并为证书设置过期日期。
合作伙伴在为每个插件包签名之前，把这两个文件原样复制进去，使 plugin.sums 列出它们。一个证书适用于该密钥签名的所有插件包；续期的证书是修改过的文件，需要重新签名。
证书满足以下条件时才会被 Nginx UI 接受：plugin.partner 是有效的公钥，官方插件签名密钥验证了对它的签名，注释符合上述格式，证书未过期，且密钥未被吊销。不通过的证书不提供合作伙伴信任，但它本身永远不会使插件包无效：插件包会退回到其他信任来源。
合作伙伴密钥环
项目还在官方插件目录旁边发布一个签名的密钥环 https://plugins.nginxui.com/v1/partners.json，列出合作伙伴密钥和已吊销的密钥 ID。Nginx UI 刷新插件目录时会一起刷新它，把最近一份有效的副本保存在磁盘上，并且从不接受更旧的版本。密钥环中列出的密钥即使没有证书也能得到 verified；被它吊销的密钥无论插件包带有什么证书，都不会再得到 verified。吊销不会改变已安装插件的等级，但由被吊销密钥签名的更新会作为降级被拒绝。
开发者模式
注意
开发者模式位于 偏好设置 > 插件，默认关闭。开启后，Nginx UI 会从所有来源安装未签名的插件包，并把它们的发布者标记为未确认。它永远不会接受无效的插件包，不会放宽社区插件策略，也不会让未签名的插件参与自动更新。只在开发期间开启它。