Executor Plugins

Executors are the core action layer in OxiDNS. They can read or write requests, set responses, query upstreams, cache results, perform fallback logic, emit logs, or trigger system integrations.

When reading this chapter, keep two questions in mind:

1. Does this plugin act only in the forward stage, or can it also rewrite results on the return path?
2. Is it part of the main resolution path, or an observability and side-effect plugin?

---

Category map

Group	Plugins
Policy Orchestration	sequence, fallback
Resolution and Request Handling	forward, cache, hosts, arbitrary, response, redirect, client_ip_from_ecs, ecs_handler, forward_edns0opt
Response Processing	ttl, ip_selector, prefer_ipv4 / prefer_ipv6, black_hole, drop_resp, reverse_lookup
Observability and Debugging	learn_domain, query_summary, query_recorder, metrics_collector, debug_print, sleep
External and System Integrations	http_request, script, ipset, nftset, ros_address_list, ros_route
Maintenance and Scheduling	upgrade, download, reload_provider, reload, cron

Legacy plugin anchors remain on this directory page; field references now live in the responsibility groups above.