文档首页

节点库：管理独立节点并测试代理是否可用

本页目录：先做一次 · 节点与列表操作 · 怎么看测速结果 · 测速 DNS 怎么选 · OxiDNS 托管入口 · 生效与备份范围

入口：共享资源 → 节点库。这里能添加独立节点，也能查看订阅缓存里的节点。共享节点被多个配置使用时，修改、停用或删除都会影响这些配置之后生成的结果。

先做一次

1. 只有一个链接时点「添加节点」；有多个链接或一份节点列表时点「批量添加」。
2. 粘贴服务商或你自己提供的 URI、JSON、YAML、Surge / Loon 节点行。不要只填服务器地址，连接还需要协议、端口和认证信息。
3. 保持启用并保存，找到该节点，点「单独测速」。
4. 测试成功后，到 策略组 勾选「手动节点」并选择它。节点库里存在并不代表它已经进入当前配置。

手机端的「批量添加」「调整顺序」在标题旁的更多菜单里。

节点与列表操作

选项／按钮	是做什么的；推荐怎么用
节点名称	给节点取易辨认的名称，例如“香港－自建”；建议不同实际节点用不同名字，避免选择或聚合时混淆。
备注	自己的说明，例如用途或到期提醒。可留空，不代替连接参数。
节点字符串	粘贴完整连接配置。页面按内容识别协议；协议专用字段在这段原始配置中，不是另有一套可视化开关。不要凭猜测删除 UUID、密码、TLS、传输路径等参数。
节点启用中／节点已停用	开启后可参与生成和测速；关闭保留记录，但正常使用时不再采用它。停用前检查策略组是否只剩这一个节点。
批量添加：节点链接或配置	可粘贴多行 URI，或 JSON/YAML 节点列表；支持 Surge / Loon 节点行，忽略空行和 // 注释。读导入结果，不要假定每一行都成功。
导入后默认启用／禁用节点	开启可直接选用；关闭适合先录入、稍后核对，但之后必须逐个或按操作启用才能正常使用。
搜索名称、地址或备注	只影响显示，不会改节点。
来源、地区、协议筛选	点击只看该类，再点可取消；地区依据节点信息展示，不是位置认证。
全选／取消全选	作用于当前可选且可见的节点；之前在其他筛选下选中的项可能继续保留，删除前看总数。
卡片／列表	只改显示方式；小屏可能固定为适合手机的布局。
节点详情	查看协议与原始参数。包含凭据的内容不要直接发到公开群。
编辑、启用／停用、删除	手动保存的节点可管理；订阅缓存预览不是独立副本，来源节点需回「订阅来源」管理。实际可操作项以该行按钮为准。
删除 N 项	逐项删除所选节点；仍被配置或聚合使用的项会失败，可能出现部分成功。先解除引用，再重试剩余项。
调整顺序	进入排序后查看完整可排序列表，保存才提交；取消还原这次排序。
单独测速	只测试该节点。先测一个，适合确认配置或 DNS 问题。
全部测速	测试当前筛选后显示的节点，不是自动覆盖所有隐藏来源；执行中显示完成数。
测速设置	选择测速专用 DNS。具体见下两节。

怎么看测速结果

这里测的是 ConfigFlow 所在服务器或容器，经这个节点访问测试地址的 HTTP 代理延迟。它不是浏览器到节点的 ping，也不是下载带宽，更不等于其他设备使用该节点时的延迟。

成功结果按毫秒显示，数值较小表示这次请求更快。超时、失败、未测试和不可用要分开看：未测试不能当成 0 毫秒；“不可用”可能是节点或来源已删除、停用，先刷新列表。结果带时间，网络变化后应重新测试。项目使用独立测速组件，不会为了这次测速切换运行中的 Mihomo 策略组。

默认测试地址是 https://www.gstatic.com/generate_204，超时为 5000 毫秒；这些运行参数由部署环境设置，不在本页提供一个任意修改超时的输入框。设备上的核心健康检查也有各自的 URL 与超时，别把两处结果混在一起比较。

需要更换测速地址或等待时间时怎么改

普通使用保持默认即可。确需修改时，在 ConfigFlow 面板容器的环境变量中添加对应项，然后重新创建容器；Compose 用户修改 environment 后运行 docker compose up -d。这些设置只影响节点库测速。

