Sympa 6.2.80 配置参数详解

目标：覆盖 Sympa 三层配置文件（sympa.conf / robot.conf / 每列表 config）的主要参数，按 8 个功能组讲解名称、默认值、格式与生效层级，穿插 B1 实测排障结论（别名文件权限、Postfix 双 map）和 sympa.conf.in 安装必改参数速查。所有参数定义均出自 6.2.80 官方源码 Sympa::Config::Schema 与 sympa_config(5) man page（2026-10-27 读取）。组件背景见 《Sympa 6.2.80 介绍与选型指南》，安装实测见 《Sympa 6.2.66 Ubuntu 22.04 安装指南》，Compose 化部署见 《Sympa 6.2.66 Docker Compose 部署指南》。

一、配置体系概述

1.1 三层继承（覆盖规则）

Sympa 有三级配置文件，底层到顶层逐层覆盖：

查找顺序：某参数在列表 config 里有则用它，否则查 robot.conf，再否则回退 sympa.conf，最终兜底源码内置默认值。

1.2 参数格式

两类参数（6.2.70 起 compound 参数改 . 分隔语法，保留空格分隔兼容）：

• 简单参数：一行一个，空格分隔。listmaster listmaster@example.org

• 复合参数（compound）：以段落方式写，首行是组名，后续缩进子参数（或用 . 连接）。

  # 旧语法（空格 + 缩进）
  archive
    web_access open
    mail_access closed
  
  # 新语法（6.2.70+，点号）
  archive.web_access open
  archive.mail_access closed
  

1.3 上下文（context）

每个参数声明所属层级——只能在哪几个文件里出现。man page 里的 context 字段：

• site → sympa.conf 专属（如 db_* 数据库参数）
• domain → robot.conf 可选（如 domain、listmaster，站点和域都能设）
• list → 单列表 config 专属（如 subject、visibility）
• 有些参数同时支持 site + domain + list 三层（如 lang、priority）

二、安装必改参数速查

sympa.conf.in 官方最小模板（Debian 包自动生成，72 行）只标了 6 个必须手动设置的参数——其他全部走内置默认值即可跑通：

B1 实测追加的必改项（Debian 包默认值有坑）：

💡 这一条是 B1 唯一卡壳的点，postfix 双 map（hash:/etc/aliases, hash:/var/lib/sympa/sympa_aliases）同时引用系统别名与 sympa 别名即解决。详见 《Sympa 6.2.66 Ubuntu 22.04 安装指南》 第三章。

三、功能组详解

以下按 Schema.pm 的 group 划分，覆盖核心与高频参数。每组先给组名 + 关键参数表格，再给实测/默认值示例。

3.1 站点描述（presentation + description）

决定服务对外长什么样：标题、语言、虚拟域、可见性、列表定义。

visibility 四个可选值：

3.2 数据库（database）

全部 site 级，Debian 包用 SQLite 开箱即用，生产 MySQL/PG 配完整连接参数。

3.3 日志（logging）

B1 实测：Debian 包默认 log_level=0，查问题时临时 log_level 2 重启 sympa.service 即可，不影响投递。

3.4 MTA 对接（mta）

Sympa 不自带 MTA，通过以下参数桥接 Postfix/Exim/Sendmail。

B1 实测 Postfix 完整对接：

# sympa.conf 必加
sendmail_aliases /var/lib/sympa/sympa_aliases

# Postfix main.cf
alias_maps     = hash:/etc/aliases, hash:/var/lib/sympa/sympa_aliases
alias_database = hash:/etc/aliases, hash:/var/lib/sympa/sympa_aliases

3.5 接收控制（incoming）

Sympa_msg.pl 收信时的判定与改写。

3.6 投递与分发（sending + command）

Bulk 引擎投递策略、digest 行为、命令行改写。

3.7 归档 / 退信 / 周期任务（archive + bounce + tasks）

全部以 compound parameter（paragraph 或点号分隔）写法，man page 给了完整子参数。

Archive（归档）

# 段写法
archive
  web_access open
  mail_access closed
  default_index by_thread

# 点号写法（6.2.70+）
archive.web_access open
archive.mail_access closed
archive.default_index by_thread

Bounce（退信处理）

周期任务（tasks）

Sympa 自带大量内建周期任务（/etc/sympa/tasks/），以下几个参数控制调度频率。

3.8 Web / SOAP / 安全（web + soap + security）

四、列表 config 专属参数（list 层级）

建列表时自动生成，全部在 /var/lib/sympa/list_data/<list>@<domain>/config。高频：

💡 scenario 授权语言：Sympa 特色 DSL——send/subscribe/review 等每个动作都有独立 scenario 文件，按「认证方式 + 角色 + 规则」组合判定放行/拒绝/转审批。新建列表选模板（discussion_list/news_letter/confidential/private_working_group 等）即预置一整套 scenario，生产定制直接改 config 里的 send/subscribe 等段引用不同 scenario 文件名，无需改代码。

五、废弃参数与版本语法

5.1 6.2.70 起 compound 参数 . 分隔

旧语法（缩进）自动兼容，新部署建议直接用点号：

# 旧
archive
  web_access open

# 新（等价）
archive.web_access open

5.2 废弃参数（6.2.70+）

5.3 同名多义参数（兼容别名）

Sympa 保留了三对因历史原因并存的别名，行为完全一致：

六、FAQ

• 改了 sympa.conf 要不要重启？ 要。systemctl restart sympa.service，列表 config 改动需要 sympa reload_list_config 或重启 sympa_msg.pl 刷新 config.bin 缓存。
• robot.conf 放哪？ /etc/sympa/sympa/<domain>/robot.conf（domain 即虚拟域全限定名），多域场景每域一个。
• 改 list config 后生效时间？ sympa_msg.pl 轮询 config.bin，默认几秒内；reload_list_config 立即刷新。
• sendmail_aliases 改成 none 会怎样？ Sympa 不再管理别名，MTA 侧别名需手工维护；适合 alias_manager 走 LDAP/SQL 外部数据源的场景。
• db_timeout 为啥配了没反应？ 当前仅 SQLite 实现了超时，MySQL/PG 由驱动层控制；6.2.80 没实现应用层超时。
• dkim_feature on 了但出站邮件没 DKIM 头？ 先检查 dkim_private_key_path 指向的私钥文件是否可读（sympa 用户），再看 dkim_signature_apply_on 是否包含 standard（默认可能只对 MDN 加签）。

七、参考链接

• sympa.conf.in 官方模板（Debian 包内）：/etc/sympa/sympa/sympa.conf（安装后）
• sympa_config(5) man page 在线版：https://www.sympa.community/gpldoc/man/sympa_config.5.html（本文主要来源）
• 源码 Schema.pm（参数定义本体）：/opt/data/quzuo/tmp/sympa/src/src/lib/Sympa/Config/Schema.pm
• params_all.txt（6.2.80 全量参数名采集，388 个）：/opt/data/quzuo/tmp/sympa/params_all.txt
• B1 安装指南（别名权限坑、Postfix 双 map 实测）：《Sympa 6.2.66 Ubuntu 22.04 安装指南》
• B2 Compose 部署（entrypoint 里 sendmail_aliases 注入）：《Sympa 6.2.66 Docker Compose 部署指南》
• 选型篇（scenario 授权语言、进程族架构）：《Sympa 6.2.80 介绍与选型指南》