Extmail/Extman配置文件参数说明

版权声明： 

本文版权归作者所有，如其他个人、第三方网站或媒体报刊等需转载全文或节选，为支持我们的工作，请务必注明如下信息：

 文档所有者：Extmail Dev Team;
 文章原始出处： http://www.extmail.org/docs/Extmail_Parameter_Intro
 项目首页： http://www.extmail.org
如果因此而给您带来麻烦，请您原谅，谢谢合作。

本文档详细讲述Extmail的配置参数，给用户提供Extmail配置参数的使用参考。

本文档假设读者具有一定的Unix平台 / Linux平台系统经验，懂得vi编辑器的基本使用，并且懂得基本Extmail系统的安装（具体Extmail系统安装问题请参考相关Extmail HOWTO）。

本文档所有内容基于ExtMail 1.0.4 和ExtMan 0.2.4版本，并由Extmail项目组根据Extmail项目的建设和发展，适时予以更新。如手册与实际项目情况有冲突，以文档服从实际为原则。

一、webmail.cf

介绍：

webmail.cf文件用来对webmail的核心配置进行设定，该配置文件对Extmail至关重要。

存放路径：

/var/www/extsuite/extmail/webmail.cf

注：如果没有按照官方HowTO安装系统，路径可能会有所不同，请根据您系统的实际情况而定。

参数说明：

SYS_CONFIG =

# 程序根目录路径，此路径必须指向extmail目录；

SYS_LANGDIR =

# 语言包目录路径，此路径必须指向extmail/lang目录；

SYS_TEMPLDIR =

# 系统模板目录路径，此路径必须指向extmail/html目录；

SYS_SHOW_WARN =

# 设置为1时,打印隐含的系统警告信息到标准输出(网页)，默认为0；

SYS_PERMIT_NOQUOTA =

# 设置为0时，系统将不限制邮箱容量,默认设置为1；

SYS_SESS_DIR =

# 系统当前会话文件的保存目录,默认为/tmp/；

SYS_LOG_ON =

# 设置为1时系统将记录web登陆的日志，设置为0时不记录(日志记录在何处

# 由SYS_LOG_TYPE参数控制)；

SYS_LOG_TYPE =

#  系统log的记录方式；分以下3种情况：

#  file：自定义文件(具体文件，由SYS_LOG_FILE参数控制)；

#  syslog：系统syslogd指定的mail.*文件；

#  nosyslog：系统syslogd指定的非本机的log文件；

SYS_LOG_FILE =

# 若sys_log_type 参数设置为files，此项指定files文件路径；

SYS_SESS_TIMEOUT =

# 系统超时设置，默认为3小时；

# 格式number+(s|m|h|d|M|y); 或者单纯数字，0代表系统超时为0秒

# 但是如果参数sys_sess_cookie_only设置为1则代表会话将在关闭浏览器后过期；

SYS_SESS_COOKIE_ONLY

# 该参数是指SID获取的来源。如果设置为1，则只根据cookie里的SID来获得，如果设置

# 为0，则同时从cookie及URL里取,如果没cookie则从URL里取。一般对于不支持cookie

# 的浏览器，得设置为0;

SYS_USER_PSIZE =

#  webmail列表时，每页显示邮件数。默认10；

SYS_USER_SCREEN =

# 屏幕显示分辨率设置，默认auto；

# auto    => full text

# screen1 => 800x600

# screen2 => 1024x768

# screen3 => 1280x1024

SYS_USER_LANG =

# 用户默认语言，中文可以设置为zh_CN；

SYS_APP_TYPE =

# 当前配置文件对应的应用程序类型。必须填写Webmail；

SYS_USER_TEMPLATE =

# 指定界面风格模板文件，默认为default；

SYS_USER_CHARSET =

# 指定用户默认字符集，中文可以设置为gb2312；

SYS_USER_TRYLOCAL =

# 系统默认编码为utf8，外发邮件时，该参数控制是否尝试将邮件内容转成其他内码

# 可以转成对应的本地编码，例如gbk、big5、shift-jis等，1转、0是不转；

# 注意：如果设置了0但用户在偏好设置需要转换，系统还是会转换内码；

SYS_USER_TIMEZONE =

# 指定用户默认时区，默认为东八区：+0800；

