CoreDNSプラグイン開発入門

## CoreDNSとは何か？
CoreDNSは、Go言語で実装された柔軟で拡張可能なDNSサーバーです ([CoreDNS の仕組みとプラグイン - ストイックに生きたい](https://blog.sakamo.dev/post/coredns-plugins/#:~:text=CoreDNS%20%E3%81%AF%E3%80%81Go%20%E3%81%A7%E5%AE%9F%E8%A3%85%E3%81%95%E3%82%8C%E3%81%9F%20DNS%20%E3%82%B5%E3%83%BC%E3%83%90%E3%83%BC%E3%81%A7%E3%81%82%E3%82%8A%E3%80%81Kubernetes,%E3%81%AE%20DNS%20%E3%82%B5%E3%83%BC%E3%83%90%E3%83%BC%E3%81%A8%E3%81%97%E3%81%A6%E3%82%82%E5%88%A9%E7%94%A8%E3%81%95%E3%82%8C%E3%81%A6%E3%81%84%E3%82%8B%E3%80%82%20%E7%89%B9%E5%BE%B4%E7%9A%84%E3%81%AA%E4%BB%95%E7%B5%84%E3%81%BF%E3%81%A8%E3%81%97%E3%81%A6%E3%80%81%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%81%A8%E3%81%84%E3%81%86%E4%BB%95%E7%B5%84%E3%81%BF%E3%81%8C%E3%81%82%E3%82%8A%E3%80%81%E6%AE%86%E3%81%A9%E3%81%AE%E6%A9%9F%E8%83%BD%E3%81%AF%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%81%A7%E5%AE%9F%E8%A3%85%E3%81%95%E3%82%8C%E3%81%A6%E3%81%8A%E3%82%8A%E3%80%81%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%82%92%E8%87%AA%E5%88%86%E3%81%A7%E5%AE%9F%E8%A3%85%E3%81%99%E3%82%8B%E3%81%93%E3%81%A8%E3%82%82%E5%8F%AF%E8%83%BD%E3%81%A7%E3%81%82%E3%82%8B%E3%80%82)) ([Using CoreDNS for Service Discovery | Kubernetes](https://kubernetes.io/docs/tasks/administer-cluster/coredns/#:~:text=About%20CoreDNS))。もともとCaddyサーバーの仕組みを基に構築されており、**CoreDNS自体のほとんどの機能は「プラグイン」** として提供されています ([CoreDNS の仕組みとプラグイン - ストイックに生きたい](https://blog.sakamo.dev/post/coredns-plugins/#:~:text=CoreDNS%20%E3%81%AF%E3%80%81Go%20%E3%81%A7%E5%AE%9F%E8%A3%85%E3%81%95%E3%82%8C%E3%81%9F%20DNS%20%E3%82%B5%E3%83%BC%E3%83%90%E3%83%BC%E3%81%A7%E3%81%82%E3%82%8A%E3%80%81Kubernetes,%E3%81%AE%20DNS%20%E3%82%B5%E3%83%BC%E3%83%90%E3%83%BC%E3%81%A8%E3%81%97%E3%81%A6%E3%82%82%E5%88%A9%E7%94%A8%E3%81%95%E3%82%8C%E3%81%A6%E3%81%84%E3%82%8B%E3%80%82%20%E7%89%B9%E5%BE%B4%E7%9A%84%E3%81%AA%E4%BB%95%E7%B5%84%E3%81%BF%E3%81%A8%E3%81%97%E3%81%A6%E3%80%81%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%81%A8%E3%81%84%E3%81%86%E4%BB%95%E7%B5%84%E3%81%BF%E3%81%8C%E3%81%82%E3%82%8A%E3%80%81%E6%AE%86%E3%81%A9%E3%81%AE%E6%A9%9F%E8%83%BD%E3%81%AF%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%81%A7%E5%AE%9F%E8%A3%85%E3%81%95%E3%82%8C%E3%81%A6%E3%81%8A%E3%82%8A%E3%80%81%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%82%92%E8%87%AA%E5%88%86%E3%81%A7%E5%AE%9F%E8%A3%85%E3%81%99%E3%82%8B%E3%81%93%E3%81%A8%E3%82%82%E5%8F%AF%E8%83%BD%E3%81%A7%E3%81%82%E3%82%8B%E3%80%82))。たとえばゾーンファイルの提供やキャッシュ、メトリクス収集といった機能はすべてプラグインとして実装されており、必要なプラグインを組み合わせてDNSサーバーの振る舞いをカスタマイズできます ([ Writing Plugins for CoreDNS ](https://coredns.io/2016/12/19/writing-plugins-for-coredns/#:~:text=A%20plugin%20adds%20functionality%20to,file%20serving%20are%20all%20plugins))。CoreDNSはCNCF (Cloud Native Computing Foundation) にホストされており、KubernetesクラスターのデフォルトDNSサーバー（kube-dnsの後継）としても利用されています ([CoreDNS の仕組みとプラグイン - ストイックに生きたい](https://blog.sakamo.dev/post/coredns-plugins/#:~:text=CoreDNS%20%E3%81%AF%E3%80%81Go%20%E3%81%A7%E5%AE%9F%E8%A3%85%E3%81%95%E3%82%8C%E3%81%9F%20DNS%20%E3%82%B5%E3%83%BC%E3%83%90%E3%83%BC%E3%81%A7%E3%81%82%E3%82%8A%E3%80%81Kubernetes,%E3%81%AE%20DNS%20%E3%82%B5%E3%83%BC%E3%83%90%E3%83%BC%E3%81%A8%E3%81%97%E3%81%A6%E3%82%82%E5%88%A9%E7%94%A8%E3%81%95%E3%82%8C%E3%81%A6%E3%81%84%E3%82%8B%E3%80%82%20%E7%89%B9%E5%BE%B4%E7%9A%84%E3%81%AA%E4%BB%95%E7%B5%84%E3%81%BF%E3%81%A8%E3%81%97%E3%81%A6%E3%80%81%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%81%A8%E3%81%84%E3%81%86%E4%BB%95%E7%B5%84%E3%81%BF%E3%81%8C%E3%81%82%E3%82%8A%E3%80%81%E6%AE%86%E3%81%A9%E3%81%AE%E6%A9%9F%E8%83%BD%E3%81%AF%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%81%A7%E5%AE%9F%E8%A3%85%E3%81%95%E3%82%8C%E3%81%A6%E3%81%8A%E3%82%8A%E3%80%81%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%82%92%E8%87%AA%E5%88%86%E3%81%A7%E5%AE%9F%E8%A3%85%E3%81%99%E3%82%8B%E3%81%93%E3%81%A8%E3%82%82%E5%8F%AF%E8%83%BD%E3%81%A7%E3%81%82%E3%82%8B%E3%80%82)) ([Using CoreDNS for Service Discovery | Kubernetes](https://kubernetes.io/docs/tasks/administer-cluster/coredns/#:~:text=About%20CoreDNS))。

## CoreDNSにおけるプラグインの役割
**CoreDNSにおけるプラグイン**は、DNSサーバーの機能をモジュール単位で拡張・変更する役割を担います ([CoreDNS の仕組みとプラグイン - ストイックに生きたい](https://blog.sakamo.dev/post/coredns-plugins/#:~:text=CoreDNS%20%E3%81%AF%E3%80%81Go%20%E3%81%A7%E5%AE%9F%E8%A3%85%E3%81%95%E3%82%8C%E3%81%9F%20DNS%20%E3%82%B5%E3%83%BC%E3%83%90%E3%83%BC%E3%81%A7%E3%81%82%E3%82%8A%E3%80%81Kubernetes,%E3%81%AE%20DNS%20%E3%82%B5%E3%83%BC%E3%83%90%E3%83%BC%E3%81%A8%E3%81%97%E3%81%A6%E3%82%82%E5%88%A9%E7%94%A8%E3%81%95%E3%82%8C%E3%81%A6%E3%81%84%E3%82%8B%E3%80%82%20%E7%89%B9%E5%BE%B4%E7%9A%84%E3%81%AA%E4%BB%95%E7%B5%84%E3%81%BF%E3%81%A8%E3%81%97%E3%81%A6%E3%80%81%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%81%A8%E3%81%84%E3%81%86%E4%BB%95%E7%B5%84%E3%81%BF%E3%81%8C%E3%81%82%E3%82%8A%E3%80%81%E6%AE%86%E3%81%A9%E3%81%AE%E6%A9%9F%E8%83%BD%E3%81%AF%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%81%A7%E5%AE%9F%E8%A3%85%E3%81%95%E3%82%8C%E3%81%A6%E3%81%8A%E3%82%8A%E3%80%81%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%82%92%E8%87%AA%E5%88%86%E3%81%A7%E5%AE%9F%E8%A3%85%E3%81%99%E3%82%8B%E3%81%93%E3%81%A8%E3%82%82%E5%8F%AF%E8%83%BD%E3%81%A7%E3%81%82%E3%82%8B%E3%80%82))。プラグインを追加・有効化することで、DNSサーバーに新たな機能を簡単に組み込めます。例えば:

- **フォワード (forward) プラグイン**: 特定のドメインに対するクエリを別のDNSサーバー（例: 1.1.1.1）に転送します ([CoreDNS の仕組みとプラグイン - ストイックに生きたい](https://blog.sakamo.dev/post/coredns-plugins/#:~:text=errors%20%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%81%8C%E6%9C%89%E5%8A%B9%E3%81%A7%E3%81%AA%E3%81%84%E5%A0%B4%E5%90%88%E3%80%81%E3%83%87%E3%83%95%E3%82%A9%E3%83%AB%E3%83%88%E3%81%A7%E3%81%AF%E3%82%A8%E3%83%A9%E3%83%BC%E3%83%AD%E3%82%B0%E3%81%AF%E5%87%BA%E5%8A%9B%E3%81%95%E3%82%8C%E3%81%AA%E3%81%84%E3%81%AE%E3%81%A7%E3%80%81%E3%82%A8%E3%83%A9%E3%83%BC%E3%82%92%E7%A2%BA%E8%AA%8D%E3%81%97%E3%81%9F%E3%81%84%E3%81%AA%E3%82%89%E6%9C%89%E5%8A%B9%E3%81%AB%E3%81%97%E3%81%BE%E3%81%97%E3%82%87%E3%81%86%E3%80%82))。
- **キャッシュ (cache) プラグイン**: DNSクエリ結果をTTLに基づいてキャッシュし、高速な応答を可能にします ([CoreDNS の仕組みとプラグイン - ストイックに生きたい](https://blog.sakamo.dev/post/coredns-plugins/#:~:text=cache%20%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%81%AF%E3%80%81TTL%20%E3%82%92%E3%82%82%E3%81%A8%E3%81%AB%E3%82%AF%E3%82%A8%E3%83%AA%E3%81%AE%E7%B5%90%E6%9E%9C%E3%82%92%E3%82%AD%E3%83%A3%E3%83%83%E3%82%B7%E3%83%A5%E3%81%99%E3%82%8B%E3%81%93%E3%81%A8%E3%81%8C%E3%81%A7%E3%81%8D%E3%82%8B%E3%80%82%20%E3%81%A9%E3%81%AE%E3%82%88%E3%81%86%E3%81%AB%E3%82%AD%E3%83%A3%E3%83%83%E3%82%B7%E3%83%A5%E3%82%92%E8%A1%8C%E3%81%AA%E3%81%A3%E3%81%A6%E3%81%84%E3%82%8B%E3%81%8B%E3%81%A8%E3%81%84%E3%81%86%E3%81%A8%E3%80%81plugin%2Fcache%2Fhandler,%E3%81%8C%E5%91%BC%E3%81%B0%E3%82%8C%E3%81%A6%E3%80%81%E3%82%AD%E3%83%A3%E3%83%83%E3%82%B7%E3%83%A5%E3%81%99%E3%82%8B%E3%81%A8%E3%81%84%E3%81%86%E4%BB%95%E7%B5%84%E3%81%BF%E3%81%A7%E3%81%82%E3%82%8B%E3%80%82))。
- **ログ (log) プラグイン**: DNSクエリを標準出力に記録します。トラブルシューティングやアクセス解析に役立ちます ([CoreDNS の仕組みとプラグイン - ストイックに生きたい](https://blog.sakamo.dev/post/coredns-plugins/#:~:text=%5BINFO%5D%20127.0.0.1%3A63479%20,NOERROR%20qr%2Crd%2Cra%2Cad%2067%200.005239353s))。
- **エラー (errors) プラグイン**: サーバー内で発生したDNSエラーを検知してログに出力します ([CoreDNS の仕組みとプラグイン - ストイックに生きたい](https://blog.sakamo.dev/post/coredns-plugins/#:~:text=%5BINFO%5D%20127.0.0.1%3A63479%20,NOERROR%20qr%2Crd%2Cra%2Cad%2067%200.005239353s))。
- **リライト (rewrite) プラグイン**: クエリ名を書き換えてから処理を続行します。例として`foo.example.com`を`foo.default.svc.cluster.local`に書き換える、などの用途があります ([ How Queries Are Processed in CoreDNS ](https://coredns.io/2017/06/08/how-queries-are-processed-in-coredns/#:~:text=Consider%20this%20Corefile%3A)) ([ How Queries Are Processed in CoreDNS ](https://coredns.io/2017/06/08/how-queries-are-processed-in-coredns/#:~:text=Plugin%20that%20manipulate%20the%20request,so%20that%20clients%20don%E2%80%99t))。
- **その他**: etcd連携の**etcdプラグイン**や、後述する**kubernetesプラグイン**など、さまざまなユースケースに対応するプラグインが用意されています。

プラグインはCorefile（CoreDNSの設定ファイル）に記述することで有効化され、**記述されたプラグインの組み合わせによってDNSサーバーの動作が決定**します ([CoreDNS の仕組みとプラグイン - ストイックに生きたい](https://blog.sakamo.dev/post/coredns-plugins/#:~:text=CoreDNS%20%E3%81%A7%E3%81%AF%E3%80%81Corefile%20%E3%81%A8%E3%81%84%E3%81%86%E8%A8%AD%E5%AE%9A%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%82%92%E8%AA%AD%E3%81%BF%E8%BE%BC%E3%81%BF%E3%80%81%E3%81%9D%E3%81%AE%E8%A8%AD%E5%AE%9A%E3%81%AB%E5%BE%93%E3%81%A3%E3%81%A6%20DNS%20%E3%82%B5%E3%83%BC%E3%83%90%E3%83%BC%E3%82%92%E8%B5%B7%E5%8B%95%E3%81%99%E3%82%8B%E3%80%82)) ([CoreDNS の仕組みとプラグイン - ストイックに生きたい](https://blog.sakamo.dev/post/coredns-plugins/#:~:text=%5BINFO%5D%20127.0.0.1%3A63479%20,NOERROR%20qr%2Crd%2Cra%2Cad%2067%200.005239353s))。必要な機能だけをプラグインとして組み込み、不要な機能は外して軽量化することも可能です。このプラグイン機構によって、CoreDNSは非常に高い拡張性と柔軟性を実現しています。

## 有名なプラグイン例: Kubernetesプラグイン
数ある公式プラグインの中でも**kubernetesプラグイン**は特に有名で、Kubernetes環境におけるサービスディスカバリ（内部DNS）を実現する重要なプラグインです ([Using CoreDNS for Service Discovery | Kubernetes](https://kubernetes.io/docs/tasks/administer-cluster/coredns/#:~:text=About%20CoreDNS))。Kubernetesプラグインを有効にしたCoreDNSは、クラスタ内部のServiceやPodに対応するDNSレコードを自動的に提供します。これにより、Kubernetes内のアプリケーションは`<サービス名>.<ネームスペース>.svc.cluster.local`といった名前でお互いを名前解決できます。

**なぜKubernetesプラグインが必要か？** 従来、Kubernetesではkube-dnsというコンポーネントが内部DNSを提供していましたが、CoreDNSはその後継として採用されました ([Using CoreDNS for Service Discovery | Kubernetes](https://kubernetes.io/docs/tasks/administer-cluster/coredns/#:~:text=About%20CoreDNS))。CoreDNS本体はプラグインの組み合わせで動作を変えられるため、Kubernetesに特化したプラグインを追加するだけでクラスタDNSの要件を満たせます。kubernetesプラグインはKubernetes APIと連携し、サービスやエンドポイントの変更を監視してDNSレコードに反映します。CoreDNS起動時にはこのプラグインがKubernetes APIサーバーへの接続を確立し、リソース（ServiceやPod情報）のウォッチを開始します ([ kubernetes ](https://coredns.io/plugins/kubernetes/#:~:text=When%20CoreDNS%20starts%20with%20the,has%20not%20yet%20been%20synchronized))。初期同期が完了するまでは最大5秒間DNS応答を遅らせ、同期完了後にクエリ応答を開始します ([ kubernetes ](https://coredns.io/plugins/kubernetes/#:~:text=When%20CoreDNS%20starts%20with%20the,has%20not%20yet%20been%20synchronized))（5秒経っても同期できない場合は同期が続く間SERVFAILで応答）。このようにしてクラスタ内のリソース変化（新規サービス追加やPod消滅など）に追随し、常に最新のDNSレコードを提供します。また、エンドポイント情報取得には効率化のためKubernetesのEndpointSlices APIを利用しています ([ kubernetes ](https://coredns.io/plugins/kubernetes/#:~:text=The%20kubernetes%20plugin%20watches%20Endpoints,API))。

kubernetesプラグインは**バックエンド系プラグイン**の一例であり、外部システム（Kubernetes）をデータソースとしてDNSレコードを生成する役割を持ちます ([ How Queries Are Processed in CoreDNS ](https://coredns.io/2017/06/08/how-queries-are-processed-in-coredns/#:~:text=You%20can%20divide%20the%20plugin,are%20all%20examples%20of%20backends))。このプラグインのおかげで、Kubernetesクラスターでは各種サービスを名前でスムーズに発見でき、CoreDNSはクラウドネイティブ環境におけるサービスディスカバリの中核を担っています。

## CoreDNSプラグインの仕組み (アーキテクチャ)
CoreDNSでは、プラグインは**チェイン（鎖状）**に連結されてDNSクエリを処理します。各プラグインは順番に呼び出され、必要に応じて次のプラグインに処理を渡しながら最終的な応答を生成します ([ How Queries Are Processed in CoreDNS ](https://coredns.io/2017/06/08/how-queries-are-processed-in-coredns/#:~:text=Image%3A%20Query%20Processing)) ([ How Queries Are Processed in CoreDNS ](https://coredns.io/2017/06/08/how-queries-are-processed-in-coredns/#:~:text=You%20can%20divide%20the%20plugin,are%20all%20examples%20of%20backends))。Corefileに記述された各サーバーブロック（ゾーンごとの設定）が、内部的にはひとつのプラグインチェイン（`dnsserver.Server`）となります。問い合わせが来ると、そのクエリにマッチするゾーンのチェイン上でプラグインが順次実行されます ([ How Queries Are Processed in CoreDNS ](https://coredns.io/2017/06/08/how-queries-are-processed-in-coredns/#:~:text=Notice%20here%20that%20there%20are,visually%20in%20the%20diagram%20below)) ([ How Queries Are Processed in CoreDNS ](https://coredns.io/2017/06/08/how-queries-are-processed-in-coredns/#:~:text=Plugin%20that%20manipulate%20the%20request,so%20that%20clients%20don%E2%80%99t))。プラグインの実行順序はCoreDNSをビルドする際に決まっており、`plugin.cfg`ファイルに列挙された順番がそのままチェインの順序になります ([ How Queries Are Processed in CoreDNS ](https://coredns.io/2017/06/08/how-queries-are-processed-in-coredns/#:~:text=Image%3A%20Query%20Processing))。したがって、Corefile上の記述順と実行順が必ずしも一致しない点には注意が必要です（例えば`cache`プラグインはCorefile下部に書かれていても、ビルド時の順序で後段に配置されていれば最終処理ではありません ([ How Queries Are Processed in CoreDNS ](https://coredns.io/2017/06/08/how-queries-are-processed-in-coredns/#:~:text=Image%3A%20Query%20Processing))）。

 ([ How Queries Are Processed in CoreDNS ](https://coredns.io/2017/06/08/how-queries-are-processed-in-coredns/))CoreDNSにおけるプラグインチェインの概念図。上図のように、CoreDNSはCorefileの各サーバーブロックに対応してプラグインチェインを構成し、問い合わせは該当するチェイン上の各プラグインを順に通過して処理されます ([ How Queries Are Processed in CoreDNS ](https://coredns.io/2017/06/08/how-queries-are-processed-in-coredns/#:~:text=Notice%20here%20that%20there%20are,visually%20in%20the%20diagram%20below)) ([ How Queries Are Processed in CoreDNS ](https://coredns.io/2017/06/08/how-queries-are-processed-in-coredns/#:~:text=Image%3A%20Query%20Processing))。プラグインには種類があり、一部はリクエスト処理自体を行わず設定のために存在します（例: `root`や`startup`などは実行時の処理チェインに入らない） ([ How Queries Are Processed in CoreDNS ](https://coredns.io/2017/06/08/how-queries-are-processed-in-coredns/#:~:text=Notice%20in%20the%20,plugin))。通常のプラグインはリクエストを何らか処理した後、基本的には**次のプラグインへ処理を渡します** ([ How Queries Are Processed in CoreDNS ](https://coredns.io/2017/06/08/how-queries-are-processed-in-coredns/#:~:text=Plugin%20that%20manipulate%20the%20request,so%20that%20clients%20don%E2%80%99t))。たとえば前述のrewriteプラグインはクエリを書き換えた後で次のプラグインに渡し、チェイン後段で応答が戻ってきたら質問セクションを書き換える前の状態に戻してクライアントに返します ([ How Queries Are Processed in CoreDNS ](https://coredns.io/2017/06/08/how-queries-are-processed-in-coredns/#:~:text=Plugin%20that%20manipulate%20the%20request,so%20that%20clients%20don%E2%80%99t))。一方、バックエンド系プラグイン（例: kubernetesやfileなどゾーンデータを返すもの）はそれ自身が権威データソースとなりうるため、基本的に自分で回答（もしくはNXDOMAIN）を返してチェインを終端させます ([ How Queries Are Processed in CoreDNS ](https://coredns.io/2017/06/08/how-queries-are-processed-in-coredns/#:~:text=You%20can%20divide%20the%20plugin,are%20all%20examples%20of%20backends))。ただし、バックエンド系でも **`fallthrough`オプション** が指定されると、該当ゾーンにレコードが無い場合にNXDOMAINの代わりに次のプラグインに処理を委譲できます ([ How Queries Are Processed in CoreDNS ](https://coredns.io/2017/06/08/how-queries-are-processed-in-coredns/#:~:text=Any%20given%20backend%20is%20usually,opportunity%20to%20handle%20the%20request))。

プラグインは実装上、Goのインターフェースである`plugin.Handler`を満たすことで定義されます。`plugin.Handler`はHTTPサーバーのハンドラに似たインターフェースで、DNSクエリ用の`ServeDNS`メソッド（引数にDNSクエリとコンテキスト、レスポンスライターを取る）と`Name()`メソッド（プラグイン名を返す）から構成されています ([ Writing Plugins for CoreDNS ](https://coredns.io/2016/12/19/writing-plugins-for-coredns/#:~:text=,details%20about%20these%20return%20values)) ([ Writing Plugins for CoreDNS ](https://coredns.io/2016/12/19/writing-plugins-for-coredns/#:~:text=The%20interface%20also%20needs%20a,func%20Name%28%29%20string))。開発者はプラグインごとに構造体を定義し、このインターフェースを実装します。典型的には以下のようになります ([ Writing Plugins for CoreDNS ](https://coredns.io/2016/12/19/writing-plugins-for-coredns/#:~:text=Handlers%20are%20usually%20a%20struct,next%20Handler%20in%20the%20chain)):

```go
// プラグインのハンドラ構造体（Nextは次のプラグインへの参照）
type MyPlugin struct {
    Next plugin.Handler
    // 他に必要な設定フィールドがあれば追加
}

// プラグイン名を返す
func (m MyPlugin) Name() string { return "myplugin" }

// DNSクエリを処理するメソッド
func (m MyPlugin) ServeDNS(ctx context.Context, w dns.ResponseWriter, req *dns.Msg) (int, error) {
    // (ここで何らかの処理を行う)
    return m.Next.ServeDNS(ctx, w, req)  // 次のプラグインに処理を委ねる
}
```

上記のように、自作プラグインの`ServeDNS`内で基本は次のプラグイン (`m.Next`) の`ServeDNS`を呼び出して処理を渡します ([ Writing Plugins for CoreDNS ](https://coredns.io/2016/12/19/writing-plugins-for-coredns/#:~:text=To%20implement%20the%20,next%20handler%20in%20the%20chain))。これにより、現在のプラグインがチェイン上のフィルタのように機能します。ただし、プラグインが**最終的な応答を自分で返せる場合**（例えば特定のドメインに対して固定のIPを返すカスタムプラグインなど）は、次のプラグインを呼ばずにここで応答を返してチェインを終了しても構いません ([CoreDNS の仕組みとプラグイン - ストイックに生きたい](https://blog.sakamo.dev/post/coredns-plugins/#:~:text=ServeDNS%20%E3%81%A7%E3%81%AF%E3%80%81%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%81%8C%E5%AE%9F%E8%A1%8C%E3%81%95%E3%82%8C%E3%81%9F%E9%9A%9B%E3%81%AE%E5%87%A6%E7%90%86%E3%82%92%E5%AE%9F%E8%A3%85%E3%81%97%E3%81%A6%E3%81%84%E3%82%8B%E3%80%82%20%E3%81%BE%E3%81%9F%E3%80%81plugin,%E3%82%92%E6%84%8F%E5%9B%B3%E7%9A%84%E3%81%AB%E5%91%BC%E3%81%B3%E3%81%A0%E3%81%95%E3%81%AA%E3%81%84%E3%81%93%E3%81%A8%E3%81%A7%E3%80%81%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%83%81%E3%82%A7%E3%83%BC%E3%83%B3%E3%81%AE%E9%80%94%E4%B8%AD%E3%81%A7%E5%87%A6%E7%90%86%E3%82%92%E6%AD%A2%E3%82%81%E3%82%8B%E3%81%93%E3%81%A8%E3%81%8C%E3%81%A7%E3%81%8D%E3%82%8B%E3%80%82))。応答を返す際には、`github.com/miekg/dns`パッケージを用いてDNSメッセージを作成し（例: Aレコードの`dns.Msg`を構築）、`dns.ResponseWriter`の`WriteMsg()`でクライアントに返送します ([Developing Custom Plugins for CoreDNS - DEV Community](https://dev.to/satrobit/developing-custom-plugins-for-coredns-4jnj#:~:text=answers%20%3A%3D%20make%28)) ([Developing Custom Plugins for CoreDNS - DEV Community](https://dev.to/satrobit/developing-custom-plugins-for-coredns-4jnj#:~:text=m))。一方、次のプラグインに処理を渡す場合でも、`plugin.NextOrFailure(pluginName, Next, ctx, w, req)`といったヘルパーを使うことで、万一チェインの次にプラグインが存在しない場合でも適切に処理できます ([example/example.go at master · coredns/example · GitHub](https://github.com/coredns/example/blob/master/example.go#L27#:~:text=%2F%2F%20Call%20next%20plugin%20,any)) ([CoreDNS の仕組みとプラグイン - ストイックに生きたい](https://blog.sakamo.dev/post/coredns-plugins/#:~:text=ServeDNS%20%E3%81%A7%E3%81%AF%E3%80%81%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%81%8C%E5%AE%9F%E8%A1%8C%E3%81%95%E3%82%8C%E3%81%9F%E9%9A%9B%E3%81%AE%E5%87%A6%E7%90%86%E3%82%92%E5%AE%9F%E8%A3%85%E3%81%97%E3%81%A6%E3%81%84%E3%82%8B%E3%80%82%20%E3%81%BE%E3%81%9F%E3%80%81plugin,%E3%82%92%E6%84%8F%E5%9B%B3%E7%9A%84%E3%81%AB%E5%91%BC%E3%81%B3%E3%81%A0%E3%81%95%E3%81%AA%E3%81%84%E3%81%93%E3%81%A8%E3%81%A7%E3%80%81%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%83%81%E3%82%A7%E3%83%BC%E3%83%B3%E3%81%AE%E9%80%94%E4%B8%AD%E3%81%A7%E5%87%A6%E7%90%86%E3%82%92%E6%AD%A2%E3%82%81%E3%82%8B%E3%81%93%E3%81%A8%E3%81%8C%E3%81%A7%E3%81%8D%E3%82%8B%E3%80%82))。

各プラグインでは、必要に応じて**ログ出力**やメトリクスカウントも行えます。CoreDNSには`plugin/pkg/log`というログパッケージが用意されており、これを使ってプラグイン名付きのロガーを簡単に生成できます ([example/example.go at master · coredns/example · GitHub](https://github.com/coredns/example/blob/master/example.go#L27#:~:text=var%20log%20%3D%20clog.NewWithPlugin%28)) ([CoreDNS の仕組みとプラグイン - ストイックに生きたい](https://blog.sakamo.dev/post/coredns-plugins/#:~:text=))。`log := clog.NewWithPlugin("plugin名")`のように設定すれば、`log.Info(...)`や`log.Debug(...)`で情報やデバッグログを出力可能です ([Developing Custom Plugins for CoreDNS - DEV Community](https://dev.to/satrobit/developing-custom-plugins-for-coredns-4jnj#:~:text=package%20Foo)) ([Developing Custom Plugins for CoreDNS - DEV Community](https://dev.to/satrobit/developing-custom-plugins-for-coredns-4jnj#:~:text=Now%20you%20can%20log%20anything,you%20need%20with%20different%20levels))。デバッグログは`debug`プラグインをCorefileで有効化することで出力されるようになります ([CoreDNS の仕組みとプラグイン - ストイックに生きたい](https://blog.sakamo.dev/post/coredns-plugins/#:~:text=example%20%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%81%A7%E3%81%AF%E3%80%81log,%E3%81%AE%E5%87%BA%E5%8A%9B%E3%82%92%E7%A2%BA%E8%AA%8D%E3%81%99%E3%82%8B%E3%81%9F%E3%82%81%E3%81%AB%E3%81%AF%20debug%20%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%82%82%E6%9C%89%E5%8A%B9%E3%81%AB%E3%81%99%E3%82%8B%E5%BF%85%E8%A6%81%E3%81%8C%E3%81%82%E3%82%8B%E3%80%82)) ([CoreDNS の仕組みとプラグイン - ストイックに生きたい](https://blog.sakamo.dev/post/coredns-plugins/#:~:text=,NOERROR%20qr%2Crd%2Cra%2Cad%2067%200.013614538s))。

## CoreDNSプラグイン開発の手順 (ステップバイステップ)
それでは、CoreDNSのプラグインを自作する具体的な手順を順を追って説明します。ここではGo言語に習熟しているがCoreDNSプラグイン開発は初めてという読者を想定し、基本的な流れを示します ([CoreDNS の仕組みとプラグイン - ストイックに生きたい](https://blog.sakamo.dev/post/coredns-plugins/#:~:text=%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%82%92%E5%AE%9F%E8%A3%85%E3%81%99%E3%82%8B%E6%96%B9%E6%B3%95%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6%E3%81%AF%E3%80%81Writing%20Plugins%20%E3%81%8A%E3%82%88%E3%81%B3%20How%20to,interface%20%E3%82%92%E5%AE%9F%E8%A3%85%E3%81%97%E3%80%81AddPluggin%20%E3%81%A7%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%82%92%E7%99%BB%E9%8C%B2%E3%81%99%E3%82%8B%E3%81%93%E3%81%A8%E3%81%A7%E5%AE%9F%E8%A3%85%E3%81%A7%E3%81%8D%E3%82%8B%E3%80%82%20example%20%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%81%8C%E3%82%8F%E3%81%8B%E3%82%8A%E3%82%84%E3%81%99%E3%81%84%E3%81%AE%E3%81%A7%E5%8F%82%E8%80%83%E3%81%AB%E3%81%99%E3%82%8B%E3%81%A8%E8%89%AF%E3%81%84%E3%80%82))。

1. **プラグインの雛形作成**: 開発を始める前に、プラグインのプロジェクトディレクトリ（Goモジュール）を用意します。公式リポジトリには`example`という最小実装のサンプルプラグインが提供されており、参考になります ([CoreDNS の仕組みとプラグイン - ストイックに生きたい](https://blog.sakamo.dev/post/coredns-plugins/#:~:text=%E3%82%B5%E3%83%B3%E3%83%97%E3%83%AB%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%81%A8%E3%81%97%E3%81%A6%E3%80%81example%20%E3%81%8C%E6%8F%90%E4%BE%9B%E3%81%95%E3%82%8C%E3%81%A6%E3%81%84%E3%82%8B%E3%81%AE%E3%81%A7%E3%80%81%E3%81%93%E3%82%8C%E3%82%92%E4%BD%BF%E3%81%A3%E3%81%A6%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%81%AE%E8%BF%BD%E5%8A%A0%E3%82%92%E8%A9%A6%E3%81%99%E3%81%93%E3%81%A8%E3%81%8C%E3%81%A7%E3%81%8D%E3%82%8B%E3%80%82%20plugin,cfg%20%E3%81%AB%E5%AE%9A%E7%BE%A9%E3%81%95%E3%82%8C%E3%81%A6%E3%81%84%E3%82%8B%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%81%AE%E9%A0%86%E7%95%AA%E3%81%AF%E9%87%8D%E8%A6%81%E3%81%AA%E3%81%9F%E3%82%81%E3%80%81%E4%BB%8A%E5%9B%9E%E3%81%AE%E5%A0%B4%E5%90%88%E3%80%81example%20%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%81%AF%20forward%20%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%82%88%E3%82%8A%E5%89%8D%E3%81%AB%E5%AE%9A%E7%BE%A9%E3%81%99%E3%82%8B%E5%BF%85%E8%A6%81%E3%81%8C%E3%81%82%E3%82%8B%E3%80%82)) ([CoreDNS の仕組みとプラグイン - ストイックに生きたい](https://blog.sakamo.dev/post/coredns-plugins/#:~:text=%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%82%92%E5%AE%9F%E8%A3%85%E3%81%99%E3%82%8B%E6%96%B9%E6%B3%95%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6%E3%81%AF%E3%80%81Writing%20Plugins%20%E3%81%8A%E3%82%88%E3%81%B3%20How%20to,interface%20%E3%82%92%E5%AE%9F%E8%A3%85%E3%81%97%E3%80%81AddPluggin%20%E3%81%A7%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%82%92%E7%99%BB%E9%8C%B2%E3%81%99%E3%82%8B%E3%81%93%E3%81%A8%E3%81%A7%E5%AE%9F%E8%A3%85%E3%81%A7%E3%81%8D%E3%82%8B%E3%80%82%20example%20%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%81%8C%E3%82%8F%E3%81%8B%E3%82%8A%E3%82%84%E3%81%99%E3%81%84%E3%81%AE%E3%81%A7%E5%8F%82%E8%80%83%E3%81%AB%E3%81%99%E3%82%8B%E3%81%A8%E8%89%AF%E3%81%84%E3%80%82))。まずはこのような雛形をベースに、自分のプラグイン用にパッケージを作成しましょう。例としてプラグイン名を`foo`とします。

2. **プラグインの登録 (`init`関数)**: CoreDNSに新しいプラグインを認識させるには、プラグインのパッケージで`plugin.Register()`を呼び出して登録する必要があります。これは通常、プラグインパッケージの`init()`関数内で行います ([ Writing Plugins for CoreDNS ](https://coredns.io/2016/12/19/writing-plugins-for-coredns/#:~:text=When%20writing%20your%20plugin%20code,by%20calling%20the%20following%20function))。例えば以下のように記述します:

   ```go
   package foo

   import "github.com/coredns/coredns/plugin"

   func init() {
       plugin.Register("foo", setup)
   }
   ```

   この`plugin.Register("foo", setup)`により、CoreDNSはCorefile内で`foo`というディレクティブ（プラグイン名）を見つけた際に対応するセットアップ関数を呼び出すようになります ([ Writing Plugins for CoreDNS ](https://coredns.io/2016/12/19/writing-plugins-for-coredns/#:~:text=When%20writing%20your%20plugin%20code,by%20calling%20the%20following%20function))。プラグイン名はコアプラグインと重複しないユニークなものを付けましょう。

3. **セットアップ関数の実装**: 次に、上で登録した`setup`関数を実装します。シグネチャは`func setup(c *caddy.Controller) error`で、Corefileの該当部分のパースとプラグインの初期設定を行います ([ Writing Plugins for CoreDNS ](https://coredns.io/2016/12/19/writing-plugins-for-coredns/#:~:text=The%20,and%20populates%20internal%20data%20structures))。`caddy.Controller`（CoreDNSはCaddyサーバーv1由来のコンフィグパーサーを使用）は、トークン化された設定行を提供します。一般的な実装としては、次のようになります ([ Writing Plugins for CoreDNS ](https://coredns.io/2016/12/19/writing-plugins-for-coredns/#:~:text=We%20can%20get%20the%20value,%E2%80%9Cgizmo%E2%80%9D%29%20like%20so)) ([example/setup.go at master · coredns/example · GitHub](https://github.com/coredns/example/blob/master/setup.go#:~:text=%2F%2F%20Add%20the%20Plugin%20to,it%20in%20their%20plugin%20chain))。

   ```go
   func setup(c *caddy.Controller) error {
       // プラグイン名トークンを読み飛ばし、次のトークンへ
       c.Next() 
       // 必要に応じて引数をパース
       if c.NextArg() {
           arg := c.Val()  // 例えば一つだけ引数を取る場合
           // ... arg を使った設定処理 ...
       }
       if c.NextArg() {
           // 想定外の追加引数があればエラーを返す
           return c.ArgErr()
       }
       // プラグインチェインに自分のプラグインを追加
       dnsserver.GetConfig(c).AddPlugin(func(next plugin.Handler) plugin.Handler {
           return &FooPlugin{Next: next /*, 他のフィールド設定 */}
       })
       return nil
   }
   ``` 

   上記では、`c.Next()`でディレクティブ名(`foo`)をスキップし、`c.NextArg()`で必要な引数を1つ読み取っています ([ Writing Plugins for CoreDNS ](https://coredns.io/2016/12/19/writing-plugins-for-coredns/#:~:text=We%20can%20get%20the%20value,%E2%80%9Cgizmo%E2%80%9D%29%20like%20so))。もし引数が期待数に満たない/多い場合は`c.ArgErr()`でエラーを返し、CoreDNSの起動プロセスにエラーを伝えます ([ Writing Plugins for CoreDNS ](https://coredns.io/2016/12/19/writing-plugins-for-coredns/#:~:text=We%20can%20get%20the%20value,%E2%80%9Cgizmo%E2%80%9D%29%20like%20so))。最後に、`dnsserver.GetConfig(c).AddPlugin(...)`を呼び出してこのプラグインをチェインに登録しています ([CoreDNS の仕組みとプラグイン - ストイックに生きたい](https://blog.sakamo.dev/post/coredns-plugins/#:~:text=%2F%2F%20Add%20the%20Plugin%20to,Next%3A%20next%7D))。`AddPlugin`には次のプラグインを受け取って自分のハンドラを返す関数を渡します。上記例では、無名関数内で自分のプラグイン構造体(`FooPlugin`)を生成し、フィールド`Next`に渡された`next`ハンドラをセットして返しています ([example/setup.go at master · coredns/example · GitHub](https://github.com/coredns/example/blob/master/setup.go#:~:text=%2F%2F%20Add%20the%20Plugin%20to,it%20in%20their%20plugin%20chain))。これにより、CoreDNSのプラグインチェイン中に`foo`プラグインが組み込まれることになります。

4. **プラグインハンドラの実装**: プラグインの主要部分である`plugin.Handler`インターフェースを実装します。まず構造体を定義します。例えば:

   ```go
   type FooPlugin struct {
       Next plugin.Handler      // 次のプラグイン（チェインの後続）
       Option string            // 何らかのオプション（引数）例
   }
   ```

   ここで`Option`は設定で受け取った引数など、プラグインが動作に必要なデータを保持するためのフィールドです（必要なものを自由に追加できます）。次に、この構造体に`Name()`メソッドと`ServeDNS()`メソッドを実装します。

   ```go
   func (f *FooPlugin) Name() string { 
       return "foo" 
   }

   func (f *FooPlugin) ServeDNS(ctx context.Context, w dns.ResponseWriter, req *dns.Msg) (int, error) {
       // 例: クエリ情報を取得してログ出力
       state := request.Request{W: w, Req: req}
       log.Infof("Query for %s from %s", state.Name(), state.IP())
       // 他の処理 ... （必要ならreqを改変したりできます）
       // 次のプラグインに処理を委譲
       return plugin.NextOrFailure(f.Name(), f.Next, ctx, w, req)
   }
   ```
   
   `Name()`はプラグイン名を返すだけの簡単な関数です ([ Writing Plugins for CoreDNS ](https://coredns.io/2016/12/19/writing-plugins-for-coredns/#:~:text=The%20interface%20also%20needs%20a,func%20Name%28%29%20string))。`ServeDNS()`はDNSクエリごとに呼ばれる処理本体で、この中でプラグイン固有のロジックを実行します ([Developing Custom Plugins for CoreDNS - DEV Community](https://dev.to/satrobit/developing-custom-plugins-for-coredns-4jnj#:~:text=Now%20it%27s%20time%20for%20the,work%20as%20a%20data%20backend))。上記の例では、`request.Request`というヘルパー型を使ってクエリ名や依頼元IPを取得し、事前に用意したロガー（後述）で情報を記録しています。その後、`plugin.NextOrFailure`を用いて次のプラグインに処理を渡し、その戻り値（DNS応答コードとエラー）をそのまま返しています ([example/example.go at master · coredns/example · GitHub](https://github.com/coredns/example/blob/master/example.go#L27#:~:text=%2F%2F%20Call%20next%20plugin%20,any))。自プラグインでクエリを完全に処理し応答を返す場合は、ここで`w.WriteMsg(responseMsg)`を呼んで`dns.RcodeSuccess`などをリターンし、`Next`を呼ばずに終了します ([Developing Custom Plugins for CoreDNS - DEV Community](https://dev.to/satrobit/developing-custom-plugins-for-coredns-4jnj#:~:text=m%20%3A%3D%20new%28dns,Compress%20%3D%20true%2C%20false%2C%20true)) ([CoreDNS の仕組みとプラグイン - ストイックに生きたい](https://blog.sakamo.dev/post/coredns-plugins/#:~:text=ServeDNS%20%E3%81%A7%E3%81%AF%E3%80%81%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%81%8C%E5%AE%9F%E8%A1%8C%E3%81%95%E3%82%8C%E3%81%9F%E9%9A%9B%E3%81%AE%E5%87%A6%E7%90%86%E3%82%92%E5%AE%9F%E8%A3%85%E3%81%97%E3%81%A6%E3%81%84%E3%82%8B%E3%80%82%20%E3%81%BE%E3%81%9F%E3%80%81plugin,%E3%82%92%E6%84%8F%E5%9B%B3%E7%9A%84%E3%81%AB%E5%91%BC%E3%81%B3%E3%81%A0%E3%81%95%E3%81%AA%E3%81%84%E3%81%93%E3%81%A8%E3%81%A7%E3%80%81%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%83%81%E3%82%A7%E3%83%BC%E3%83%B3%E3%81%AE%E9%80%94%E4%B8%AD%E3%81%A7%E5%87%A6%E7%90%86%E3%82%92%E6%AD%A2%E3%82%81%E3%82%8B%E3%81%93%E3%81%A8%E3%81%8C%E3%81%A7%E3%81%8D%E3%82%8B%E3%80%82))。

5. **ログ出力やユーティリティの利用**: 開発時には適宜ログを出力すると便利です。上記コード中の`log`は、プラグインごとにロガーを生成したものです。プラグインでは`clog "github.com/coredns/coredns/plugin/pkg/log"`をインポートし、`var log = clog.NewWithPlugin("foo")`のようにしておくと、ログメッセージに自動で`[INFO] plugin/foo:`のようなプレフィックスが付与されます ([Developing Custom Plugins for CoreDNS - DEV Community](https://dev.to/satrobit/developing-custom-plugins-for-coredns-4jnj#:~:text=package%20Foo)) ([example/example.go at master · coredns/example · GitHub](https://github.com/coredns/example/blob/master/example.go#L27#:~:text=var%20log%20%3D%20clog.NewWithPlugin%28))。`log.Info(...)`や`log.Debug(...)`を使うことで情報・デバッグログを出力できます（デバッグログはCorefileで`debug`プラグインを有効にした場合に出力されます ([CoreDNS の仕組みとプラグイン - ストイックに生きたい](https://blog.sakamo.dev/post/coredns-plugins/#:~:text=example%20%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%81%A7%E3%81%AF%E3%80%81log,%E3%81%AE%E5%87%BA%E5%8A%9B%E3%82%92%E7%A2%BA%E8%AA%8D%E3%81%99%E3%82%8B%E3%81%9F%E3%82%81%E3%81%AB%E3%81%AF%20debug%20%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%82%82%E6%9C%89%E5%8A%B9%E3%81%AB%E3%81%99%E3%82%8B%E5%BF%85%E8%A6%81%E3%81%8C%E3%81%82%E3%82%8B%E3%80%82))）。また、`github.com/miekg/dns`パッケージを利用してDNSレコードを表す構造体（例えば`dns.A`や`dns.TXT`など）を生成し応答に入れることもできます ([Developing Custom Plugins for CoreDNS - DEV Community](https://dev.to/satrobit/developing-custom-plugins-for-coredns-4jnj#:~:text=answers%20%3A%3D%20make%28))。さらに、CoreDNS組み込みのメトリクス収集機能（Prometheus統合）を利用してクエリ数などをカウントすることも可能です。必要に応じて公式ドキュメントを参照してください ([Developing Custom Plugins for CoreDNS - DEV Community](https://dev.to/satrobit/developing-custom-plugins-for-coredns-4jnj#:~:text=objects%3A%20https%3A%2F%2Fpkg))。

6. **プラグインのビルドと組み込み**: プラグインの実装ができたら、それを含めてCoreDNSをビルドします。CoreDNSはGoのビルド時にプラグインを静的に組み込む設計になっており、動的ロードはできません。そのため**2通りの方法**があります ([ Compile Time Enabling or Disabling Plugins ](https://coredns.io/2017/07/25/compile-time-enabling-or-disabling-plugins/#:~:text=CoreDNS%27%20plugins%20%20,leave%20the%20rest%20completely%20out)) ([ Compile Time Enabling or Disabling Plugins ](https://coredns.io/2017/07/25/compile-time-enabling-or-disabling-plugins/#:~:text=There%20are%20two%20ways%20to,achieved%20without%20modifying%20CoreDNS%20code))。

   - **(A) CoreDNS本体に組み込んでビルド**: CoreDNSのソースコードを取得し、`plugin.cfg`というファイルに自作プラグインを追加してビルドします ([ Compile Time Enabling or Disabling Plugins ](https://coredns.io/2017/07/25/compile-time-enabling-or-disabling-plugins/#:~:text=Build%20with%20compile)) ([ Compile Time Enabling or Disabling Plugins ](https://coredns.io/2017/07/25/compile-time-enabling-or-disabling-plugins/#:~:text=The%20ordering%20of%20the%20plugins,your%20plugin%20in%20this%20file))。`plugin.cfg`には各プラグインの名前とパッケージパスが並んでおり、そこに例えば`foo:github.com/あなたのユーザ名/foo`というエントリを追記します ([Developing Custom Plugins for CoreDNS - DEV Community](https://dev.to/satrobit/developing-custom-plugins-for-coredns-4jnj#:~:text=the%20,and%20compile%20the%20code))。プラグインの順序はこのファイル内の記述順で決まるため、既存プラグインとの前後関係に注意してください ([ Compile Time Enabling or Disabling Plugins ](https://coredns.io/2017/07/25/compile-time-enabling-or-disabling-plugins/#:~:text=))。追加後、`go get github.com/あなたのユーザ名/foo`でプラグインのコードを取得（またはgo.modに`replace`を書いてローカル参照）し、CoreDNSディレクトリ内で`go generate && go build`もしくは`make`を実行すると、新しいプラグインを含んだ`coredns`バイナリが生成されます ([ Compile Time Enabling or Disabling Plugins ](https://coredns.io/2017/07/25/compile-time-enabling-or-disabling-plugins/#:~:text=Then%20do%20a%20,plugins))。ビルド後、`./coredns -plugins`コマンドで組み込まれたプラグイン一覧を確認でき、自作プラグインが含まれていれば成功です ([Developing Custom Plugins for CoreDNS - DEV Community](https://dev.to/satrobit/developing-custom-plugins-for-coredns-4jnj#:~:text=Then%20you%20need%20to%20do,make))。

   - **(B) 外部からラッピングしてビルド**: CoreDNSのコードを直接変更せずにプラグインを組み込む方法です ([ Compile Time Enabling or Disabling Plugins ](https://coredns.io/2017/07/25/compile-time-enabling-or-disabling-plugins/#:~:text=There%20are%20two%20ways%20to,achieved%20without%20modifying%20CoreDNS%20code))。Goの外部パッケージとしてCoreDNSとプラグインをインポートし、プラグインの有効順序リストをコード上で設定した上で`coremain.Run()`を呼ぶ小さな`main.go`を作成します ([ Compile Time Enabling or Disabling Plugins ](https://coredns.io/2017/07/25/compile-time-enabling-or-disabling-plugins/#:~:text=Alternatively%2C%20you%20could%20assemble%20plugins,It%20looks%20like%20this)) ([ Compile Time Enabling or Disabling Plugins ](https://coredns.io/2017/07/25/compile-time-enabling-or-disabling-plugins/#:~:text=func%20init%28%29%20,directives))。例えば以下のようなコードになります ([ Compile Time Enabling or Disabling Plugins ](https://coredns.io/2017/07/25/compile-time-enabling-or-disabling-plugins/#:~:text=Alternatively%2C%20you%20could%20assemble%20plugins,It%20looks%20like%20this)) ([ Compile Time Enabling or Disabling Plugins ](https://coredns.io/2017/07/25/compile-time-enabling-or-disabling-plugins/#:~:text=func%20init%28%29%20,directives)):

     ```go
     package main

     import (
         _ "github.com/あなたのユーザ名/foo"
         "github.com/coredns/coredns/core/dnsserver"
         "github.com/coredns/coredns/coremain"
     )

     // プラグイン実行順序の上書き
     var directives = []string{
         "foo",
         // ... 他の必要なプラグイン ...
         "forward",
         "cache",
         "log",
         "errors",
         "health",
         "reload",
         // 既存のプラグインも全て列挙する必要があります
     }

     func init() {
         dnsserver.Directives = directives
     }

     func main() {
         coremain.Run()
     }
     ```

     こうすることで、CoreDNSのデフォルトプラグイン順序を自分で定義した`directives`に置き換えて起動できます ([ Compile Time Enabling or Disabling Plugins ](https://coredns.io/2017/07/25/compile-time-enabling-or-disabling-plugins/#:~:text=func%20init%28%29%20,directives)) ([ Compile Time Enabling or Disabling Plugins ](https://coredns.io/2017/07/25/compile-time-enabling-or-disabling-plugins/#:~:text=dnsserver))。`import`では自作プラグインパッケージをブランクインポート（`_`）することで`init()`関数を実行し、プラグイン登録を済ませています ([ Compile Time Enabling or Disabling Plugins ](https://coredns.io/2017/07/25/compile-time-enabling-or-disabling-plugins/#:~:text=In%20the%20above%20sample%20code%2C,has%20been%20imported%20with))。この方法であればCoreDNS本体に変更を加えないためメンテナンスしやすいですが、CoreDNSのバージョンアップに追随するために自前の`main.go`を更新する手間は発生します。

以上が基本的な開発の流れです。次章では、実際に非常にシンプルなプラグインのコード例を示します。

## プラグイン実装例: リクエストをログに記録するプラグイン
最後に、CoreDNSプラグインの具体的な実装例として**DNSリクエストをログに記録するだけの簡単なプラグイン**を示します。これは前述のステップに沿って作成したものです。

```go
// パッケージと必要なインポート
package foo

import (
    "context"

    "github.com/coredns/caddy"
    "github.com/coredns/coredns/core/dnsserver"
    "github.com/coredns/coredns/plugin"
    "github.com/coredns/coredns/request"
    clog "github.com/coredns/coredns/plugin/pkg/log"
    "github.com/miekg/dns"
)

// ロガーをプラグイン名付きで作成
var log = clog.NewWithPlugin("foo")

// プラグインの登録
func init() {
    plugin.Register("foo", setup)
}

// Corefileパーサー兼セットアップ関数
func setup(c *caddy.Controller) error {
    c.Next() // "foo"トークンをスキップ
    // このプラグインは追加の設定項目を持たないため、余分な引数があればエラー
    if c.NextArg() {
        return c.ArgErr()  // 未知の設定があればエラー
    }
    // プラグインをチェインに登録
    dnsserver.GetConfig(c).AddPlugin(func(next plugin.Handler) plugin.Handler {
        return &FooPlugin{Next: next}
    })
    return nil
}

// プラグインハンドラ構造体
type FooPlugin struct {
    Next plugin.Handler
}

// Nameメソッド (プラグイン名を返す)
func (f *FooPlugin) Name() string { return "foo" }

// DNSリクエストを処理する
func (f *FooPlugin) ServeDNS(ctx context.Context, w dns.ResponseWriter, req *dns.Msg) (int, error) {
    // リクエスト情報を取得
    state := request.Request{W: w, Req: req}
    qName := state.Name()   // 質問のドメイン名
    qType := state.Type()   // 質問のタイプ（A, AAAAなど）
    clientIP := state.IP()  // クライアントのIPアドレス

    // ログ出力
    log.Infof("DNS query for %s (%s) from %s", qName, qType, clientIP)

    // チェインの次のプラグインに処理を渡す
    return plugin.NextOrFailure(f.Name(), f.Next, ctx, w, req)
}
```

上記`foo`プラグインは非常にシンプルで、追加のオプションも持たず、受け取ったDNSクエリの名前・種類・送信元IPをログに記録してから次のプラグインに処理を引き継ぐだけの動作をします。`request.Request`構造体を使うことで`req.Question`を手作業で解析することなく`Name()`や`Type()`を取得でき、便利です ([Developing Custom Plugins for CoreDNS - DEV Community](https://dev.to/satrobit/developing-custom-plugins-for-coredns-4jnj#:~:text=List%20of%20variables%20you%20can,state))。ログ出力には`plugin/pkg/log`経由で作成したロガーを用い、`Infof`メソッドで情報レベルのログを書き出しています（実行時に`-log stdout`オプションを付けて起動すればコンソール上で確認できます）。

このプラグインを利用するには、前述の手順6に従ってCoreDNSに組み込みます。たとえばCoreDNSソースに組み込む場合、`plugin.cfg`に`foo:github.com/yourname/foo`を追加してビルドし、Corefileに以下のように記述します。

```bash
. {
    foo        # 自作プラグインfooを有効化
    forward . 1.1.1.1
    log
}
```

上記の設定でCoreDNSを起動し、任意のDNSクエリを投げると、通常の`log`プラグインの出力に加えて`foo`プラグインによるログが表示されるはずです。例えばクライアントから`example.com A`レコードの問い合わせが来た場合、`foo`プラグインからは次のようなログが出力されます（実行環境によって形式は多少異なります）。

```
[INFO] plugin/foo: DNS query for example.com. (A) from 192.168.0.10
```

このように、CoreDNSのプラグインを開発すれば、自分の用途に合わせたカスタムなDNS処理を組み込むことができます。Go言語で実装された柔軟なプラグインシステムを活用し、ぜひCoreDNSを拡張してみてください。

**参考文献**: CoreDNS公式サイトのプラグイン開発ドキュメント ([ Writing Plugins for CoreDNS ](https://coredns.io/2016/12/19/writing-plugins-for-coredns/#:~:text=A%20plugin%20adds%20functionality%20to,file%20serving%20are%20all%20plugins)) ([ Writing Plugins for CoreDNS ](https://coredns.io/2016/12/19/writing-plugins-for-coredns/#:~:text=,details%20about%20these%20return%20values))や、CoreDNSのGitHub上のサンプルプラグインコード ([example/example.go at master · coredns/example · GitHub](https://github.com/coredns/example/blob/master/example.go#L27#:~:text=%2F%2F%20Example%20is%20an%20example,how%20to%20write%20a%20plugin)) ([example/example.go at master · coredns/example · GitHub](https://github.com/coredns/example/blob/master/example.go#L27#:~:text=%2F%2F%20WriteMsg%20calls%20the%20underlying,to%20standard%20output))も併せて参照してください。本記事の内容は2025年時点の情報に基づいており、CoreDNSのバージョンアップにより一部変更となる可能性があります。