360 Secure SkillHub
360 安全技能中心

NextDNS

该 Skill 封装 NextDNS API 的只读查询 helper，可读取 profile、汇总时间范围内的状态/协议/域名统计与近期日志，辅助定位封锁域名和 Technitium 上游问题；写入或删除操作需显式确认。

naamah75
naamah75
热度 29.40
最近更新 2026-05-11 17:46:58
分类：安全依赖：代码执行 / 第三方 API / 读写文件应用场景：数据处理 / 报告撰写 / 研究 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add nextdns
Metadata
name
nextdns
description
Query and troubleshoot NextDNS via the NextDNS API, especially when NextDNS is used as Technitium DNS upstream. Use for NextDNS profile inspection, analytics, recent logs, blocked-domain diagnosis, DNS upstream health checks, or creating safe read-only helper commands before any NextDNS configuration change.

NextDNS

Use this skill for read-first NextDNS API work. Prefer inspection and diagnostics; ask Igor before any write, delete, log clear, profile edit, denylist/allowlist mutation, or monitoring that could expose sensitive browsing data externally.

Helper

Use the bundled helper unless a task needs an unsupported endpoint:

python3 skills/nextdns/scripts/nextdns_helper.py --help

Authentication defaults:

  • NEXTDNS_API_KEY for the API key.
  • NEXTDNS_PROFILE_ID for the profile id.

Examples:

# List profiles available to the API key
NEXTDNS_API_KEY=... python3 skills/nextdns/scripts/nextdns_helper.py profiles

# Get profile config
python3 skills/nextdns/scripts/nextdns_helper.py profile

# Last 24h status summary
python3 skills/nextdns/scripts/nextdns_helper.py analytics status --from -24h

# Top blocked domains in last 24h
python3 skills/nextdns/scripts/nextdns_helper.py analytics domains --from -24h --status blocked --limit 20

# Recent blocked logs for a domain/search term
python3 skills/nextdns/scripts/nextdns_helper.py logs --from -24h --status blocked --search example.com --limit 50

The helper prints JSON with:

  • ok: request success boolean.
  • status: HTTP status if available.
  • url: requested URL without API key.
  • response: decoded API response.

Workflow

  1. Verify credentials with profiles before diagnosing deeper.
  2. Identify the profile id; set NEXTDNS_PROFILE_ID or pass --profile.
  3. For general health, check analytics status --from -24h, analytics protocols --from -24h, and analytics domains --from -24h --status blocked.
  4. For Technitium upstream questions, correlate Technitium client/upstream behavior with NextDNS logs and analytics protocols.
  5. For block/allow questions, inspect logs and reasons first. Do not modify lists unless Igor explicitly confirms the exact domain/action.

API reference

Read references/api-summary.md when endpoint details, pagination, time-series parameters, logs, or response shapes matter.

Safety notes

  • NextDNS logs can reveal browsing/device activity. Summarize minimally and avoid pasting sensitive domains unless needed.
  • API is marked beta by NextDNS; handle response changes defensively.
  • Do not call destructive endpoints like DELETE /profiles/:profile/logs without explicit confirmation.
  • Before config writes, export/read current profile and save a timestamped backup in the workspace or another user-approved location.