Communitygithub.com

家庭实验室网络就绪检查

在更改路由器、防火墙、DHCP 或 VPN 配置之前,对家庭实验室 VLAN 分段、本地 DNS 过滤和 WireGuard 风格远程访问进行就绪检查。

家庭实验室网络就绪检查 是什么?

该技能用于在变更家庭或小型实验室网络(涉及 VLAN、Pi-hole 或其他本地 DNS 解析器、防火墙规则和远程 VPN 访问)之前进行规划和审查。它强制用户收集关键库存信息(如互联网边缘设备、网关、子网、DNS/DHCP 服务、管理访问方式和恢复路径),而不是直接生成配置命令。该技能支持多种平台(包括 WireGuard、Tailscale、ZeroTier、OpenVPN 等),并强调安全规则:不暴露管理界面到公共互联网,不提供缺乏回滚程序的命令,并要求在更改管理 VLAN、中继端口或 DHCP/DNS 设置时具备带外或同房间控制台访问。通过引导用户通过小型、可逆的更改序列(快照当前配置、创建新 VLAN、测试单个客户端、添加窄防火墙例外、添加 VPN 访问),最后进行审查清单检查(如信任边界、默认拒绝规则、回滚文档),该技能帮助用户避免常见反模式(如分段网络前未确认交换端口和 SSID,或未测试后备 DNS 就将所有 DHCP 范围指向 Pi-hole)。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/affaan-m/everything-claude-code/tree/main/skills/homelab-network-readiness

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

家庭实验室网络就绪检查 是做什么的?

在更改混用 VLAN、 Pi-hole 或其他本地 DNS 解析器、防火墙规则和远程 VPN 访问的家庭或小型实验室网络之前,请使用此技能。

这是一个规划与审查技能。除非目标平台、当前拓扑、 回滚路径、控制台访问和维护窗口均已知,否则不要将其转换为可复制粘贴的路由器、 防火墙或 VPN 配置。

使用时机

  • 准备将一个扁平网络拆分为可信、物联网、访客、服务器或 管理 VLAN。
  • 将 DHCP 客户端迁移到 Pi-hole、AdGuard Home、Unbound 或其他本地 DNS 解析器。
  • 添加 WireGuard、Tailscale、ZeroTier、OpenVPN 或路由器原生 VPN 访问。
  • 审查家庭实验室的更改是否可能导致操作员无法访问网关、 交换机、接入点、DNS 服务器或 VPN 服务器。
  • 将非正式的家庭网络构思转变为带有验证证据的分阶段迁移计划。

安全规则

  • 保持首次回答为只读:清单、风险、分阶段计划、验证 和回滚。
  • 不要将网关管理面板、DNS 解析器、SSH、NAS 控制台或 VPN 管理 UI 直接暴露到公共互联网。
  • 在未确认平台和回滚程序的情况下,不要提供防火墙、NAT、VLAN、DHCP 或 VPN 命令。
  • 在更改管理 VLAN、中继端口、防火墙默认策略或 DHCP/DNS 设置之前,需要带外或同房间控制台访问。
  • 在将整个网络指向新的 DNS 解析器或 VPN 路由之前,保留一条返回互联网的工作路径。
  • 除非操作员明确选择,否则将物联网、访客、摄像头和实验室服务器网络视为不同的信任区域。

所需清单

在提供实施步骤之前,请收集以下信息:

区域问题
互联网边缘调制解调器或 ONT 是什么?ISP 路由器处于桥接状态还是仍在路由?
网关哪个设备负责路由、防火墙、DHCP 和 VPN 终止?
交换哪些交换机端口是上行链路、接入端口、中继端口或非管理型?
Wi-Fi哪些 SSID 映射到哪些网络,AP 是有线还是 Mesh?
编址目前存在哪些子网,哪些范围与 VPN 站点冲突?
DNS/DHCP哪个服务当前分配租约和解析器地址?
管理更改后操作员如何访问网关、交换机和 AP?
恢复如果 DNS、DHCP、VLAN 或 VPN 路由出现故障,可以本地还原哪些内容?

VLAN 和信任区域规划

从意图开始,而非供应商语法。

