1
server_name: "家服务器名称，比如：m.2x.nz"
2
public_baseurl: "公共URL，比如：https://m.2x.nz"
3
pid_file: /data/homeserver.pid
4

5
serve_server_wellknown: true # 启用联邦
6

7
listeners:
8
  - port: 8008
9
    tls: false
10
    type: http
11
    x_forwarded: true
12
    resources:
13
      - names: [client, federation]
14
        compress: false
15
    response_headers:
16
      Access-Control-Allow-Origin: "https://app.element.io"
17
      Access-Control-Allow-Methods: "GET, POST, OPTIONS"
18
      Access-Control-Allow-Headers: "Content-Type, Authorization"
19

20
database:
21
  name: psycopg2
22
  args:
23
    user: synapse
24
    password: 你的数据库密码
25
    dbname: synapse
26
    host: 你的PostgreSQL的容器名称
27
    cp_min: 5
28
    cp_max: 10
29

30
log_config: "/data/my.matrix.host.log.config"
31
media_store_path: /data/media_store
32

33
registration_shared_secret: "这里的东西是随机生成的，每个人都不一样，请忽略这一块，并使用你的配置"
34
macaroon_secret_key: "这里的东西是随机生成的，每个人都不一样，请忽略这一块，并使用你的配置"
35
form_secret: "这里的东西是随机生成的，每个人都不一样，请忽略这一块，并使用你的配置"
36
signing_key_path: "/data/my.matrix.host.signing.key"
37

38
report_stats: false
39

40
trusted_key_servers:
41
  - server_name: "matrix.org"
42

43
# Github OAuth
44
oidc_providers:
45
  - idp_id: github
46
    idp_name: Github
47
    idp_brand: "github"  # optional: styling hint for clients
48
    discover: false
49
    issuer: "https://github.com/"
50
    client_id: "Ov23liaHxxYHybb0jRoZ" # TO BE FILLED
51
    client_secret: "e937f214ea7c132924ab34c76d83f4b7099d696e" # TO BE FILLED
52
    authorization_endpoint: "https://github.com/login/oauth/authorize"
53
    token_endpoint: "https://github.com/login/oauth/access_token"
54
    userinfo_endpoint: "https://api.github.com/user"
55
    scopes: ["read:user"]
56
    user_mapping_provider:
57
      config:
58
        subject_claim: "id"
59
        localpart_template: "{{ user.login }}"
60
        display_name_template: "{{ user.name }}"
61

62
### ✅ 邮件配置（确保SMTP验证正常）
63
email:
64
  smtp_host: "你的SMTP发件服务器"
65
  smtp_port: 465
66
  smtp_user: "你的发件邮箱"
67
  smtp_pass: "你的SMTP密码"
68
  force_tls: true
69
  notif_from: "Matrix <你的发件邮箱>"
70
  validation_token_lifetime: "5m"
71

72
### ✅ 启用注册 + 邮箱验证 + 密码找回
73
enable_registration: true
74
registrations_require_3pid:
75
  - email
76
registration_requires_token: false   # 确保不强制邀请码注册（默认关闭）
77
password_config:
78
  enabled: true
79

80
### ✅ 允许邮箱登录
81
login_via_existing_session:
82
  enabled: true
83

84
rc_registration:
85
  per_second: 0.003  # 每秒允许的注册请求（例如：0.003 ≈ 每5分钟一次）
86
  burst_count: 1     # 同一IP地址的最大注册突发数
87

88
  # 消息发送速率限制
89
rc_message:
90
  per_second: 0.2    # 每秒允许发送的消息数
91
  burst_count: 10    # 突发消息缓冲区大小
92

93
# 房间加入速率限制
94
rc_joins:
95
  local:
96
    per_second: 0.1   # 本地用户加入房间的速率
97
    burst_count: 10
98
  remote:
99
    per_second: 0.01  # 远程用户加入房间的速率
100
    burst_count: 10
101

102
# 媒体保留设置
103
media_retention:
104
  # 本地媒体文件的保留时间
105
  local_media_lifetime: 90d
106

107
  # 远程媒体文件的保留时间（来自其他homeserver的媒体）
108
  remote_media_lifetime: 14d
109

110
# 删除陈旧设备的时间
111
delete_stale_devices_after: 1y
112

113
auto_join_rooms:
114
  - "#XXX:你的家服务器URL" # 需要自动加入的房间