Linux SSH服务端配置冲突时,Include与Match规则按什么优先级生效?
明明在 /etc/ssh/sshd_config 中写了 PermitTTY no,检查运行中的 SSH 服务却发现特定用户仍能获得终端。问题不一定是配置没加载:更早读入的 Include 文件可能已经给出了全局值,而匹配该用户的 Match 块又可能覆盖全局设置。
判断 Linux SSH 服务端配置时,要把两层规则分开:全局配置按读取顺序处理,同一普通选项通常采用先取得的值;命中的 Match 配置可以覆盖全局值,而多个命中的 Match 块对同一普通选项通常也是先出现的设置生效。 Include 不是“优先级更高”的配置层,它只是把其他文件插入当前位置参与读取。排查时既要确认文件顺序,也要带上连接条件验证,不能只看主文件的最后一行。
先分清配置边界:Include 决定读取位置,Match 决定适用连接
本文讨论的是 OpenSSH 服务端 sshd 的配置,即通常位于 /etc/ssh/sshd_config 的文件,以及其中 Include 引入的文件。它不等同于 SSH 客户端的 ~/.ssh/config;两者即使使用了相似的关键字,也不能套用同一套优先级解释。
Include 可指定文件或通配路径。读取主配置时,遇到 Include,服务端就在该位置处理被包含的内容,然后继续处理后续配置。因此,下面的写法并不意味着主文件中的设置一定胜出:
Include /etc/ssh/sshd_config.d/*.conf
PermitTTY no
如果匹配到的较早文件已在全局范围写入 PermitTTY yes,主文件后面的 PermitTTY no 通常不会再替换这个全局值。对通配路径,匹配文件按词法顺序处理;10-site.conf 与 90-policy.conf 的文件名顺序因此可能直接影响结果。但文件名本身没有特殊权限,真正重要的是它们被读取的位置和顺序。
Match 则用于描述连接条件,例如用户或来源地址。命中后,其下方允许放入 Match 的选项按条件应用,直到下一个 Match 或配置结束。与全局段的先取值规则不同,命中的 Match 设置能够覆盖全局设置。若同一次连接又命中多个 Match 块,不能简单理解成“越靠后越优先”:对同一普通选项,应重点检查第一个命中的设置。

这里的“先取值”是排查普通单值选项的实用原则,不应机械套到所有关键字。部分选项允许多次出现并累积内容;判断这类选项时,还要查对应版本的 sshd_config 手册及最终输出。
用一组冲突配置看实际生效过程
下面是用于说明规则的示例。主文件先引入目录中的配置,再设置一个全局值,最后给出两个条件块:
# /etc/ssh/sshd_config
Include /etc/ssh/sshd_config.d/*.conf
PermitTTY no
Match User release
PermitTTY no
Match Address 192.0.2.0/24
PermitTTY yes
两个被包含文件的内容分别为:
# /etc/ssh/sshd_config.d/10-site.conf
PermitTTY yes
# /etc/ssh/sshd_config.d/20-policy.conf
PermitTTY no
先只看全局段:10-site.conf 中的 PermitTTY yes 最早被读取,20-policy.conf 和主文件中较后的 PermitTTY no 不会因为位置更靠后而覆盖它。因此,不命中上述 Match 设置的连接,预期全局值为 yes。
再看具体连接。用户 release 从 192.0.2.20 连接时,同时命中 Match User release 和 Match Address 192.0.2.0/24。前一个命中的块先设置 PermitTTY no,后一个块的 PermitTTY yes 不会把它改回去。其他用户从该地址段连接,只命中地址块,预期为 yes。
| 连接条件 | 命中的示例规则 | 预期 PermitTTY |
|---|---|---|
release,来源 192.0.2.20 | 用户块、地址块 | no |
release,来源不在该地址段 | 用户块 | no |
其他用户,来源 192.0.2.20 | 地址块 | yes |
| 其他用户,来源不在该地址段 | 无上述 Match 块 | 全局值 yes |
这也说明,不能用一句“Match 优先于 Include”概括结果:Include 引入的内容也可能位于 Match 范围内,或者包含自己的条件配置。应先确定实际读取顺序和作用范围,再判断哪些条件命中。
哪些因素会让判断与肉眼看到的不一致
检查的不是服务实际使用的文件
排查前先确认目标进程及其启动参数。若服务通过 sshd -f 指定了另一份配置文件,只查看 /etc/ssh/sshd_config 就可能得出错误结论。不同发行版的 systemd 单元名称也可能是 ssh 或 sshd,不要凭印象确定。
ps -ef | grep '[s]shd'
systemctl status ssh sshd --no-pager
状态命令中的某个单元显示不存在,不代表另一单元没有运行。若进程启动参数、服务单元或容器启动方式指定了配置路径,后续测试应使用同一份文件。
只看文件名,没有看 Include 所在位置
目录中有 10-<em>.conf、50-</em>.conf,不代表它们一定先于主文件所有设置生效。必须先在主文件中找到 Include:它之前的全局设置可能已经取得了值。此外,Include 可以写在条件配置中;遇到这种结构,不宜仅按目录文件名推断全局结果。
先只读检查主文件和目录,再定位相关关键字:
sudo sed -n '1,220p' /etc/ssh/sshd_config
sudo ls -la /etc/ssh/sshd_config.d
sudo grep -nE '^[[:space:]]*(Include|Match|PermitTTY)([[:space:]]|$)' /etc/ssh/sshd_config
目录不存在,或文件名不匹配 Include 指定的模式,都意味着预想中的片段未必被加载。检查片段时还应注意嵌套的 Include,不要只搜索主目录的第一层文件。
测试时漏掉了 Match 所需的连接条件
Match User、Match Address 判断的是一次具体连接,而不是“服务器当前的统一配置”。Address 对应客户端来源地址;LocalAddress 对应服务端接收连接的本地地址。若配置还使用 Match Host、LocalPort 等条件,测试时也要提供对应参数,否则测试输出不能代表目标连接。
另外,配置关键字与连接条件不是一回事。例如 PermitTTY 控制是否允许分配终端,但一次 SSH 连接是否请求终端,还与客户端调用方式有关。最终配置值是解释行为的重要依据,却不能代替对实际连接方式的检查。
按低风险顺序验证:先语法,再模拟连接
验证不必先重启服务。第一步是在已确认的配置文件上做语法检查。以下命令以常见的 /usr/sbin/sshd 路径为例;若本机路径不同,先用 command -v sshd 或检查实际服务启动参数确认。
sudo /usr/sbin/sshd -t -f /etc/ssh/sshd_config
命令成功且没有输出,表示配置通过了该项检查,不表示每个连接条件下的取值都符合预期。若失败,先读报错中的文件与行号;失败原因也可能涉及主机密钥或运行环境,不能一概归因于 Include 顺序。
第二步,用 sshd -T 查看解析后的有效配置,并通过 -C 提供连接条件。针对上面的示例,可分别测试“两个块都命中”和“只命中地址块”:
sudo /usr/sbin/sshd -T -f /etc/ssh/sshd_config \
-C user=release,addr=192.0.2.20 |
grep '^permittty '
sudo /usr/sbin/sshd -T -f /etc/ssh/sshd_config \
-C user=operator,addr=192.0.2.20 |
grep '^permittty '
按示例配置,第一条预期显示 permittty no,第二条预期显示 permittty yes。-T 通常以小写关键字输出结果;它能回答“给定条件下最终是什么值”,但不会直接标注“这个值来自哪个文件的哪一行”。来源仍需结合 Include 顺序、各文件内容和命中的 Match 块定位。
如果使用了更多条件,应补齐测试输入。例如配置含 Match LocalAddress 时,加入 laddr=服务端接收地址;含 Match Host 时,加入与待验证客户端对应的 host=...。只改变一项条件、重复运行 -T,通常比一次性猜测多个原因更容易定位冲突。
| 检查结果 | 更可能说明什么 | 下一步 |
|---|---|---|
-t 失败 | 语法、引用文件或运行环境存在问题 | 按报错定位,不先重载 |
-t 成功,-T 与预期不同 | 读取顺序或 Match 条件判断有误 | 核对 Include 位置及最早命中的设置 |
-T 符合预期,实际连接行为不同 | 测试条件或行为观察点可能不一致 | 核对实际用户、来源地址及客户端请求方式 |
不同地址的 -T 结果不同 | 条件配置正在发挥作用 | 分别记录各连接条件的预期值 |
修改配置时的适用限制与判断边界
sshd -T -C 适合验证某组连接参数下的配置解析结果,不是对登录成功率、网络连通性或整个会话行为的端到端测试。它也不能替你判断所有重复关键字是否都遵循普通单值选项的规则。对多次出现可累积的选项,应以对应版本的手册说明和完整输出为准,而不是套用 PermitTTY 示例。
若确需调整生产配置,先备份将要修改的主文件或片段,确认修改范围,并保留现有管理会话;编辑后先执行 sshd -t 和针对目标条件的 sshd -T -C。只有两者符合预期,再核实本机实际服务单元并安排重载,随后用新建连接验证。修改可能影响后续连接,不能把“现有会话仍在线”当作新配置正确的证据。若新连接表现异常,恢复备份文件、再次通过语法检查后,按已核实的服务单元重新加载。
排查这类冲突时,最终应能回答三个具体问题:服务读取的是哪份主配置;相关选项在全局读取顺序中第一次出现在哪里;目标连接依次命中了哪些 Match 设置。前两个问题解释 Include 的影响,第三个问题解释条件覆盖;再用同一组连接参数运行 sshd -T -C,才能把“看起来应该生效”变成可核对的结果。
A5idc数据提供香港、美国、日本、韩国、中国台湾、新加坡及马来西亚等地区的物理服务器资源,覆盖企业网站、业务后台、数据库和接口服务等 Linux 应用场景。不同产品配置配备多种 CPU、内存、SSD 或 NVMe 存储、带宽线路及多 IP 方案,可为 SSH 服务端配置、分区访问策略和多业务并行运行提供相应的服务器基础。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/7072.html



