eRisemail Server v1.5安装使用手册

关于 e-risemail server

• 完全自主开发，非第三方系统集成，所以安装配置过程简单，但功能强大
• 无需另外安装其他模块即可拥有邮件服务系统的全部功能
• 支持GB2312, UTF-8和UCS2编码格式
• 安装后就同时支持SMTP(SSL/TLS), POP3(SSL/TLS), IMAP4(SSL/TLS), WebMail(HTTP/HTTPS)
• 支持邮件组，支持自定义用户策略，支持外发邮件审核，支持Web后台管理系统,
• 运行的平台Linux和MySQL均为免费平台(支持32位和64位平台)
• 支持当前流行的邮件客户端程序(Outlook, Thunderbird ...)
• 支持iCalendar格式(RFC2445) / Mozilla Thunderbird Lightning 插件
• 支持多种安全加密认证机制
• 支持大附件邮件( 最大支持2G大小的邮件 )
• 支持邮件快速索引，摘要和缓存，访问大小邮件无明显区别
• 支持动态扩充加载反垃圾邮件引擎，支持反垃圾引擎的二次开发
• 数据存储基于MySQL，很容易通过编写脚本程序维护备份系统数据
• 部署中小规模邮件系统的最好选择
• 推荐安装环境为Ubutun 8.04 + MySQL 5.0
• 官方发布网址 www.erisesoft.com
• 如有任何疑问请发信垂询erisesoft@gmail.com

全新安装

步骤 1:

• 准备MySQL Server和客户端运行库.
• 建议根据您的需求修改max_connections 的值（ /etc/mysql/my.cnf ）(一般值应该大于 MaxConnPerProtocal * 8 + NumOfForwardTask)
• 安装系统程序，系统提供两种安装方式 。一种是通过安装脚本安装，另外一种是通过deb安装包安装
  • 安装脚本：运行安装脚本复制文件到本地计算机: sudo ./install.sh
  • deb安装包: sudo dpkg -i erisemail-bin-cn-gb2312-i686.deb or erisemail-bin-en-gb2312-i686.deb

步骤 2:

• 复制erise-root.crt erise-server.crt erise-server.key 到安全的位置(例如 /usr/share/ca-certificates/erisemail) ，并把文件权限改为400。
• 本程序提供的证书文件为演示版，如果有自己的证书文件，请使用自己的。

步骤 3:

• 修改配置文件 /etc/erisemail/erisemail.conf（请参考下面erisemail.conf内容介绍）

步骤 4:

• 运行sudo eriseutil --install 安装存储邮件的数据库。
• 安装数据库后管理员账号降会被默认添加. 默认账号是admin, 默认密码为admin. 请立即通过erisepasswd命令修改管理员密码。

步骤 5:

• 运行sudo /etc/init.d/erisemail start
• 为了以后卸载程序方便，请备份uninstall.sh

从v1.3版本升级

• 先备份数据库
• 运行sudo eriseutil --upgrade
• 执行全新安装步骤（忽略步骤4）

从v1.4版本升级

• 执行全新安装步骤（忽略步骤4）

卸载