区域典型内容默认策略
可信笔记本电脑、手机、管理工作站仅可在需要时访问共享服务和管理
服务器NAS、Home Assistant、实验室主机、DNS 解析器接受来自可信客户端的狭窄入站流量
物联网电视、智能插头、摄像头、扬声器仅可访问互联网及明确例外
访客访客设备仅互联网,无 LAN 可达性
管理网关、交换机、AP、控制器仅可在可信管理设备上访问
VPN远程客户端访问权限与可信客户端相同或更窄

在推荐 VLAN ID 或子网之前,请确认:

  1. 网关支持 VLAN 间路由和防火墙规则。
  2. 交换机支持所需的标记和未标记端口行为。
  3. AP 可以将 SSID 映射到 VLAN。
  4. 操作员知道在更改期间他们通过哪个端口连接。
  5. 管理网络在更改中继和 SSID 后仍然可访问。

DNS 过滤就绪

Pi-hole 或其他本地解析器应作为依赖项引入,而不是作为 单点故障。

  1. 在将其用于 DHCP 选项之前,为解析器分配一个保留地址。
  2. 确认它可以解析公共 DNS 和本地 home.arpa 名称。
  3. 保留网关或第二个解析器作为临时后备。
  4. 在更改每个 DHCP 作用域之前,先测试一个客户端或一个 VLAN。
  5. 记录哪些网络可能绕过过滤以及原因。
  6. 检查阻止规则是否不会破坏强制门户、工作 VPN、固件 更新或医疗/安全设备。

有用的验证证据:

客户端获得预期的 DHCP 租约
客户端获得预期的 DNS 解析器
公共 DNS 查询成功
本地 home.arpa 查询成功
被阻止的测试域名仅在预期位置被阻止
网关和 DNS 管理界面从访客或物联网网络不可达

远程访问就绪

对于 WireGuard 风格的访问,在生成密钥或打开端口之前,确定 VPN 允许访问的内容。

模式使用时机风险说明
拆分隧道到单个子网远程管理 NAS 或实验室主机保持路由列表狭窄
拆分隧道到可信服务通过 IP 或 DNS 访问选定的应用需要精确的防火墙规则
全隧道不受信任的网络或旅行更高的带宽和 DNS 责任
覆盖 VPN更简单的远程访问,具有身份控制仍需要 ACL 审查

在操作员确认以下事项之前,不要推荐端口转发:

  • VPN 端点已修补并积极维护。
  • 转发的端口仅指向 VPN 服务,而不是管理 UI。
  • 了解动态 DNS、公共 IP 行为和 ISP CGNAT 状态。
  • 对等密钥可以在不重建整个网络的情况下撤销。
  • 日志或连接状态可以验证谁连接以及何时连接。

变更顺序

偏好小型的、可逆的更改:

  1. 快照当前拓扑、IP 计划、DHCP 设置、DNS 设置和 防火墙规则。
  2. 为网关、DNS、控制器、AP、NAS 和 VPN 端点保留基础设施地址。
  3. 创建新区域或 VLAN,但不移动关键设备。
  4. 移动一个测试客户端并验证 DHCP、DNS、路由、互联网和阻止 行为。
  5. 为所需流量添加狭窄的防火墙例外。
  6. 移动一组低风险设备。
  7. 以最窄的路由和防火墙策略添加 VPN 访问,以满足 使用场景。
  8. 记录最终状态、已知例外和回滚命令或 UI 步骤。

审查清单

  • 每个网络都有存在的原因和清晰的信任边界。
  • 没有管理界面可从访客、物联网或公共互联网访问。
  • DNS 故障不会影响操作员本地恢复的能力。
  • DHCP 作用域更改已在广泛部署前在一个客户端上进行了测试。
  • VPN 客户端仅接收所需的路由和 DNS 设置。
  • 区域之间的防火墙规则默认为拒绝,并带有命名例外。
  • 操作员仍可访问网关、交换机、AP、DNS 和 VPN 管理界面。
  • 回滚文档使用与所选平台 UI 或 CLI 相同的词汇。

反模式

  • 在知道哪些交换机端口和 SSID 承载哪些 VLAN 之前进行网络分段。
  • 将管理工作站移出唯一可访问的管理网络。
  • 在测试后备 DNS 之前将所有 DHCP 作用域指向 Pi-hole。
  • 将 NAS、DNS、路由器或虚拟机监控程序管理直接发布到 互联网。
  • 将 VPN 访问视为完全等同的可信 LAN 访问。
  • 临时添加允许所有防火墙规则并忘记删除。
  • 不检查确切平台语法就复制其他供应商或固件版本的命令。

