AgentSkillsCN

integrations

面向第三方平台与服务的 NextDNS 集成指南。当您需要将 NextDNS 与路由器、家庭自动化系统、网络管理平台,或其他第三方服务进行集成时,此技能便能派上用场。当您涉及 Tailscale、Home Assistant、Ubiquiti、pfSense、OpenWrt,或其它特定平台的 NextDNS 配置时,此技能同样适用。

SKILL.md
--- frontmatter
name: integrations
description:
  NextDNS integration guides for third-party platforms and services. This skill should be used when
  integrating NextDNS with routers, home automation systems, network management platforms, or other
  third-party services. Triggers on tasks involving Tailscale, Home Assistant, Ubiquiti, pfSense,
  OpenWrt, or other platform-specific NextDNS configurations.
license: MIT
metadata:
  author: tuanductran
  version: '1.0.0'

NextDNS Integration Skills

Capability Rules

RuleKeywordsDescription
Browser Native DoH Configurationbrowser, chrome, edge, firefox, doh, dns-over-https, secure-dns, encrypted-dns, corporate, proxyConfigure DNS-over-HTTPS directly in browsers for encrypted DNS without system-wide changes or admin privileges
DNSMasq Integrationdnsmasq, dns, router, client reporting, conditional configuration, port configuration, setup-routerConfigure DNSMasq and NextDNS to run together while maintaining client reporting and conditional configuration features
Mobile Native Encrypted DNS Configurationmobile, android, ios, iphone, ipad, private-dns, dot, dns-over-tls, configuration-profile, mobileconfig, native, lightweightConfigure native encrypted DNS on Android and iOS devices without battery-draining background apps
OpenWrt Integrationopenwrt, router, installation, upgrade, troubleshooting, ssh, luciInstallation, upgrade, and troubleshooting guidance for NextDNS on OpenWrt routers
Home Assistant Integrationhome assistant, hass, integration, automation, parental control, api, sensors, switches, blocklistEnable automated DNS control and monitoring through Home Assistant smart home platform with time-based rules and analytics
Tailscale Integrationtailscale, vpn, mesh network, doh, dns-over-https, acl, nodeattrs, global nameserver, split dnsConfigure NextDNS with Tailscale mesh VPN using DoH, global nameservers, and per-device profile assignment via ACLs
Ubiquiti (UniFi) Integrationubiquiti, unifi, udm, uxg, dream machine, gateway, content filtering, ad blocking, ssh, cli, dns shieldDeploy NextDNS on Ubiquiti UniFi devices using DNS Shield or CLI, with critical guidance on avoiding built-in DNS conflicts
pfSense and OPNsense Integrationpfsense, opnsense, firewall, router, unbound, dns-over-tls, dot, freebsd, dns resolverDeploy NextDNS on pfSense and OPNsense firewalls with proper encrypted DNS configuration and platform-specific guidance
Public DNS and AdGuard Home Integrationpublic dns, adguard, anycast, doh, dot, browser setup, windows, android, ios, upstream dns, bootstrap dnsConfigure NextDNS public DNS servers on browsers and operating systems, and integrate with AdGuard Home as upstream DNS provider
Synology Integration (DSM and SRM)synology, dsm, srm, nas, router, ssh, cli, dhcp, networkInstall NextDNS on Synology NAS (DSM) and routers (SRM) with proper SSH access and network configuration
AsusWRT-Merlinasus, merlin, router, ssh, installation, setupDeploy NextDNS on Asus routers with Merlin firmware
EdgeRouter and Firewallaedgerouter, edgeos, firewalla, gateway, ssh, professionalDeploy NextDNS on EdgeRouter and Firewalla hardware

Efficiency Rules

RuleKeywordsDescription
Backup and Failoverbackup dns, failover, redundancy, reliabilityEnsure connectivity during DNS outages

Adding New Integration Rules

When adding a new integration rule:

  1. Create a new file in rules/ using kebab-case naming
  2. Follow the rule template structure from templates/rule-template.md
  3. Include platform-specific configuration examples
  4. Add troubleshooting steps for common issues
  5. Register the rule in the appropriate table above
  6. Run pnpm lint:fix to ensure compliance

Example Integration Platforms

Consider creating rules for these popular platforms:

Capability Rules:

  • Tailscale (mesh VPN)
  • Home Assistant (smart home automation)
  • Ubiquiti UniFi (network controller)
  • OpenWrt (router firmware)
  • pfSense (firewall/router)
  • Docker (containerization)
  • Kubernetes (orchestration)
  • Synology NAS (network storage)

Efficiency Rules:

  • Multi-platform deployment strategy
  • Integration testing and validation
  • Backup DNS and failover configuration