postconf 命令详解

postconf - Postfix 配置工具，用于查询、修改和管理 Postfix 的配置文件（如 main.cf 和 master.cf）以及相关系统参数。
postconf 是 Postfix 邮件服务器的核心配置管理工具，支持以下功能：

• 查询配置参数：显示 main.cf 或 master.cf 的参数值。
• 修改配置参数：直接编辑 main.cf 文件。
• 调试配置：检查参数默认值、扩展变量、版本差异。
• 管理扩展功能：如 SASL、数据库类型、邮件模板等。

默认情况下，postconf 会显示 main.cf 的当前配置参数，并检查可能的参数拼写错误（Postfix 2.9+）。

基本语法

# 管理 main.cf 配置
postconf [-dfhnovx] [-c config_dir] [-C class,...] [parameter ...]
postconf [-ev] [-c config_dir] [parameter=value ...]
postconf [-#vX] [-c config_dir] [parameter ...]

# 管理 master.cf 配置
postconf [-fMovx] [-c config_dir] [service ...]

# 管理 bounce 消息模板
postconf [-btv] [-c config_dir] [template_file]

# 管理其他配置
postconf [-aAlmv] [-c config_dir]

选项

管理 main.cf 配置

选项	说明
-d	显示 main.cf 的默认参数值（而非当前实际值）。结合 -f 可折叠长行以增强可读性（Postfix 2.9+）。
-n	仅显示 main.cf 中显式配置的参数（忽略默认值）。结合 -f 可折叠长行。
-e	编辑 main.cf，将命令行中的 name=value 参数写入配置文件（Postfix 2.8+ 无需此选项）。
-#	注释掉 main.cf 中指定的参数（恢复默认值）。需指定参数名（非 name=value）。
-X	从 main.cf 中删除指定的参数。需指定参数名（非 name=value）。
-o name=value	临时覆盖 main.cf 中的参数值（仅当前会话生效）。
-x	递归展开 main.cf 或 master.cf 中的 $name 变量（如 $myhostname）。

管理 master.cf 配置

选项	说明
-M	显示 master.cf 内容（而非 main.cf）。结合 -f 可折叠长行。
-v	显示详细日志（调试用）。

管理 bounce 模板

选项	说明
-b [template_file]	显示 DSN（投递状态通知）消息的开头文本，替换 $name 表达式（如 $recipient）。可通过指定模板文件覆盖内置模板。
-t [template_file]	显示 DSN 模板内容（不展开 $name 表达式）。

其他功能

选项	说明
-a	列出支持的 SASL 服务端插件类型（如 cyrus, dovecot）。
-A	列出支持的 SASL 客户端插件类型（如 cyrus）。
-l	列出所有支持的邮箱锁定方法（如 flock, fcntl）。
-m	列出所有支持的查找表类型（如 hash, mysql, ldap）。
-C class,...	限制 main.cf 参数的显示范围（builtin, service, user, all）。

参数说明

main.cf 参数

• parameter: 指定要查询或修改的参数名（如 myhostname, relayhost）。
• parameter=value: 通过 -e 或 -o 设置参数值（需注意特殊字符转义）。

master.cf 服务

• service: 指定要查询的 master.cf 服务（如 smtp, pickup）。

配置目录

• -c config_dir: 指定 Postfix 配置文件目录（默认为 config_directory，通常为 /etc/postfix）。

典型使用场景

1. 查看当前配置参数

postconf myhostname relayhost

• 作用：显示 myhostname 和 relayhost 的当前配置值。

2. 显示默认参数值

postconf -d

• 作用：列出所有参数的默认值（适用于新安装的 Postfix）。

3. 修改 main.cf 配置

postconf -e "relayhost = [smtp.example.com]:587" "smtp_sasl_auth_enable = yes"

• 作用：设置 relayhost 和启用 SASL 认证。

4. 注释掉参数（恢复默认值）

postconf -# relayhost

• 作用：注释掉 main.cf 中的 relayhost 参数。

5. 列出支持的数据库类型

postconf -m

• 输出示例：hash, mysql, ldap, sqlite 等。

6. 查看 master.cf 服务

postconf -M

• 作用：显示 master.cf 的所有服务配置。

7. 调试配置变量

postconf -x -n

• 作用：显示当前配置并展开所有 $name 变量（如 $mydomain）。

注意事项

1. 版本差异：

   • -e 选项在 Postfix 2.8+ 可省略（直接使用 parameter=value）。
   • -d, -n, -f 需 Postfix 2.9+。
   • -o 和 -x 需 Postfix 2.10+。

2. 权限要求：

   • 修改 main.cf 或 master.cf 需 root 权限。

3. 配置备份：

   • 使用 -e, -#, -X 修改配置前建议备份原文件。

4. 参数拼写检查：

   • 默认运行 postconf 会检查参数拼写错误（Postfix 2.9+）。

5. 变量扩展：

   • 使用 -x 可展开 $name 变量（如 $myhostname 替换为实际值）。

6. 服务重启：

   • 修改配置后需执行 postfix reload 使生效。

示例：常用操作

1. 查看当前 relayhost 配置

postconf relayhost
# 输出示例：relayhost = [smtp.example.com]:587

2. 设置 SASL 认证参数

postconf -e "smtp_sasl_password_maps = hash:/etc/postfix/sasl_passwd"

3. 显示所有默认参数

postconf -d

4. 列出支持的 SASL 插件

postconf -a
# 输出示例：cyrus dovecot

5. 查看 master.cf 中的 smtp 服务

postconf -M smtp

6. 显示 DSN 模板内容

postconf -t

相关文件

• /etc/postfix/main.cf: 主配置文件。
• /etc/postfix/master.cf: 服务配置文件。
• /etc/postfix/sasl_passwd: SASL 认证密码文件（示例）。

术语解释

• main.cf: Postfix 的核心配置文件，定义全局参数（如邮件服务器地址、队列设置）。
• master.cf: 服务定义文件，指定 Postfix 服务（如 SMTP、LMTP）的启动方式和参数。
• DSN（Delivery Status Notification）: 邮件投递状态通知，用于报告成功或失败信息。
• SASL（Simple Authentication and Security Layer）: 用于 SMTP 认证的协议框架。