webmail.cf詳解

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_HTTP_CACHE =
# 系統HTTP緩存開關，1爲開，0爲關；
SYS_SMTP_HOST =
# 系統SMTP主機名
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_SPAM_REPORT_ON =
# 系統spam報告開關；1爲開，0爲關；
SYS_SPAM_REPORT_TYPE =
# 系統spam報告類型，默認爲dspam；
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、big五、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；

注：Extmail密碼格式介紹：

一、scheme(密碼模型)

Extmail支持明文,crypt，md5，md5crypt，sha/sha1等主流的9-10種密碼格式，採用以下的方法映射：
CRYPT     => crypt
MD5       => md5
PLAIN-MD5 => plain_md5
LDAP-MD5  => ldap_md5
SHA       => sha
SHA1      => sha
CLEARTEXT => clear
PLAIN     => clear

二、格式說明

Extmail能夠辨認如下3種密碼格式：

a、   $1$hhhhhh$xxxxxxxxxxx
該格式以md5()結果爲基礎，用一串hhhhhh（隨機數）的hash對md5進行加密獲得的密碼，
xxxxxxxxxxxxx  就是md5密文數據，它的特徵是以$1$爲前綴，符合此說明的格式就是md5crypt。
例：$1$187665$G.H.mgUc6NDNY
b、   {xxxx}yyyyyyyyyyyyyyy
該格式，{}裏面是明文指定了密碼模型，以後爲加密數據。
好比：{MD5}xxxxxxxxxxxx，表明以MD5爲加密方式，而xxxxxxxxxxxxx就是md5密文數據。
例：{CRYPT}ONHMD5XB/E8vk
c、   xxxxxxxxxxxxxxxxxxxxx
該格式是沒有任何特徵的密文，若是採用該格式，必須手工在webmail.cf和webman.cf的SYS_CRYPT_TYPE參數指定密碼格式。
例：WdJmMDGalzcJY
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設置爲file，對應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的配置

轉自：http://wiki.extmail.org/webmail.cf%E5%8F%82%E6%95%B0%E4%BB%8B%E7%BB%8D