SYS_USER_CCSENT = 1

SYS_USER_SHOW_HTML = 1

SYS_USER_COMPOSE_HTML = 1

SYS_USER_CONV_LINK =1

SYS_USER_ADDR2ABOOK = 1

# 系统默认用户参数；

SYS_MESSAGE_SIZE_LIMIT =

# 该参数控制写邮件时，单封信件的最大尺寸。以byte为单位，比如: 5242880 代表5MB；

SYS_MIN_PASS_LEN =

# 指定邮件账户最短密码长度，默认2；

SYS_MFILTER_ON =

# 过滤器开关；1为开，0为关；

SYS_NETDISK_ON =

# 网络磁盘开关；1为开，0为关；若设置了0，则即使在extman内打开用户网络磁盘功能

# 用户都不能使用该功能；

SYS_SHOW_SIGNUP =

# 首页“注册免费邮箱”的按钮显示开关；1为显示，0为关闭；

SYS_AUTH_TYPE =

# 系统认证方式, 可选：mysql/ldap/authlib；

SYS_MAILDIR_BASE =

# 邮件数据存放目录路径，必须使用绝对路径，比如：/home/domains；

SYS_AUTH_SCHEMA = virtual

# 该设置有3个参数：vpopmail1/vpopmail2/virtual；

# virtual即虚拟帐户；

# vpopmail1 => all user accounts in one table 为对qmail+vpopmail（mysql版）的支持；

# vpopmail2 => accounts in per domain table 为对qmail+vpopmail（mysql版）的支持；

SYS_CRYPT_TYPE =

# 密码加密方式，支持以下方式：

# crypt|cleartext|plain|md5|md5crypt|plain-md5|ldap-md5|sha|sha1；

SYS_MYSQL_USER =

# MYSQL数据库用户信息设置，默认为：extmail；

SYS_MYSQL_PASS =

# MYSQL数据库用户密码设置；

SYS_MYSQL_DB =

# MYSQL数据库名设置；

SYS_MYSQL_HOST =

# MYSQL数据库主机，默认为：localhost；

SYS_MYSQL_SOCKET =

# MYSQL数据库SOCKET位置设置，默认为：/var/lib/mysql/mysql.sock；

SYS_MYSQL_TABLE = mailbox

SYS_MYSQL_ATTR_USERNAME = username

SYS_MYSQL_ATTR_DOMAIN = domain

SYS_MYSQL_ATTR_PASSWD = password

SYS_MYSQL_ATTR_QUOTA = quota

SYS_MYSQL_ATTR_NDQUOTA = netdiskquota

SYS_MYSQL_ATTR_HOME = homedir

SYS_MYSQL_ATTR_MAILDIR = maildir

# Extmail使用的MYSQL表设置，请不要修改默认配置；

SYS_MYSQL_ATTR_CLEARPW = clearpwd

# 为了方便管理员对账户的管理，该设置用来保存明文密码；

# 如果不需要该功能请注释掉此设置；

SYS_MYSQL_ATTR_DISABLEWEBMAIL = disablewebmail

SYS_MYSQL_ATTR_DISABLENETDISK = disablenetdisk

SYS_MYSQL_ATTR_DISABLEPWDCHANGE = disablepwdchange

SYS_MYSQL_ATTR_ACTIVE = active

# attr_disable**主要是设置是否打开禁用某个特性的功能。如果注释掉

# 那么即使数据库存在这个字段也会无效。比如disablewebmail，即支持用户登录webmail。

# 注：修改过该设置后，用户必须logout才能生效；

SYS_LDAP_BASE = o=extmailAccount,dc=example.com

SYS_LDAP_RDN = cn=Manager,dc=example.com

SYS_LDAP_PASS = secret

SYS_LDAP_HOST = localhost

# LDAP配置信息；

SYS_LDAP_ATTR_USERNAME = mail

SYS_LDAP_ATTR_DOMAIN = virtualDomain

SYS_LDAP_ATTR_PASSWD = userPassword

# ldif配置属性；

SYS_LDAP_ATTR_CLEARPW = clearPassword

SYS_LDAP_ATTR_QUOTA = mailQuota

SYS_LDAP_ATTR_NDQUOTA = netdiskQuota

SYS_LDAP_ATTR_HOME = homeDirectory

