# @digitalist-open-cloud/backstage-plugin-harbor-backend 中文文档

规范地址：https://npmcn.com/package/%40digitalist-open-cloud/backstage-plugin-harbor-backend/

版本：0\.9\.0
npm 元数据更新时间：2025-09-04T14:22:03.277Z
中文译文更新时间：2026-11-12T10:33:39.228Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40digitalist-open-cloud/backstage-plugin-harbor-backend
原文对照：https://npmcn.com/package/%40digitalist-open-cloud/backstage-plugin-harbor-backend/?lang=original

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

- 包体积（解压后）：39.4 kB，17 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：11 个
- 首次发布：2024-07-18T20:36:28.840Z
- 最新版本发布：2025-09-04T14:22:03.075Z
- 近 30 天下载量：2549（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：25（近 12 个月 0 个）

## 中文简介

此插件将显示有关您在港湾内嵌入图像的信息 .

## 安装

```sh
npm install @digitalist-open-cloud/backstage-plugin-harbor-backend
```

也可以使用：`pnpm add @digitalist-open-cloud/backstage-plugin-harbor-backend`、`yarn add @digitalist-open-cloud/backstage-plugin-harbor-backend`、`bun add @digitalist-open-cloud/backstage-plugin-harbor-backend`

## README

# 后台港湾后端插件

此插件将显示有关您在港湾内嵌入图像的信息 .

这是一个分叉,没有向后兼容的承诺。 但已经在后台1.29.x(本插件0.4.2版)和1.37.x(0.6.0版)上进行了测试.

关于原始代码,请参见: [GitHub 重传](https://github.com/container-registry/backstage-plugin-harbor-backend)

## 开始

第一届 [安装前端](https://github.com/Digitalist-Open-Cloud/backstage-plugin-harbor)

### 启用后端

### 后端

```bash
yarn --cwd packages/backend add @digitalist-open-cloud/backstage-plugin-harbor-backend
```

添加为 `packages/backend/src/index.ts`数字 :

```ts
backend.add(import('@digitalist-open-cloud/backstage-plugin-harbor-backend'))
```

现在,跳到配置步骤.

## 配置

插件需要在后台的 App-config.yaml 中配置才能连接到港湾API.

```yaml
harbor:
  # This is the traditional way of configuring the Harbor plugin.
  baseUrl: https://harbor.yourdomain.com
  username: ${HARBOR_USERNAME}
  password: ${HARBOR_PASSWORD}

  # This is the way to go if you need to connect to multiple Harbor instances. You can also combine those approaches.
  instances:
    - host: harbor2.yourdomain.com
      baseUrl: https://harbor2.yourdomain.com
      username: ${HARBOR_USERNAME}
      password: ${HARBOR_PASSWORD}
```

在您的组件文件中添加注释和值 .

```yaml
apiVersion: backstage.io/v1alpha1
kind: System
metadata:
  name: sample-system
  description: "A sample system"
  annotations:
    # This will use harbor.baseUrl
    goharbor.io/repository-slug: project/repository
    # OR
    # This will use harbor.instances[].baseUrl based on the matching host
    goharbor.io/repository-slug: harbor.yourdomain.com/project/repository
    # OR
    # This will fetch the first image from harbor.baseUrl and the second image from harbor.instances[].baseUrl
    goharbor.io/repository-slug: project/repository, harbor.yourdomain.com/project/repository
```

## 捐款

请回捐 [原始还原](https://github.com/container-registry/),您可以自由使用任何代码 从这repo 回到原来的repo 不给我们信用.

## 历史

这个后台插件最初由 [最好的一个](https://github.com/BESTSELLER) 转至 [集装箱登记](https://github.com/container-registry/)。这个分叉是因迫切需要而启动的,并不断更新与后台的代码.

## 常见问题

### @digitalist-open-cloud/backstage-plugin-harbor-backend 是什么？

此插件将显示有关您在港湾内嵌入图像的信息 \.

### 如何安装 @digitalist-open-cloud/backstage-plugin-harbor-backend？

在项目目录运行 npm install @digitalist-open-cloud/backstage-plugin-harbor-backend，或使用 pnpm add / yarn add / bun add。

### @digitalist-open-cloud/backstage-plugin-harbor-backend 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @digitalist-open-cloud/backstage-plugin-harbor-backend 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @digitalist-open-cloud/backstage-plugin-harbor-backend 可以商用吗？

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

### @digitalist-open-cloud/backstage-plugin-harbor-backend 的下载量有多少？

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

### @digitalist-open-cloud/backstage-plugin-harbor-backend 还在维护吗？

最新版本 0\.9\.0 发布于 2025/09/04（1\.2 年前）；至今共发布 25 个版本，其中过去 12 个月发布了 0 个；首次发布于 2024/07/19。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。