8448 是什么
8448 是 Matrix 协议服务器间联邦通信的默认端口。Matrix 是去中心化的通信协议，Element 等客户端背后是 homeserver（常见实现是 Synapse）：不同服务器上的用户处在同一房间时，需要互相投递事件，这段服务器到服务器的通信就是联邦。Synapse 默认在 8448 上以 HTTPS 提供联邦 API；如果不希望单独开放端口，也可以用 443 上的反向代理配合 /.well-known/matrix/server 声明来完成同样的效果。
基本信息
| 服务 | Matrix federation（Synapse 等） |
|---|---|
| 协议 | TCP/HTTPS |
| 用途 | 跨服务器房间事件投递 |
| 客户端通道 | 443（客户端到服务器 API） |
| 替代暴露方式 | 443 反代 + .well-known 委托 |
| 安全等级 | 公网可达但需限流与审计 |
典型使用场景
- 自建 homeserver 接入联邦：核对 .well-known 与证书链是否正常
- 联邦排障：确认域名解析、证书与反向代理配置三段是否连通
- 资源治理：限制陌生服务器的拉取频率与房间历史查询
- 安全审查：核查联邦白名单与黑名单策略的实际配置
- 容量评估：参与房间数量与事件量对服务器资源的影响
- 客户端接入排障：区分联邦故障与客户端 API 故障
Matrix 相关端点
| 地址 | 用途 | 说明 |
|---|---|---|
| https://host:8448/_matrix/federation/v1/version | 联邦版本探测 | 确认联邦服务可用 |
| https://host/.well-known/matrix/server | 联邦委托声明 | 指向实际联邦地址与端口 |
| https://host/_matrix/client/versions | 客户端 API | Element 等客户端使用 |
| https://host/_matrix/key/v2/server | 服务器签名密钥 | 联邦信任链的基础 |
联邦探测
联邦探测
curl -s https://matrix.example.com:8448/_matrix/federation/v1/version | head -c 200
curl -s https://example.com/.well-known/matrix/server
ss -lntp | grep 8448
# Synapse 配置: federation_listener 与 delegation 需一致
# 证书核对: openssl s_client -connect matrix.example.com:8448 -servername matrix.example.com联邦是默认对外开放的机制：任何知道域名的服务器都可以向你的 homeserver 投递事件，因此限流、房间可见性策略与资源上限属于部署时的必配项。
证书必须与联邦域名一致：不匹配时对端会拒绝投递，现象是本机正常但跨服务器内容不同步，排查要从证书链开始。
联邦流量是双向长连接式的：出口策略只放行入向时，本机发出的消息对方收不到，表现为单向不同步。
房间历史与媒体文件也会经联邦拉取：限制太严会破坏正常使用，限制太松会带来带宽与存储压力，取值需要结合使用场景。