开发插件：DNS提供者

英文原文：https://github.com/mholt/caddy/wiki/Writing-a-Plugin:-DNS-Provider

加入Caddy交流论坛和其他开发者一起分享。

Caddy通过三种方式神奇地获得站点的TLS证书：HTTP、TLS-SNI和DNS。前两个是默认使用的，可以在不需要你干预的情况下完成。第三种方法在某些环境中更加通用，在这些环境中，你不能启动外部网络可以访问的侦听器等等。问题是，使用DNS方法需要定制代码与你的域的名称服务器指向的DNS提供者交互。

Caddy使用xenolf/lego实现ACME协议并解决领域挑战(lego最初是为Caddy编写的)。它支持可插入的DNS提供者，但要在Caddy中使用它们，必须对它们进行调整。它只需要几行代码。

如果你想添加一个新的DNS提供者，那么必须构建它来与lego一起工作(有关说明和文档，请参阅代码库)。一旦这管用了，你可以很容易让与Caddy适配：

  1. package myprovider
  3. import (
  4.     "errors"
  6.     "github.com/mholt/caddy/caddytls"
  7.     "github.com/xenolf/lego/providers/dns/myprovider"
  8. )
  10. func init() {
  11.     caddytls.RegisterDNSProvider("myprovider", NewDNSProvider)
  12. }
  14. // NewDNSProvider returns a new MyProvider DNS challenge provider.
  15. // The credentials are interpreted as follows:
  16. //
  17. // len(0): use credentials from environment
  18. // len(2): credentials[0] = API user
  19. //         credentials[1] = API key
  20. func NewDNSProvider(credentials ...string) (caddytls.ChallengeProvider, error) {
  21.     switch len(credentials) {
  22.     case 0:
  23.         return myprovider.NewDNSProvider()
  24.     case 2:
  25.         return myprovider.NewDNSProviderCredentials(credentials[0], credentials[1])
  26.     default:
  27.         return nil, errors.New("invalid credentials length")
  28.     }
  29. }

注意，我们不直接将DNS提供者插入到caddy包中；我们把它插进Caddy。

你可以在caddyserver/dnsproviders中看到所有正式支持的适配器。如果你已经编写了一个DNS提供商，请随时提交一个Pull请求去适配它，供Caddy使用！

一旦你的提供者被插入，你可以在Caddyfile这样使用它：

  1. tls {
  2.     dns myprovider
  3. }

就是这样。