外观

插件市场与离线安装 ​

插件市场用于查找和安装扩展；插件管理用于配置、启停和维护已安装的插件。先阅读适用版本与功能范围。

1. 配置市场来源 ​

部署者在面板的 ZBoard YAML 配置中填写插件目录、市场地址和可信发布者公钥：

yaml
plugins:
  directory: /var/lib/zboard/plugins
  catalog_url: "https://YOUR_CATALOG_HOST/catalog.json"
  trusted_publishers:
    your.publisher: "BASE64_ED25519_PUBLIC_KEY"

将示例域名、发布者 ID 和公钥替换为实际值。市场地址来自你选择的分发方；trusted_publishers 的公钥应通过发布者的可信渠道获取，不能把插件附带的陌生公钥直接当作已受信任的来源。

市场目录不是 GitHub 仓库首页或任意下载页面。它必须符合 ZBoard 的签名目录格式；当前下载要求公开 HTTPS、443 端口，不接受重定向或内网地址。提供目录的方法见开发指南。

使用 Docker 时，将自定义 YAML 挂载到 /app/etc/zboard.yaml，并将插件目录持久化到 /var/lib/zboard/plugins。应在已有应用配置中增加这些字段，保留其他配置。修改部署配置和可信公钥后重启面板；正常安装、配置和启停插件无需重启。挂载方法见存储与备份。

只使用离线安装时可以让 catalog_url 为空，但仍需配置可信发布者。

2. 从市场安装 ​

  1. 打开后台的“扩展中心 → 插件市场”。
  2. 查看插件名称、发布者、版本、说明及能力要求。
  3. 打开详情并执行安装，等待面板下载和校验完成。
  4. 到“插件管理”查看安装结果，按插件说明完成配置后启用。

首次安装默认停用。安装成功表示包已通过宿主校验并保存，不代表插件已经启用或外部服务连接正常。

3. 离线安装 ​

  1. 从可信发布者获取 .zbplugin 文件。
  2. 在“扩展中心 → 插件管理”使用离线导入入口上传文件。
  3. 检查安装结果，完成配置并启用。

离线安装与市场安装执行相同的签名、内容摘要和能力检查，不会跳过发布者校验。

4. 配置、启停和更新 ​

在插件详情中查看概览、版本和操作结果。需要配置的插件由插件配置页收集参数，保存后使用配置测试入口检查结果。

安装新版本前阅读发布者说明；更新失败时面板保留原安装及数据。停用会停止插件运行并撤销其页面会话，已完成的核心订单或订阅操作不会因插件停用而撤销。卸载与清除插件数据是不同操作，具体保留策略见插件生命周期。

常见问题 ​

现象检查方向
没有插件市场入口所用版本是否包含插件支持，以及当前账号是否为管理员。
市场提示未配置部署 YAML 中是否提供了目录地址和可信发布者。
签名或发布者校验失败包的发布者 ID、公钥和来源是否匹配，文件是否完整。
不支持某项能力插件需要的宿主接口是否在当前构建中开放；不能通过修改包声明绕过。
安装成功但看不到扩展页面插件是否已经配置并启用，页面属于公开端、用户端还是管理端。
插件服务启动失败插件是否包含与容器平台匹配的服务程序，查看插件详情中的操作结果。

更多说明见安装信任。开发者需要包格式、签名与发布流程时，阅读插件开发。

ZeroDeNet