SYS_LDAP_ATTR_MAILDIR = mailMessageStore

SYS_LDAP_ATTR_DISABLEWEBMAIL = disablewebmail

SYS_LDAP_ATTR_DISABLENETDISK = disablenetdisk

SYS_LDAP_ATTR_DISABLEPWDCHANGE = disablePasswdChange

SYS_LDAP_ATTR_ACTIVE = active

# 参见SYS_MYSQL_ATTR*相关解释；

SYS_AUTHLIB_SOCKET = /var/spool/authdaemon/socket

# authlib socket存放位置；

SYS_G_ABOOK_TYPE =

# 全局地址本设置，可选ldap和file；

SYS_G_ABOOK_LDAP_HOST = localhost

SYS_G_ABOOK_LDAP_BASE = ou=AddressBook,dc=example.com

SYS_G_ABOOK_LDAP_ROOTDN = cn=Manager,dc=example.com

SYS_G_ABOOK_LDAP_ROOTPW = secret

SYS_G_ABOOK_LDAP_FILTER = objectClass=OfficePerson

#当SYS_G_ABOOK_FILE设置为ldap，对应LDAP的配置；

SYS_G_ABOOK_FILE_PATH = /var/www/html/extmail/globabook.cf

SYS_G_ABOOK_FILE_LOCK = 1

SYS_G_ABOOK_FILE_CONVERT = 0

SYS_G_ABOOK_FILE_CHARSET = utf-8

# 当SYS_G_ABOOK_FILE设置为file，对应file的配置；

二、webman.cf

介绍：

webman.cf文件用来对Extman的核心配置进行设定，该配置文件对Extman至关重要。

存放路径：

/var/www/extsuite/extman/webman.cf

注：如果没有按照官方HowTO安装系统，路径可能会有所不同，请根据您系统的实际情况而定。

 参数说明：

SYS_CONFIG =

# 程序根目录路径，此路径必须指向extman目录；

SYS_LANGDIR =

# 语言包目录路径，此路径必须指向extman/lang目录；

SYS_TEMPLDIR =

# 系统模板目录路径，此路径必须指向extman/html；

SYS_MAILDIR_BASE =

# 邮件数据存放路径，必须为绝对路径，比如：/home/domains；

SYS_SHOW_WARN =

# 设置为1时,打印隐含的系统警告信息到标准输出(网页)，默认为0；

SYS_SESS_DIR =

# 系统当前会话文件的保存目录,默认为/tmp/extman/；

SYS_CAPTCHA_ON =

# 设置为1需要认证码登录extman，0不需认证码； //如果不能正确显示验证码，请将这个值设为0

SYS_CAPTCHA_KEY =

# 认证码的key随便输入一个字符串就行；

SYS_CAPTCHA_LEN =

# 认证码的长度，默认为5；

SYS_PURGE_DATA =

# 该设置控制删除用户时默认是否完全删除用户数据，0为否，1为是；

SYS_PSIZE =

#  用户或域列表时，每页显示数据数目。默认20；

SYS_APP_TYPE =

# 当前配置文件对应的应用程序类型。必须填写ExtMan；

SYS_TEMPLATE_NAME =

# 指定界面风格模板文件，默认为default；

SYS_DEFAULT_EXPIRE =

# 默认过期时间，格式：?y ?m ?d；

SYS_GROUPMAIL_SENDER =

# 使用群发邮件模块，系统默认的发件人，例： [email protected]；

SYS_DEFAULT_SERVICES =

# 设置系统开放的功能，包括： smtpd, smtp, webmail, netdisk, imap, pop3

# (多参数以 "," 为分割符)；

SYS_ISP_MODE =

# 是否采用ISP模式，格式：yes|no �C 如果yes，系统将采用 HashDir 模式来存放数据目录；

SYS_DOMAIN_HASHDIR =

# 如果SYS_ISP_MODE =yes，此设置用来控制域目录是否采用HashDir 模式，格式：yes|no；

SYS_DOMAIN_HASHDIR_DEPTH =

# 域目录HashDir的设置, 格式:长度x深度，如：2x1 => 长度 =2, 深度 =1

# 注：该参数生效必须：sys_isp_mode = yes；

SYS_USER_HASHDIR =

