# @grafana/sign-plugin 中文文档

规范地址：https://npmcn.com/package/%40grafana/sign-plugin/

版本：4\.0\.0
npm 元数据更新时间：2026-10-22T08:25:37.066Z
中文译文更新时间：2026-11-16T21:53:18.088Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40grafana/sign-plugin
原文对照：https://npmcn.com/package/%40grafana/sign-plugin/?lang=original
项目主页：https://github.com/grafana/plugin-tools#readme
源码仓库：https://github.com/grafana/plugin-tools

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：70 kB，34 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=24\.5\.0
- 运行依赖：1 个
- 首次发布：2022-10-28T10:59:18.745Z
- 最新版本发布：2026-10-22T08:25:35.800Z
- 近 30 天下载量：104154（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：167（近 12 个月 21 个）

## 中文简介

轻松地签名 Grafana 插件 .

## 安装

```sh
npm install @grafana/sign-plugin
```

也可以使用：`pnpm add @grafana/sign-plugin`、`yarn add @grafana/sign-plugin`、`bun add @grafana/sign-plugin`

## README

# Grafana / 签名插件

轻松地签名 Grafana 插件 .

**毒性**

-   [Grafana / 签名插件](https://npmcn.com/package/%40grafana/sign-plugin/#readme-grafana--sign-plugin)
    -   [签名插件](https://npmcn.com/package/%40grafana/sign-plugin/#readme-signing-a-plugin)
        -   [签名一个公共插件](https://npmcn.com/package/%40grafana/sign-plugin/#readme-sign-a-public-plugin)
        -   [签名私有插件](https://npmcn.com/package/%40grafana/sign-plugin/#readme-sign-a-private-plugin)
            -   [`npx`](https://npmcn.com/package/%40grafana/sign-plugin/#readme-npx)
            -   [`yarn` ( > 2.x) (中文(简体) )](https://npmcn.com/package/%40grafana/sign-plugin/#readme-yarn--2x)
    -   [要求和代理配置](https://npmcn.com/package/%40grafana/sign-plugin/#readme-requirements-and-proxy-configuration)
    -   [捐款](https://npmcn.com/package/%40grafana/sign-plugin/#readme-contributing)

**`@grafana/sign-plugin`** 工作在macOS,Windows和Linux上.  
如果事情不成功 [提交问题](https://github.com/grafana/plugin-tools/issues/new)。 。 。 .  
如果你有问题或需要帮助,请问 [GitHub 讨论](https://github.com/grafana/plugin-tools/discussions)。 。 。 .

## 签名插件

签名插件可以让Grafana通过签名验证来验证插件的真实性. 这让用户可以确保插件没有被篡改。 所有由Grafana Labs授权的插件,包括Enterprise插件,都签名.

自格拉法纳7.0起,所有插件都需要签名.

请参考 [签名插件文档](https://grafana.com/developers/plugin-tools/publish-a-plugin/sign-a-plugin) 来理解如何签署 Grafana 插件。 此处为发展目的提及以下命令.

### 签名一个公共插件

在您的插件目录中, 请用您的 Grafana 访问策略符签名 。 Grafana 签名插件在您的插件的 Dist 目录中创建了 MANIFEST.txt 文件 .

```bash
export GRAFANA_ACCESS_POLICY_TOKEN=<YOUR_GRAFANA_ACCESS_POLICY_TOKEN>
npx @grafana/sign-plugin@latest
```

如果插件分发目录与默认不同 `dist`,指定要与 `--distDir` 旗帜.

```bash
export GRAFANA_ACCESS_POLICY_TOKEN=<YOUR_GRAFANA_ACCESS_POLICY_TOKEN>
npx @grafana/sign-plugin@latest --distDir path/to/directory
```

### 签名私有插件

在您的插件目录中, 运行以下来创建您插件的 Dist 目录中的 MANIFEST. txt 文件 .

```bash
npx @grafana/sign-plugin@latest --rootUrls https://example.com/grafana
```

替代品:

#### [`npx`](https://github.com/npm/npx)

```bash
npx @grafana/sign-plugin@latest
```

#### [`yarn`](https://yarnpkg.com/cli/dlx) ( > 2.x) (中文(简体) )

```bash
yarn dlx @grafana/sign-plugin@latest
```

## 要求和代理配置

从v4开始, `@grafana/sign-plugin` 需要节点,js 24.15.0 或以后.

要通过 HTTP 或 HTTPS 代理签名, 设置 `HTTPS_PROXY` 在运行签名命令之前 :

```bash
export HTTPS_PROXY=http://proxy.example.com:8080
export NO_PROXY=localhost,127.0.0.1
```

代理 URL 必须包含 `http://` 或者说 `https://`。以 URL 支持基本的代理认证,例如 `http://username:password@proxy.example.com:8080`小写 `https_proxy` 财务报告和审定财务报表 `no_proxy` 优于大写对应的. `NO_PROXY` 接受逗号分隔主机或模式绕过代理机。 你不需要设置 `NODE_USE_ENV_PROXY`。 。 。 .

### 打破 v4 中的变化

从v4开始, `@grafana/sign-plugin` 使用节点.js 内置代理支持而不是 `proxy-agent`数字 :

-   早于24.1.5.0的Node.js版本不再被支持.
-   PAC文件和SOCKS代理不再支持. 直接配置 HTTP 或 HTTPS 代理 .
-   `ALL_PROXY` 不再读取。 将 HTTP 或 HTTPS 代理 URL 移动到 `HTTPS_PROXY`。 。 。 . `HTTP_PROXY` 单靠自己无法配置 HTTPS 签名请求 .
-   没有计划的代理 URL 不再被支持 。 添加 `http://` 或者说 `https://`。 。 。 .
-   空格分隔 `NO_PROXY` 不再支持条目。 用逗号代替。 参见 [节点.js 代理文档](https://nodejs.org/docs/latest-v24.x/api/http.html#built-in-proxy-support) 用于匹配规则.

## 捐款

我们总是感谢大家的贡献! 见 [捐款额](https://npmcn.com/package/CONTRIBUTING.md) 更多信息.

## 常见问题

### @grafana/sign-plugin 是什么？

轻松地签名 Grafana 插件 \.

### 如何安装 @grafana/sign-plugin？

在项目目录运行 npm install @grafana/sign-plugin，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 sign-plugin，可以用 npx sign-plugin 直接运行。

### @grafana/sign-plugin 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/grafana\_\_sign-plugin 是否存在。

### @grafana/sign-plugin 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @grafana/sign-plugin 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=24\.5\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @grafana/sign-plugin 可以商用吗？

@grafana/sign-plugin 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @grafana/sign-plugin 的下载量有多少？

根据 npm 官方下载统计，@grafana/sign-plugin 在 2026/10/17 – 2026/11/15 这 30 天内被下载 104,154 次，日均约 3,472 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @grafana/sign-plugin 还在维护吗？

最新版本 4\.0\.0 发布于 2026/10/22（25 天前）；至今共发布 167 个版本，其中过去 12 个月发布了 21 个；首次发布于 2022/10/28。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

