verdaccio/website/translated_docs/zh-CN/plugins.md

id	title
plugins	插件

Verdaccio是一个可插入式应用程序。它可以通过多种方式扩展，可以是新的认证方法，添加端点或者使用定制存储。

如果您感兴趣开发自己的插件，请阅读开发部分。

用法

安装

$> npm install --global verdaccio-activedirectory

作为一个sinopia的分支项目，verdaccio和兼容sinopia@1.4.0的插件具有向后兼容性。在这种情况下，安装方式相同。

$> npm install --global sinopia-memory

配置

打开config.yaml文件并按如下说明更新auth部分：

默认配置如下所示，由于在默认情况下我们使用一个内置的htpasswd插件，我们可以通过注释下面几行代码来禁用它：

Auth插件配置

 htpasswd:
    file: ./htpasswd
    #max_users: 1000

如果你决定使用ldap插件，将上述部分进行替换。

auth:
  activedirectory:
    url: "ldap://10.0.100.1"
    baseDN: 'dc=sample,dc=local'
    domainSuffix: 'sample.local'

多个Auth插件

This is tecnically possible, making the plugin order important, as the credentials will be resolved in order.

auth:
  htpasswd:
    file: ./htpasswd
    #max_users: 1000
  activedirectory:
    url: "ldap://10.0.100.1"
    baseDN: 'dc=sample,dc=local'
    domainSuffix: 'sample.local'

中间件插件配置

这是一个如何设置中间件插件的示例。所有的中间件插件必须被定义在middlewares命名空间。

middlewares:
  audit:
    enabled: true

您可以跟着audit middle plugin（审核中间插件）的基本范例。

存储插件配置

这是一个如何设置存储插件的示例。所有的存储插件必须在store命名空间进行定义。

store:
  memory:
    limit: 1000

如果您定义定制存储，配置文件中的存储属性将会被忽略。

旧式插件

Sinopia插件

(兼容所有版本)

• sinopia-npm：支持npm注册表的sinopia认证插件。
• sinopia-memory：在内存中缓存用户的sinopia认证插件。
• sinopia-github-oauth-cli。
• sinopia-crowd：支持atlassian crowd的sinopia认证插件。
• sinopia-activedirectory：sinopia Active Directory认证插件。
• sinopia-github-oauth：sinopia2的认证插件，支持github oauth web flow。
• sinopia-delegated-auth：将认证代理给另一个HTTP URL的Sinopia认证插件。
• sinopia-altldap：另一个Sinopia LDAP认证插件
• sinopia-request：一个简单易用且功能齐全的认证插件，可以通过配置使用外部API。
• sinopia-htaccess-gpg-email：使用htaccess格式生成密码，通过GPG加密并通过MailGun API发送给用户。
• sinopia-mongodb：一个易用且功能齐全的认证插件，可通过配置使用mongodb数据库。
• sinopia-htpasswd：支持htpasswd格式的sinopia认证插件。
• sinopia-leveldb：针对Sinopia private npm的基于leveldb的Sinopia认证插件。
• sinopia-gitlabheres：sinopia Gitlab认证插件。
• sinopia-gitlab：sinopia Gitlab认证插件。
• sinopia-ldap：sinopia LDAP认证插件。
• sinopia-github-oauth-env：基于github oauth web flow的Sinopia认证插件。

所有sinopia 插件都应该和所有verdaccio将来版本兼容。 无论如何，我们鼓励贡献者们迁移到 modern verdaccio API并使用 verdaccio-xx-name为前缀。

Verdaccio插件

(兼容2.1.x及以后版本)

授权插件

• verdaccio-bitbucket：verdaccio Bitbucket认证插件。
• verdaccio-ldap：verdaccio LDAP认证插件。
• verdaccio-active-directory：verdaccio Active Directory认证插件
• verdaccio-gitlab：使用Gitlab的Personal Access Token进行认证
• verdaccio-htpasswd：基于(内置)htpasswd文件插件的verdaccio认证插件
• verdaccio-github-oauth: verdaccio 的Github oauth认证插件。
• verdaccio-github-oauth-ui: verdaccio登录按钮的GitHub OAuth 插件。

中间件插件

• verdaccio-audit：支持npm audit cli的verdaccio插件(内置) (自3.x版本后兼容)

• verdaccio-profile-api：该插件支持npm profilecli，以及针对基于verdaccio-htpasswd认证的npm profile set password插件。

存储插件

(兼容自3.x及以后版本)

• verdaccio-memory在内存中装载包的存储插件
• verdaccio-s3-storage在Amazon S3中存储包的存储插件
• verdaccio-google-cloud在Google Cloud Storage中存储包的存储插件

警告

并不是所有这些插件都被持续测试过，其中有些可能根本无法正常工作。 如果您发现任何问题，请随时通知每个插件的所有者。