一、介绍
Traefik插件架构使开发人员可以轻松创建新插件、修改现有插件以及与 Traefik 社区共享插件。
Traefik 插件是使用Go 语言开发的，而Traefik中间件插件只是一个Go 包，它提供了一个http.Handler执行特定请求和响应处理的包。
然而，插件并没有被预编译和链接，而是由Yaegi 动态执行，Yaegi是一个嵌入在 Traefik 应用程序代理中的 Go 解释器。
这意味着插件不需要编译，也不需要复杂的工具链来开始。开发 Traefik 插件的过程可与 Web 浏览器扩展相媲美。插件可能会以不希望的方式修改 Traefik 的行为.向生产 Traefik 实例添加新插件时要小心.
二、封装插件
如Traefik 使用插件(五)中所述，Traefik 管理员可以从 Traefik Pilot 仪表板的目录中浏览插件并将其添加到他们的实例中。
从技术角度来看，每个插件的实际代码都存储和托管在一个公共的GitHub仓库中。每隔30分钟，Traefik Pilot就会轮询GitHub，找到符合Traefik插件标准的仓库，并将它们添加到目录中。
2.1 前提条件
为了被 Traefik Pilot 识别，你的插件存储库必须满足以下条件：
traefik-plugin必须设置主题.traefik.yml清单必须存在并具有有效的内容
此外，Traefik Pilot从Go模块代理处获取你的源代码，所以你的插件必须使用git tag进行版本控制！
如果你的资源库不能满足这些前提条件，Traefik Pilot将无法识别它，你的插件将不会被添加到目录中！
2.2 插件声明
清单也是必须的，它应该被命名为.traefik.yml并存储在项目的根目录下。
这个YAML文件为Traefik Pilot提供了关于你的插件的信息，例如描述、全名等。
# 在Traefik Pilot网页用户界面上显示的你的插件的名称
displayName: Name of your plugin
# 目前"中间件"是唯一可用的类型
type: middleware
# 插件的导入路径
import: github.com/username/my-plugin
# 简要描述你的插件是做什么的
summary: Description of what my plugin is doing
# 与该插件相关的图标（可选）
iconPath: foo/icon.png
bannerPath: foo/banner.png
# 插件的配置数据
# 这是必须的
# Traefik Pilot将尝试使用你提供的配置执行该插件，作为其启动有效性测试的一部分
testData:
Headers:
Foo: Bar
2.2.1 配置说明
displayName: Traefik Pilot web UI 中显示的插件名称type: 目前middleware是唯一可用的类型import：插件的导入路径summary：简要说明你的插件是做什么的testData：插件的配置数据。这是必填的，Traefik Pilot 将尝试使用你提供的配置执行该插件，作为其启动有效性测试的一部分iconPath(可选)：存储库中的本地路径，用于显示项目的图标bannerPath(可选)：存储库中的本地路径，当你在社交媒体上分享你的插件页面时，将使用该图片
项目的根目录中还应该有一个go.mod文件。Traefik Pilot 将使用此文件来验证项目的名称。
2.3 开发者模式
对于那些喜欢在将插件部署到 GitHub 之前私下开发插件的人，Traefik 还提供了一种可用于临时测试的开发人员模式。
要在开发模式下部署插件，需要同时更改静态和动态配置。静态配置必须定义模块名称（通常用于 Go 包）和Go 工作区的路径，该路径可以是存储在本地 GOPATH 环境变量或任何其他路径中的内容。动态配置必须引用标签dev。静态配置：
# 插件将从'/plugins/go/src/github.com/traefik/plugindemo'路径加载
pilot:
token: xxxxx
experimental:
devPlugin:
goPath: /plugins/go
moduleName: github.com/traefik/plugindemo
动态配置：
http:
routers:
my-router:
rule: host(`demo.localhost`)
service: service-foo
entryPoints:
- web
middlewares:
- my-plugin
services:
service-foo:
loadBalancer:
servers:
- url: http://127.0.0.1:5000
middlewares:
my-plugin:
plugin:
dev:
headers:
Foo: Bar
注意：一次只能在dev模式下测试一个插件，并且在使用dev模式时，Traefik将在30分钟后关闭
三、自定义开发插件
插件包必须定义以下导出的Go对象：
- 一个
type Config struct { ... }结构体，里面字段任意 - 一个函数
func CreateConfig() *Config - 一个函数
func New(ctx context.Context, next http.Handler, config *Config, name string) (http.Handler, error)
// 打包example（一个插件的例子）
package example
import (
"context"
"net/http"
)
// 插件的配置
type Config struct {
// ...
}
// 创建默认的插件配置
func CreateConfig() *Config {
return &Config{
// ...
}
}
// 示例一个插件
type Example struct {
next http.Handler
name string
// ...
}
// New一个新的插件
func New(ctx context.Context, next http.Handler, config *Config, name string) (http.Handler, error) {
// ...
return &Example{
// ...
}, nil
}
func (e *Example) ServeHTTP(rw http.ResponseWriter, req *http.Request) {
// ...
e.next.ServeHTTP(rw, req)
}
3.1 额外的依赖
如果你的插件有任何外部模块依赖，它们必须被vendored并包含在GitHub仓库中，不支持Go modules
四、疑难解答
如果你的插件在集成过程中出现问题，Traefik Pilot将在您的GitHub仓库中创建一个issue来解释这个问题，并将停止尝试添加你的插件，直到你关闭了此issue。
为了让 Traefik Pilot 成功导入你的插件，请查阅以下清单：
- 仓库必须设置
traefik-plugin主题 - 项目的根目录中必须有一个
.traefik.yml文件描述您的插件，并且它必须具有testData用于测试目的的有效属性 - 项目的根目录必须有一个有效的
go.mod文件 - 项目必须有一个
git tag版本 - 如果你的插件有任何外部模块依赖，它们必须被vendored并包含在GitHub仓库中，不支持Go modules
五、示例代码
完整的demo插件例子：plugindemo