sing-box 的 cache_capacity 用来设置 DNS LRU 缓存容量。官方 DNS 文档标注该字段自 sing-box 1.11.0 起提供,并说明小于 1024 的值会被忽略。它只影响核心 DNS 缓存条目数量,不会替你选择 DNS 服务器,也不能直接证明解析更快。调参前要固定网络、查询域名和规则条件。
记录基线并确认版本
保存当前配置和运行日志,记录 sing-box 版本、DNS server 标签、disable_cache、disable_expire、optimistic,并检查实际生效 JSON。若版本早于文档注明的 1.11.0,先以当前版本校验器结果为准。
设置容量并避免冲突
字段位于顶层 dns 对象,以下片段应合并到现有配置:
{
"dns": {
"cache_capacity": 4096
}
}
示例的 4096 只是满足文档下限的演示值。disable_cache 会关闭 DNS 缓存,disable_expire 会关闭缓存过期;若它们生效,容量设置不会产生预期效果。independent_cache 已标记为弃用,不能替代容量参数。
观察命中与回滚
- 只改
cache_capacity,先运行当前核心的配置检查。 - 重载后按固定顺序查询同一批域名,分别记录首次查询、重复查询、过期后的结果和错误。
- 观察日志中的缓存行为、服务器标签和返回地址;不要用浏览器页面加载时间单独判断命中。
- 如果内存增长、结果异常或校验失败,恢复原值或删除该字段,再重新加载。
查询结果变化也可能来自上游 TTL 或规则。需要区分服务器缓存时,可参考 sing-box independent_cache 检查;排查服务器地址和策略时看 sing-box DNS 服务器配置迁移。
官方来源
来源核验日期:2026-10-26。官方文档标注 cache_capacity 自 1.11.0 起可用,且小于 1024 的值会被忽略;本文未给出性能承诺。