Synapse用户目录搜索问题解析与解决方案

在Matrix生态系统中，Synapse作为主流的家庭服务器实现，其用户目录功能是用户发现和交互的重要基础。近期有管理员反馈在全新安装的Synapse 1.130.0版本中，虽然能够成功创建用户并通过Element客户端登录，但用户之间无法互相搜索到对方。这个看似简单的现象背后，实际上涉及Synapse的用户目录设计机制。

问题本质分析

Synapse的用户目录搜索并非简单地列出所有注册用户，而是基于特定的隐私保护机制。默认配置下，用户目录仅会显示以下两类用户：

1. 与当前用户存在于同一个公开房间的成员
2. 与当前用户存在于任意共享房间的成员（包括私有房间）

这种设计源于Matrix协议对用户隐私的重视，防止未经授权的用户发现和联系。在全新安装的服务器环境中，由于尚未创建任何房间，用户之间自然无法互相发现。

技术实现原理

Synapse的用户目录功能通过以下机制运作：

• 用户目录索引构建时，会排除未满足可见条件的用户
• 搜索请求（/_matrix/client/r0/user_directory/search）仅返回通过可见性检查的结果
• 管理员可以通过配置文件调整用户目录的可见性策略

解决方案与配置建议

要使新建用户能够互相发现，管理员有以下几种选择：

1. 创建公共房间并邀请用户加入 这是最推荐的做法，既保持了系统的开放性，又符合社交发现的基本逻辑。创建方法：

   /create room -p -n "公共大厅"
   

2. 修改用户目录策略 在homeserver.yaml配置文件中调整以下参数：

   user_directory:
     # 允许搜索所有本地用户
     search_all_users: true
     # 允许搜索所有已知用户（包括远程）
     prefer_local_users: false
   

   注意：这种配置会降低隐私保护级别

3. 手动触发用户目录更新 对于已存在的用户，可以强制重建索引：

   synapse_port_db --update-user-dir
   

最佳实践建议

对于不同规模的部署，建议采用不同的策略：

• 小型私有部署：可以启用search_all_users以简化管理
• 中型社区部署：建立适当的公共房间体系
• 大型公开部署：保持默认配置，通过房间机制控制可见性

管理员还应该注意，用户目录变更可能需要时间同步到所有客户端，Element等客户端通常会缓存搜索结果以提升性能。在修改配置后，建议用户清除客户端缓存或等待缓存过期。

通过理解这些机制，管理员可以更好地规划Matrix部署的用户发现策略，在便利性和隐私保护之间取得平衡。