ExtMail 引數配置指導
阿新 • • 發佈：2018-12-29
本文件所有內容基於ExtMail 1.1.0 和ExtMan 1.0.0版本。
一、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_IP_SECURITY_ON | 首頁登陸時ip安全,設定為1時不開啟，便於管理員設定全域性，而不需要改模板 |
| 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、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 |
注：Extmail密碼格式介紹：
1、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 => clear2、格式說明
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的配置 |
二、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不需認證碼 |
| 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 – 如果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 | 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 | 圖形日誌中，是否顯示佇列資訊 |
| SYS_CMDSERVER_SOCK | cmdserver服務的sock路徑 |
| SYS_CMDSERVER_MAXCONN | cmdserver服務最大連線 |
| SYS_CMDSERVER_PID | cmdserver服務的PID檔案路徑 |
| SYS_CMDSERVER_LOG | cmdserver服務的日誌檔案路徑 |
| SYS_CMDSERVER_AUTHCODE | cmdserver服務驗證碼 |
| SYS_IGNORE_SERVER_LIST | 忽略伺服器列表 |
參考文件：