参见

  • 技能:homelab-network-setup
  • 技能:network-config-validation
  • 技能:network-interface-health

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

accessibility

Design, implement, and audit inclusive digital products using WCAG 2.2 Level AA. Use when building or auditing UI that must meet WCAG 2.2 Level AA, or when reviewing a change for keyboard, contrast, or screen-reader support.

affaan-m/claude-api

Anthropic Claude API patterns for Python and TypeScript. Covers Messages API, streaming, tool use, vision, extended thinking, batches, prompt caching, and Claude Agent SDK. Use when building applications with the Claude API or Anthropic SDKs.

affaan-m/everything-claude-code

End-to-end marketing campaign planning and execution. Covers audience research, positioning, campaign angle definition, landing page copy, email sequences, social posts, ad copy, short-form video scripts, and content calendars. Use as the orchestration layer for multi-channel product launches. Use when planning or executing a multi-channel product launch, or producing landing page, email, social, or ad copy.

affaan-m/everything-claude-code

Development conventions and patterns for everything-claude-code. JavaScript project with conventional commits.

affaan-m/everything-claude-code-conventions

Development conventions and patterns for everything-claude-code. JavaScript project with conventional commits.

affaan-m/frontend-design

Create distinctive, production-grade frontend interfaces with high design quality. Use when the user asks to build web components, pages, or applications and the visual direction matters as much as the code quality.

affaan-m/gget

gget CLI and Python workflow for quick genomic database queries, sequence lookup, BLAST-style searches, enrichment checks, and reproducible bioinformatics evidence logs.

affaan-m/literature-review

Systematic literature-review workflow for academic, biomedical, technical, and scientific topics, including search planning, source screening, synthesis, citation checks, and evidence logging.

affaan-m/motion-ui

Production-ready UI motion system for React/Next.js. Use when implementing animations, transitions, or motion patterns.

affaan-m/project-guidelines-example

Example project-specific skill template based on a real production application.

affaan-m/pubmed-database

Direct PubMed and NCBI E-utilities search workflows for biomedical literature, MeSH queries, PMID lookup, citation retrieval, and API-backed literature monitoring.

affaan-m/scholar-evaluation

Structured scholarly-work evaluation for papers, proposals, literature reviews, methods sections, evidence quality, citation support, and research-writing feedback.

affaan-m/uspto-database

USPTO patent and trademark data workflow for official record lookup, PatentSearch queries, TSDR checks, assignment data, and reproducible IP research logs.

agent-architecture-audit

Full-stack diagnostic for agent and LLM applications. Audits the 12-layer agent stack for wrapper regression, memory pollution, tool discipline failures, hidden repair loops, and rendering corruption. Produces severity-ranked findings with code-first fixes. Essential for developers building agent applications, autonomous loops, or any LLM-powered feature. Use when an agent or LLM feature misbehaves and the failing layer is unknown, or before shipping an agent stack.

agent-eval

Head-to-head comparison of coding agents (Claude Code, Aider, Codex, etc.) on custom tasks with pass rate, cost, time, and consistency metrics. Use when choosing between coding agents, or when a change to an agent setup needs measured pass rate, cost, and time rather than an impression.

agent-harness-construction

Design and optimize AI agent action spaces, tool definitions, and observation formatting for higher completion rates. Use when defining or revising an agent

agentic-engineering

Operate as an agentic engineer using eval-first execution, decomposition, and cost-aware model routing. Use when planning or executing engineering work that agents will carry out end to end.

agentic-os

Build persistent multi-agent operating systems on Claude Code. Covers kernel architecture, specialist agents, slash commands, file-based memory, scheduled automation, and state management without external databases. Use when building a persistent multi-agent system on Claude Code with its own memory, commands, and scheduling.

agent-introspection-debugging

Structured self-debugging workflow for AI agent failures using capture, diagnosis, contained recovery, and introspection reports. Use when an agent run fails and you need a reproducible diagnosis instead of a retry.

agent-payment-x402

Add x402 payment execution to AI agents with per-task budgets, spending controls, and non-custodial wallets. Supports Base through agentwallet-sdk and X Layer through OKX Payments / OKX Agent Payments Protocol. Use when an agent must pay for something itself and needs per-task budgets, spending controls, and a non-custodial wallet.

相关技能