环境变量	默认值	修改后的结果
CONFIGFLOW_NODE_TEST_URL	https://www.gstatic.com/generate_204	改为通过节点访问的测试网址，需支持 HEAD 请求，建议使用 HTTPS
CONFIGFLOW_NODE_TEST_TIMEOUT_MS	5000	每个节点最多等待多少毫秒，允许 500–10000；调长会等待更久，不会让节点变快
CONFIGFLOW_NODE_TEST_UNIFIED_DELAY	1	默认先连接一次，再计时第二次请求；改为 0 或 false 后显示包含首次连接过程的耗时
CONFIGFLOW_NODE_PROBE_BIN	自动查找	测速程序的路径。官方镜像无需填写，只有自行部署程序时才按实际位置设置

若提示测速组件缺失或版本不匹配，Docker 用户应更新完整镜像并重新创建容器，保留原数据目录。仅替换面板的部分文件不能补齐测速程序；面板和测速程序需要配套更新。

测速 DNS 怎么选

DNS 负责先把节点服务器的域名查成 IP。测速需要真实 IP；如果查到 Mihomo 提供的临时 Fake-IP，独立测速可能无法连接。

模式／字段	推荐选择；保存后的结果
系统 DNS	系统本来就能解析出真实 IP 时优先用。这里的“系统”指 ConfigFlow 服务器或容器，不是当前浏览器、手机，也不保证等于宿主机的设置。
自定义 DNS	你已有可访问、返回真实 IP 的 DNS 时使用；每行一个 IPv4 地址、IPv4:端口、https://主机/路径（DoH）或 tls://主机[:端口]（DoT）。当前这组输入不接受 IPv6 字面地址，不要套用 OxiDNS 所有协议的格式。
引导 DNS	自定义上游使用域名时才需要：先找到 DNS 服务商的 IP，再通过它查节点域名。填 IPv4 或 IPv4:端口，每行一个，最多 4 个；不要指回会形成循环的同一 Fake-IP 入口。
OxiDNS 托管	已有受 ConfigFlow 管理的 OxiDNS，想单独提供一个真实 IP 查询入口时使用。创建会向所选设备发布，不能把它当成纯本地表单。
检测	用当前尚未保存的选择发起 DNS 检查，展示真实返回结果。只做检测，不保存测速设置，也不增加节点测速历史。
保存	保存模式和对应参数，供后续测速使用；不改变已完成的历史测试，也不修改所有客户端的 DNS。
取消	放弃尚未保存的模式/输入；已经创建在设备上的托管入口不会因为关掉窗口就自动删除。

自定义 DoH/DoT 地址不要带账号、查询参数或片段。优先使用你能确认服务可达、用途明确的 DNS；选择哪个公共 DNS 不是这份手册替你规定的网络策略。

OxiDNS 托管入口

1. 选择「OxiDNS 托管」，再选 OxiDNS 设备。看清旁边显示的配置空间。
2. 已有入口且状态可用时直接选择；否则选「创建新入口」。
3. 上游来源可选「现有上游」或手动填写。现有上游来自设备已经发布的配置，创建时复制一份参数，原上游以后改动不会自动同步到这个专用入口。
4. 核对监听地址和端口，通常先保留建议值 15353；不需要抢占客户端正在用的 53。
5. 点「创建并启用」。系统发布并检测真实 IP 返回，验证成功才保存绑定；失败时保留原测速设置和错误信息。

选项／操作	解释
OxiDNS 设备	实际承载新入口的 Agent。跨配置空间使用时尤其要核对设备名称；这里选错会向另一台设备发布。
专用 DNS 入口	复用已有入口，或创建一条新的入口。状态未验证成功时不能假装可用直接保存。
现有上游／刷新上游	读取设备现有上游供选择；不可用项有原因。出现在列表里不等于已经通过真实 IP 检测。
上游 DNS	手填 IPv4、DoH 或 DoT 地址；按这个面板支持的格式填写。
引导 DNS	手填上游是域名时需要一个 IPv4[:端口]，用途与前节相同。
监听 IPv4	选择 ConfigFlow 可访问到的设备地址；不要把只在另一个容器内部可用的地址当成局域网地址。
端口	专用入口使用的端口；必须在设备上可用，并能从 ConfigFlow 到达。
刷新状态	重新核对已有入口状态，不等于重新创建。
移除入口	明确删除并发布到设备的操作，需要确认；先确保不再使用该入口。单纯切换到系统或自定义 DNS 不会执行删除。

生效与备份范围

节点保存会修改共享资源，运行中的客户端仍需更新配置或重新发布。测速设置只影响下一次面板测速；不修改 策略组健康检查。

完整数据导出可用于备份节点配置，其中可能有密码和密钥；脱敏导出不适合恢复真实连接。测速历史等运行文件不能只靠配置 JSON 保全，迁移时按部署指南备份整个数据目录。

下一步：策略组，或把独立节点与订阅放进 订阅聚合。