# 如果SYS_ISP_MODE =yes，此设置用来控制用户数据目录是否采用HashDir 模式

# 格式：yes|no；

SYS_USER_HASHDIR_DEPTH =

# 参见SYS_DOMAIN_HASHDIR_DEPTH；

SYS_DOMAIN_ROUTING_LIST =

# 简单的分布存储设置，该参数为Domain级的路由设置。格式：transport 手册里规定的

# 格式都合法。如：lmtp:mx1.extmail.org,lmtp:mx2.extmail.org。

# 注意：必须设置 ISP_mode=yes才能生效；

SYS_USER_ROUTING_LIST =

# 简单的分布存储设置，该参数为User级的路由设置。格式：transport 手册里规定的

# 格式都合法。如：smtp:[192.168.2.130],smtp:[192.168.2.128]。

# 注意：必须设置 ISP_mode=yes才能生效；

SYS_MIN_UID =

# 系统最小UID设置；

SYS_MIN_GID =

# 系统最小GID设置；

SYS_DEFAULT_UID =

# 系统默认UID设置，如果为空，webman则忽略次参数；

SYS_DEFAULT_GID =

# 系统默认GID设置，如果为空，webman则忽略次参数；

SYS_QUOTA_MULTIPLIER =

# 该设置用来设定1MB的实际字节数；

SYS_QUOTA_TYPE =

# 空间限制方法参数设置，可用参数：vda|courier；

SYS_DEFAULT_MAXQUOTA =

# 添加域时，默认最大限额大小，单位MB；

SYS_DEFAULT_MAXALIAS =

# 添加域时，默认最大别名数；

SYS_DEFAULT_MAXUSERS =

# 添加域时，默认最大用户数；

SYS_DEFAULT_MAXNDQUOTA =

# 添加域时，默认最大网络磁盘限额，单位MB；

SYS_USER_DEFAULT_QUOTA =

# 添加用户时，默认磁盘限额，单位MB；

SYS_USER_DEFAULT_NDQUOTA =

# 添加用户时，默认网络磁盘大小，单位MB；

SYS_USER_DEFAULT_EXPIRE =

# 添加用户时，默认过期时间, 格式：?y ?m ?d；

SYS_BACKEND_TYPE =

# 系统后台数据库设置，可用参数：mysql|ldap；

SYS_CRYPT_TYPE = crypt

# 密码加密方式，支持以下方式：

# crypt|cleartext|plain|md5|md5crypt|plain-md5|ldap-md5|sha|sha1；

# 详见：webmail.cf SYS_CRYPT_TYPE  参数之Extmail密码格式介绍；

SYS_MYSQL_USER =

# MYSQL数据库用户信息设置，默认为：webman;

SYS_MYSQL_PASS =

# MYSQL数据库用户密码设置；

SYS_MYSQL_DB =

# MYSQL数据库名设置；

SYS_MYSQL_HOST =

# MYSQL数据库主机，默认为：localhost；

SYS_MYSQL_SOCKET = /var/lib/mysql/mysql.sock

# MYSQL数据库SOCKET位置设置，默认为：/var/lib/mysql/mysql.sock；

SYS_MYSQL_TABLE = manager

SYS_MYSQL_ATTR_USERNAME = username

SYS_MYSQL_ATTR_PASSWD = password

# Extman使用的MYSQL表设置，请不要修改默认配置；

SYS_MYSQL_ATTR_CLEARPW = clearpwd

# 为了方便管理员对账户的管理，该设置用来保存明文密码；

# 如果不需要该功能请注释掉此设置；

SYS_LDAP_BASE = dc=extmail.org

SYS_LDAP_RDN = cn=Manager,dc=extmail.org

SYS_LDAP_PASS = secret

SYS_LDAP_HOST = localhost

SYS_LDAP_ATTR_USERNAME =

SYS_LDAP_ATTR_PASSWD =

# LDAP配置信息；

# SYS_LDAP_ATTR_CLEARPW = clearPassword

# 参见SYS_MYSQL_ATTR_CLEARPW相关解释；

SYS_RRD_DATADIR =

# rrd图形数据目录；

SYS_RRD_TMPDIR =

# rrd图形数据临时路径；

SYS_RRD_QUEUE_ON =

# 图形日志中，是否显示队列信息；