NixOS下Matrix Synapse共享密钥注册未生效问题求助

问题描述 #

在NixOS上配置Matrix Synapse后，联邦功能正常，但注册新用户时收到错误：

ERROR! Received 400 Bad Request
Shared secret registration is not enabled

尝试通过services.matrix-synapse.extraConfigFiles加载包含registration_shared_secret: secret的配置文件，但生成的homeserver.yaml中并未设置该密钥，怀疑是配置加载失败导致的问题。用户的完整Synapse配置如下：

{ pkgs, lib, config, ... }:
{
  services.postgresql.enable = true;
  services.postgresql.initialScript = pkgs.writeText "synapse-init.sql" ''
    CREATE ROLE "matrix-synapse" WITH LOGIN PASSWORD 'XXX';
    CREATE DATABASE "matrix-synapse" WITH OWNER "matrix-synapse"
      TEMPLATE template0
      LC_COLLATE = "C"
      LC_CTYPE = "C";
  '';

  services.matrix-synapse = {
    enable = true;
    settings.server_name = "m.metacortex.space";
    settings.enable_metrics = true;

    settings.database.name = "psycopg2";
    settings.database.args = {
        user = "matrix-synapse";
    password = "XXX";
    };
    settings.listeners = [
      {
        bind_addresses = [ "localhost" ];
    port = 8448;
    tls = false;
       resources = [
          { compress = true; names = ["client" "federation"]; }
      { compress = false; names = [ "federation" ]; }
        ];
    type = "http";
    x_forwarded = false;
      }
      {
    bind_addresses = [ "127.0.0.1" ];
    port = 8008;
    resources = [ { compress = true; names = [ "client" "federation" ]; }
    ];
    tls = false;
    type = "http";
    x_forwarded = true;
      }

    ];
  };
  services.matrix-synapse.extraConfigFiles = [
    "/etc/nixos/modules/matrix-shared-secret" ];

}

解决步骤 #

1. 修正extraConfigFiles的配置位置 #

你当前将extraConfigFiles放在了services.matrix-synapse块的外部，这会导致Nix无法正确将该属性合并到Synapse的配置中。需要把它移到services.matrix-synapse的大括号内部：

services.matrix-synapse = {
  enable = true;
  settings.server_name = "m.metacortex.space";
  settings.enable_metrics = true;
  # ... 其他现有配置 ...
  
  # 将extraConfigFiles移到这里
  extraConfigFiles = [ "/etc/nixos/modules/matrix-shared-secret" ];
};

2. 检查额外配置文件的权限与内容 #

确保/etc/nixos/modules/matrix-shared-secret文件存在，且Synapse进程用户（matrix-synapse）拥有读取权限：

# 查看文件权限
ls -l /etc/nixos/modules/matrix-shared-secret
# 如果权限不足，修改为matrix-synapse可读
sudo chown root:matrix-synapse /etc/nixos/modules/matrix-shared-secret
sudo chmod 640 /etc/nixos/modules/matrix-shared-secret

同时确认文件内容格式正确，是标准的YAML：

registration_shared_secret: "你的共享密钥内容"

3. 直接通过settings配置共享密钥（替代方案） #

如果额外配置文件的方式仍不生效，可以直接在Synapse的settings中定义密钥，这种方式更可靠：

services.matrix-synapse = {
  enable = true;
  # ... 其他现有配置 ...
  settings.registration_shared_secret = "你的共享密钥";
};

注意：建议使用Nix的秘密管理工具（如sops-nix）存储密钥，避免明文写在配置文件中。

4. 应用配置并验证 #

修改配置后，重新构建系统配置并重启Synapse服务：

sudo nixos-rebuild switch
sudo systemctl restart matrix-synapse.service

然后检查生成的homeserver.yaml（通常位于/var/lib/matrix-synapse/homeserver.yaml），确认registration_shared_secret已正确设置。最后用register_new_matrix_user工具测试注册：

register_new_matrix_user -u 新用户名 -p 密码 -k 你的共享密钥 http://localhost:8008

内容的提问来源于stack exchange，提问作者0x01_PH