• 如果您希望连数据库一起卸载请运行 ./eriseutil --uninstall.（注意:以前的信件将全部丢失）
• 删除程序，同样系统提供两种卸载程序方式：
  • 卸载脚本: sudo ./uninstall.sh 删除程序文件
  • deb: sudo dpkg -r erisemail
    • 注意: 卸载过程中出现以下告警信息是正常的.请不要试图删除 "/usr/share/erisemail/private/"，本目录存储了邮件数据.
      • dpkg - warning: while removing erisemail, directory `/usr/share/erisemail/private/eml' not empty so not removed.
        dpkg - warning: while removing erisemail, directory `/usr/share/erisemail/private' not empty so not removed.
        dpkg - warning: while removing erisemail, directory `/usr/share/erisemail' not empty so not removed.

Introducation of erisemail.conf

Encoding	系统存储采取的编码格式(只支持UTF-8 , GB2312和UCS2)，默认为GB2312。 安装eRisemail的数据库后(执行sudo eriseutil --install后)请勿修改本值 如要更改，请在安装数据库之前，通过工具转换所有HTML页面到对应的编码格式，并修改HTML页面charset <meta http-equiv="Content-Type" content="text/html; charset=[GB2312|UTF-8|UCS2]" />
EmailDomainName	邮件后缀
LocalHostName	运行邮件服务器程序本地机器名
HostIP	运行邮件服务器的本地IP
DNSServer	可用的DNS服务器IP，不能为空
MaxConnPerProtocal	每个协议最多同时连接数
NumOfForwardTask	转发任务数。如果您的邮件服务器每天有许多的邮件需要转发到其他的邮件服务器上，您可以根据您的机器的性能增大这个值。默认值是3.
SMTPPort	SMTP服务的端口号
EnableSMTPTLS	启用 SMTP-TLS(yes/no). 因为各邮件系统TLS版本兼容性问题，推荐设置为no.
EnableRelay	启用转发功能. 防止作为垃圾邮件转发中继，推荐设为 no
SMTPHostNameCheck	SMTP 会话反查机器名和IP是否匹配
POP3Enable	启用 POP3服务.(yes/no)
POP3Port	POP3 服务端口号
EnablePOP3TLS	启用POP3-TLS服务(yes/no)
IMAPEnable	启用 IMAP服务.(yes/no)
IMAPPort	IMAP服务端口号
EnableIMAPTLS	启用 IMAP-TLS服务(yes/no)
SMTPSEnable	启用 SMTPS服务.(yes/no)
SMTPSPort	POP3服务端口号
POP3SEnable	启用 POP3S服务.(yes/no)
POP3SPort	POP3S service端口号
IMAPSEnable	启用 IMAPS服务.(yes/no)
IMAPSPort	IMAPS service端口号
HTTPEnable	启用 HTTP Web 服务.(yes/no)
HTTPPort	HTTP Web Service端口号
HTTPSEnable	启用 HTTPS Web 服务.(yes/no)
HTTPSPort	HTTP Web Service端口号
PrivatePath	私有临时文件所处目录，确保本目录下有eml和tmp两个子目录
HTMLPath	web系统的文件所处目录
CARootCrt	根证书位置
CAServerCrt	服务端证书位置
CAServerKey	服务端证书密钥文件位置
CAPassword	加密后的服务端证书口令(为了安全请用以下命令加密"eriseutil --encode [password]")
DBHost	MySQL Server机器名或者IP
DBName	将要为邮件系统创建的新数据库名字
DBUser	MySQL Server用户名
DBPassword	MySQL Server用户名的密码(为了安全请用以下命令加密"eriseutil --encode [password]")

Introducation of erisemail's tools

eriseadduser	添加一个用户到邮件系统 Usage:eriseadduser username password alias
erisedeluser	从邮件系统删除一个用户 Usage:erisedeluser username
eriseaddgroup	添加一个用户组到邮件系统 Usage:eriseaddgroup groupname password alias Usage:eriseaddgroup groupname alias
erisedelgroup	从邮件系统删除一个邮件组 Usage:erisedeluser groupname
eriseaddusertogroup	将已存在的用户添加到的某个邮件组 Usage:eriseaddusertogroup username groupname
erisedeluserfromgroup	从某邮件组中移除一个邮件用户 Usage:erisedeluserfromgroup username groupname
erisepasswd	更改邮件组或者用户密码 Usage:erisepasswd username | groupname
eriseenableuser	激活用户 Usage:eriseenableuser username
erisedisableuser	禁用用户 Usage:erisedisableuser username
eriseutil	邮件系统管理工具程序 Usage:eriseutil --install Usage:eriseutil --uninstall Usage:eriseutil -a user_group_name password alias [-u|-g] [-A|-U] Usage:eriseutil -a user_group_name alias [-u|-g] [-A|-U] Usage:eriseutil -d user_group_name Usage:eriseutil -p username Usage:eriseutil -A username groupname Usage:eriseutil -D username groupname Usage:eriseutil -l --level Usage:eriseutil -s --level username level_id Usage:eriseutil -s --defaultlevel level_id Usage:eriseutil -a --level level_name level_description level_mailmaxsize level_boxmaxsize level_audit(yes/no) level_mailsizethreshold level_attachsizethreshold Usage:eriseutil -l --user Usage:eriseutil -l --group groupname Usage:eriseutil --disable user_group_name Usage:eriseutil --enable user_group_name Usage:eriseutil --encode Usage:eriseutil --upgrade

web访问模式

• 从v1.3版本开始，系统嵌入了一个web服务器，支持HTTP和HTTPS协议，所以无需安装其他web服务程序即可支持WebMail和WebMan系统
• Web管理界面的Url: http://ip:port/admin

MTA访问记录 /var/log/erisemail/MTA-*.log

• MTA访问记录，用户可以参考此日志信息找出垃圾邮件源IP或者恶意访问IP

邮件允许域列表 /etc/erisemail/domain.list

• 本地域列表
• 支持多域（共享账号模式，非独立账号模式）

白名单 /etc/erisemail/permit.list

• 允许访问的的IP表

黑名单 /etc/erisemail/reject.list

• 拒绝访问的IP表

Web管理允许IP列表 /etc/erisemail/webadmin.list

• 允许访问web后台的的IP列表
• 空为不限制