release: harden plugin deployment and recovery

2026-08-30 13:14:22 +08:00
parent ada4ab3c21
commit d3ff9be315
16 changed files with 259 additions and 50 deletions
@@ -13,7 +13,7 @@ PLUGIN_PORT=8091 \
 go run .
 ```

-本地后端可打开 `http://127.0.0.1:8091/healthz` 进行服务契约调试；生产浏览器入口应从 Plugin Admin 的订阅模块路由进入。生产环境应通过 HTTPS 反向代理，并设置 `PLUGIN_COOKIE_SECURE=true`。默认情况下本服务只暴露健康检查、就绪检查和交接页，不暴露第二套登录、Cookie 或 Core 数据 API。`PLUGIN_STANDALONE_AUTH=true` 仅在 `PLUGIN_ENV=development` 且监听地址为 loopback 时生效，生产必须保持关闭。
+本地后端可打开 `http://127.0.0.1:8091/healthz` 进行服务契约调试；生产浏览器入口应从 Plugin Admin 的订阅模块路由进入。生产环境应通过 HTTPS 反向代理，并设置 `PLUGIN_COOKIE_SECURE=true`。默认情况下本服务只暴露健康检查、就绪检查和交接页，不暴露第二套登录、Cookie 或 Core 数据 API。`PLUGIN_STANDALONE_AUTH=true` 仅在 `PLUGIN_ENV=development` 且监听地址为 loopback 时生效；该开发兼容模式会创建模块 Cookie，生产必须保持关闭。

 ## V1 范围

@@ -78,8 +78,9 @@ node --check ui/app.js
 ```

 脚本生成 `dist/qiu.subscription-admin.s2plugin`，包内根文件名为
-`manifest.json`，并包含清单声明哈希的 UI 文件。该模块采用外部服务模式：
-安装后先独立启动 `subscription-admin`，再在 `plugin-admin` 的配置中填写
+`manifest.json`，并包含清单声明哈希的 UI 文件。该模块采用外部服务模式；
+归档只携带清单和 UI 资源，不会替部署者启动后端。安装后先独立启动
+`subscription-admin`（或由 systemd 持续运行），再在 `plugin-admin` 的配置中填写
 `service_url`（插件 loopback 地址），并为 Plugin Admin 设置
 `PLUGIN_PUBLIC_URL`（例如 `https://CORE_ORIGIN/extensions/qiu.plugin-admin`）。
 然后执行启用、健康检查和菜单应用。浏览器前端由 `plugin-admin` 统一挂载并共享