Web Mail 客户端：EMail Client
简介
EMail Client 基于 POP3 和 SMTP 协议来实现邮件的收发功能，UI是基于在 er, esui, bat-ria 的基础上开发的，天生具有很好的扩展性和跨平台的特性。
如何使用
为了方便使用，提供了 Mac 下面的编译好的版本(6.8M)，可以从这里下载：http://pan.baidu.com/s/1gd1lVrl
下载解压之后，执行：./email 即可，如果正常启动成功，然后打开浏览器，访问：http://localhost:8877 就可以看到设置页面。
第一次访问的时候会自动跳转到设置页面，此时需要配置一些账户的信息，如果是 baidu.com 或者 126.com 的账户的话，只需要在基本设置里面填写邮箱地址和密码即可，下面的高级设置会自动补全。如果不是这两个域名下面的账户，可能就需要自己人肉去补全相应的信 息了。
配置成功之后，点击确定，然后会跳转到邮件列表页面，稍微等一会儿就可以看到最新的邮件了。
关联网盘
在邮件列表页面，点击『网盘授权』的按钮，会打开授权页面，授权成功之后会，后续收到的邮件中如果还有附件，会自动同步到百度网盘。
需要注意的是，授权的时候，需要保证浏览器的地址是 http://localhost:8877，如果是其它地址，可能会失败。
系统预览
邮件列表
邮件搜索
发送邮件
邮件浏览
查看附件
先进行网盘授权，授权之后邮件的附件是自动转存到百度云，方便预览。
系统架构图
BACKEND
- 基于 POP3 协议跟邮件服务器交互，完成收取邮件的功能
- 收取邮件之后把解析出来的元信息（例如：标题，发件人，日期等等）存储到数据，原始的文件存储到 Raw 目录。
FRONTEND
- 基于 SMTP 协议跟邮件服务器交互，完成发送邮件的功能
- 实现了一个 Web Server，响应浏览器发送过来的请求，返回合适的 JSON 数据，从而在 ER App 里面展示邮件的信息。
环境搭建
基于上面的介绍，搭建环境之前需要有一些依赖的服务需要准备好：
注意事项
Windows下面安装可能会遇到很多问题，推荐在 Linux 或者 Mac 下面尝试
git
检出代码：git clone http://gitlab.baidu.com/baidu/email.git
mysql
TODO 待完善
golang
TODO 待完善
- 下载依赖包：
git clone http://gitlab.baidu.com/liyubei/gopath.git - 设置
GOPATH环境变量：export GOPATH=$(pwd)/gopath - 编译一下
go install code.google.com/p/go.net/publicsuffix go install github.com/alexcesaro/mail/quotedprintable go install github.com/dustin/go-humanize go install github.com/gorilla/schema go install github.com/microcosm-cc/bluemonday go install github.com/op/go-logging go install github.com/qiniu/iconv go install github.com/saintfish/chardet go install github.com/stretchr/testify/assert go install github.com/go-sql-driver/mysql go install github.com/mattn/go-sqlite3 go install github.com/bytbox/go-pop3 go install gopkg.in/yaml.v1使用jumbo
TODO 待完善
如果在开发机使用 jumbo 安装的话，可以执行如下的命令来部署环境：
jumbo add-repo ftp://st01-arch-platform00.st01.baidu.com/home/bambi/repo/tmp jumbo install sun-java6 go mysql nodejs export PATH=${JUMBO_ROOT}/opt/sun-java6/bin:$PATH npm i -g edp edp-webserver --registry=http://npm.baidu.com启动服务
TODO 待完善
过滤器
TODO 待完善
邮件的过滤器主要是通过filters.yml来配置完成的，可以把filters.example.yml拷贝为filters.yml，进行一些调整来符合自己的需求。调整的时候参考现有的内容即可。常见的一个过滤器结构如下：
- filter: name: 邮件列表/w3.org stop: true condition: match: Any rules: - [SentTo, Contains, '@w3.org'] - [SentTo, Contains, '@lists.css-discuss.org'] action: Label: 邮件列表/w3.orgfilter.stop类型是bool，如果设置为true，当符合这个过滤器的时候，就不再执行后续的过滤器filter.condition.match取值范围是Any或者All，注意大小写。- 现在可用的
action有Label,MarkAsRead,MarkAsDelete，后续如果想完善的话，可以直接在src/server/base/action.go里面去实现。
FAQ
为什么不独立一个服务来访问，而是需要使用者自己来安装？
的确是的，独立服务访问会方便很多，但是因为收取和发送邮件都需要用户名和密码，独立服务之后必定要存储这些信息，很有可能会出安全隐患，所以不提供一个独立的服务。
跟 email.baidu.com 有啥区别？
本质功能是一样的，虽然有些功能还没有 email.baidu.com 完善，有些功能比 email.baidu.com 更易用（例如发送和浏览邮件的功能），而且定制性和扩展性更好，希望更多的童鞋参与进来。
为什么有些邮件收取不了呢？
这是因为 POP3 协议的限制，没有文件夹的概念。 如果在服务器上保存了 Outlook 的过滤器，可能会把一些邮件放到 非Inbox 文件夹下面，此时用 POP3 就无法收取了，建议停用所有的过滤器（非删除），这样子就能收取所有的有邮件了。