填写服务器 config.xml 文件

• 填写服务器 config.xml 文件
• 主配置字段说明
• userPassword（用户密码）
• serverPort（主机端口）
• pushInterval（推送间隔）
• userSSL（语盒客户端是否使用SSL来连接服务器）
• convertoSimpleChar（简体转换繁体）
• disableLog（禁止输出log日志）
• disableReport（禁止发送统计数据）
• Email账户配置说明
• account（帐户名称）
• protocol（邮局连接协议）
• sendName（发送者名字）
• host（邮局取信主机地址）
• port（邮局取信主机端口）
• password（帐户密码）
• cryptPassword（加密后的密码）
• useFullNameSignIn（是否使用全地址登录）
• protocol_send（发送邮件协议）
• host_send（发送邮件连接的邮局主机）
• port_send（发送邮件连接的邮局主机端口）
• appendHTML（是否将HTML邮件转化成纯文本，附加在正文后面）
• pushHistoryMsg （是否推送历史消息）
• 推送多个邮箱
• 各个邮箱的配置模版
• gmail.com
• 163 网易
• vip.163
• 126
• QQ
• vip QQ
• yahoo.com
• yahoo.com.cn
• yahoo.cn
• hotmail.com
• live.com
• sina.com
• 139.com
• tom.com
• 21cn.com
• Google App 企业邮箱
• QQ企业邮箱
• 163 网易企业邮箱
• 163 网易免费企业邮
• 配置Weibo模块
• 配置IM模块

服务器配置需要一个简单的说明，用于填写语盒中间服务器访问的邮箱服务器地址、用户、密码等等。这个说明存放在config.xml 文件里面。注意如下事项：

1. 请用 notepad++ UltraEdit 等兼容UTF-8格式的文本编辑器编辑、保存Config.xml文件，不然程序会解析出错
2. 这个配置文件是利用xml配置的，xml是一种标记语言，语法很简单，不会的自己可以google一下，例如这样。
3. 所有的 “是否” 选项都是填写1为“是”，0或者其他值为否。
4. 密码字段包涵 & < > " ' 分别替换成 &amp; &lt; &gt; &quot; &apos; 。因为xml的字符串字段解析的时候无法处理上述字符，详情见XML转义字符。
5. 以下是初始配置，如果之后有删减，增加，可能没有及时更新，请以下载之后的服务器包中的config.xml文件为准。

主配置字段说明

<Yuchberry	
        userPassword="111111"	
        serverPort="9716"
	pushInterval="10"
	userSSL="0"
	convertoSimpleChar="0">

userPassword（用户密码）

用户密码。这个密码不是邮箱密码，建议不要和邮箱密码一样，用于认证推送客户端。这个密码也必须和SSL生成证书的密码一样，yuchberry SSL配置请看这里。例如 userPassword=111111

serverPort（主机端口）

yuchberry server 监听端口,负责与手机端通讯，推送服务器。在客户端的设置需要用到他。例如 serverPort=9716

pushInterval（推送间隔）

语盒中间服务器到邮件服务器上取信间隔，单位为秒，间隔越小，服务器占用资源越多。但是Push 到客户端的延迟也就越小。最小值为1。 例如 pushInterval=10。对于有些邮箱来说，有一定的安全性，所以过短的间隔会导致邮箱锁定，IMAP/POP3方式无法访问，需要去手动解锁

userSSL（语盒客户端是否使用SSL来连接服务器）

是否使用自己生成的SSL证书进行推送。这个选项如果为1，则表示需要，为0或者其他值，表示不许要。SSL具体配置（生成证书，配置客户端等）看这里。例如 userSSL=0

convertoSimpleChar（简体转换繁体）

是否将服务器所有的字符串转换成简体。由于黑莓上的字体无法混用，所以使用简体中文的朋友显示不了繁体中文，索性，用服务器将其转换成简体，发送到手机上。

disableLog（禁止输出log日志）

用于表示是否禁用log日志的输出，默认是关闭的（就是可以输出日志的）。

disableReport（禁止发送统计数据）

语盒由于需要更好的开发产品，用户在使用的过程中，可能需要中间服务器发送统计数据给语盒官方服务器，如果将其写为 1 就是禁止发送这个统计数据。 默认是发送的。这个统计信息绝对不会涉及用户隐私（包括密码，信件、微博、聊天内容等等），只有数量和容量。请你相信语盒开发者们，能够开发出更好的推送软件。

Email账户配置说明

    <EmailAccount
		account="yuchberry@gmail.com"
		password=""
		
		useFullNameSignIn="0"
		
		protocol="imaps"
		host="imap.gmail.com"
		port="993"
		
		protocol_send="smtp"
		host_send="smtp.gmail.com"
		port_send="587"
		
		appendHTML="0"
	/>

account（帐户名称）

完整账户名称，也就是需要推送的邮箱地址，例如yuchberry@gmail.com。不能填写yuchberry，如果填写错误，比如yuchberry@gmal.com，是可以收到信件，但是发送不出去。

protocol（邮局连接协议）

用于接收邮件的协议，有如下选择 pop3 pop3s imap imaps ，带s的是用于 SSL 安全链接，例如 protocol=imaps 需要邮件服务器的支持，Gmail 配置如下图，其他邮箱不一而同。

sendName（发送者名字）

如果你不想自己发送的时候别人收到的是赤裸裸的邮件地址的话，可以将其填上你希望别人看到的名字。例如 "语盒"

host（邮局取信主机地址）

邮件服务主机地址。例如 host=imap.gmail.com

port（邮局取信主机端口）

邮件服务端口号。例如 port=993

password（帐户密码）

邮箱密码，当然这个谁都不应该忘记。 例如 password=123456

cryptPassword（加密后的密码）

password 填写的密码明文，无法保证在服务器被黑之后的密码安全，于是就增加一个加密过后的密码字段，详细的配置在这里。

useFullNameSignIn（是否使用全地址登录）

是否利用全地址登录邮箱。有些邮箱需要用全地址xxxx@host.com 而不是xxxx作为用户名称。例如hotmail，谷歌企业邮箱、foxmail（因为使用的是pop.qq.com）、vip.qq.com等等，就貌似需要全地址登录。

protocol_send（发送邮件协议）

发送邮件使用的协议，几乎都是smtp。例如 protocol_send=smtp

host_send（发送邮件连接的邮局主机）

发送邮件的主机地址。例如 host_send=smtp.gmail.com

port_send（发送邮件连接的邮局主机端口）

发送邮件的主机端口。例如 port_send=587

以上属性配置具体参考邮件系统的帮助。比如gmail的就在这里，具体的IMAP配置在这里，POP3在这里。

appendHTML（是否将HTML邮件转化成纯文本，附加在正文后面）

是否将HTML 转化成纯文本，并且跟随在正文的后面。这个选项有点古怪，但是如果你邮箱订阅的有谷歌咨询，而且用手机的自带HTML查看器打不开手机浏览器的话，就会需要这个功能了。

pushHistoryMsg （是否推送历史消息）

每当字段对于POP3协议来说，最好不要选择，因为无法标记POP3的信件为已读信件，所以会在每次重启服务器的时候把很多收过的信件推送过来。IMAP可以选择这个为 1 ，默认值为 0。

推送多个邮箱

如果想推送多个邮箱，就填写多个

     <EmailAccount /> 

tag，这样就可以顺序推送了，第一个邮箱是发邮件的默认邮箱。回复邮件使用的是发送者发送的邮箱地址，而转发和新邮件发送，都是默认使用第一个邮箱发送。如果想推送两个邮箱，那么config.xml就会看起来像下面：

<Yuchberry	userPassword="520530"	serverPort="9716"	pushInterval="10"	userSSL="1"	convertoSimpleChar="1"	>
	<EmailAccount
		account="yuchting@gmail.com"
		password=""
		
		useFullNameSignIn="0"
		
		protocol="imaps"
		host="imap.gmail.com"
		port="993"
		
		protocol_send="smtp"
		host_send="smtp.gmail.com"
		port_send="587"
		
		appendHTML="1"
	/>
	<EmailAccount
		account="yuchberry@gmail.com"
		password=""
		
		useFullNameSignIn="0"
		
		protocol="imaps"
		host="imap.gmail.com"
		port="993"
		
		protocol_send="smtp"
		host_send="smtp.gmail.com"
		port_send="587"
		
		appendHTML="0"
	/>
</Yuchberry>

各个邮箱的配置模版

gmail.com

	<EmailAccount
		account="yuchberry@gmail.com"
		password=""
		
		useFullNameSignIn="0"
		
		protocol="imaps"
		host="imap.gmail.com"
		port="993"
		
		protocol_send="smtp"
		host_send="smtp.gmail.com"
		port_send="587"
		
		appendHTML="0"
	/>

163 网易

	<EmailAccount
		account="yuchberry@163.com"
		password=""
		
		useFullNameSignIn="0"
		
		protocol="imap"
		host="imap.163.com"
		port="143"
		
		protocol_send="smtp"
		host_send="smtp.163.com"
		port_send="25"
		
		appendHTML="0"
	/>

vip.163

	<EmailAccount
		account="yuchberry@vip.163.com"
		password=""
		
		useFullNameSignIn="0"
		
		protocol="imap"
		host="imap.vip.163.com"
		port="143"
		
		protocol_send="smtp"
		host_send="smtp.vip.163.com"
		port_send="25"
		
		appendHTML="0"
	/>

126

	<EmailAccount
		account="yuchberry@126.com"
		password=""
		
		useFullNameSignIn="0"
		
		protocol="imap"
		host="imap.126.com"
		port="143"
		
		protocol_send="smtp"
		host_send="smtp.126.com"
		port_send="25"
		
		appendHTML="0"
	/>

QQ

QQ 邮箱存在着很多不稳定因素，如果失败，需要等等再同步。
请使用浏览器访问QQ邮箱，确保其pop3/imap选项已经打开 查看帮助

	<EmailAccount
		account="yuchberry@qq.com"
		password=""
		
		useFullNameSignIn="0"
		
		protocol="imap"
		host="imap.qq.com"
		port="143"
		
		protocol_send="smtp"
		host_send="smtp.qq.com"
		port_send="25"
		
		appendHTML="0"
	/>

vip QQ

QQ 邮箱存在着很多不稳定因素，有的时候同步不上，需要等等再同步。注意：useFullNameSignIn="1"
请使用浏览器访问QQ邮箱，确保其pop3/imap选项已经打开 查看帮助

	<EmailAccount
		account="yuchberry@vip.qq.com"
		password=""
		
		useFullNameSignIn="1"
		
		protocol="imap"
		host="imap.qq.com"
		port="143"
		
		protocol_send="smtp"
		host_send="smtp.qq.com"
		port_send="25"
		
		appendHTML="0"
	/>

yahoo.com

	<EmailAccount
		account="yuchberry@yahoo.com"
		password=""
		
		useFullNameSignIn="0"
		
		protocol="imaps"
		host="apple.imap.mail.yahoo.com"
		port="993"
		
		protocol_send="smtp"
		host_send="apple.smtp.mail.yahoo.com"
		port_send="587"
		
		appendHTML="0"
	/>

yahoo.com.cn

465 端口可能会连接失败。
雅虎邮箱免费版貌似不支持pop的链接，请确认可以在web界面配置pop选项 查看帮助

	<EmailAccount
		account="yuchberry@yahoo.com.cn"
		password=""
		
		useFullNameSignIn="0"
		
		protocol="pop3"
		host="pop.mail.yahoo.com.cn"
		port="110"
		
		protocol_send="smtp"
		host_send="smtp.mail.yahoo.com.cn"
		port_send="25"
		
		appendHTML="0"
	/>

yahoo.cn

465 端口可能会连接失败。
雅虎邮箱免费版貌似不支持pop的链接，请确认可以在web界面配置pop选项 查看帮助

	<EmailAccount
		account="yuchberry@yahoo.cn"
		password=""
		
		useFullNameSignIn="1"
		
		protocol="pop3"
		host="pop.mail.yahoo.cn"
		port="110"
		
		protocol_send="smtp"
		host_send="smtp.mail.yahoo.cn"
		port_send="25"
		
		appendHTML="0"
	/>

hotmail.com

hotmail 只能支持pop3，他的典型轮询间隔是15分钟，基本无法推送，不建议使用

	<EmailAccount
		account="yuchberry@hotmail.com"
		password=""
		
		useFullNameSignIn="1"
		
		protocol="pop3s"
		host="pop3.live.com"
		port="995"
		
		protocol_send="smtp"
		host_send="smtp.live.com"
		port_send="587"
		
		appendHTML="0"
	/>

live.com

hotmail / live.com 只能支持pop3，他的典型轮询间隔是15分钟，基本无法推送，不建议使用

	<EmailAccount
		account="yuchberry@live.com"
		password=""
		
		useFullNameSignIn="0"
		
		protocol="pop3s"
		host="pop3.live.com"
		port="995"
		
		protocol_send="smtp"
		host_send="smtp.live.com"
		port_send="587"
		
		appendHTML="0"
	/>

sina.com

	<EmailAccount
		account="yuchberry@sina.com"
		password=""
		
		useFullNameSignIn="0"
		
		protocol="pop3"
		host="pop3.sina.com"
		port="110"
		
		protocol_send="smtp"
		host_send="smtp.sina.com"
		port_send="25"
		
		appendHTML="0"
	/>

139.com

	<EmailAccount
		account="yuchberry@139.com"
		password=""
		
		useFullNameSignIn="0"
		
		protocol="imap"
		host="imap.139.com"
		port="143"
		
		protocol_send="smtp"
		host_send="smtp.139.com"
		port_send="25"
		
		appendHTML="0"
	/>

tom.com

	<EmailAccount
		account="yuchberry@tom.com"
		password=""
		
		useFullNameSignIn="0"
		
		protocol="pop3"
		host="pop.tom.com"
		port="110"
		
		protocol_send="smtp"
		host_send="smtp.tom.com"
		port_send="25"
		
		appendHTML="0"
	/>

21cn.com

	<EmailAccount
		account="yuchberry@21cn.com"
		password=""
		
		useFullNameSignIn="0"
		
		protocol="pop3"
		host="pop.21cn.com"
		port="110"
		
		protocol_send="smtp"
		host_send="smtp.21cn.com"
		port_send="25"
		
		appendHTML="0"
	/>

Google App 企业邮箱

	<EmailAccount
		account="yuchberry@yuchs.com"
		password=""
		
		useFullNameSignIn="1"
		
		protocol="imaps"
		host="imap.gmail.com"
		port="993"
		
		protocol_send="smtp"
		host_send="smtp.gmail.com"
		port_send="587"
		
		appendHTML="0"
	/>

QQ企业邮箱

	<EmailAccount
		account="yuchberry@yuchs.com"
		password=""
		
		useFullNameSignIn="1"
		
		protocol="imap"
		host="imap.exmail.qq.com"
		port="143"
		
		protocol_send="smtp"
		host_send="smtp.exmail.qq.com"
		port_send="25"
		
		appendHTML="0"
	/>

163 网易企业邮箱

	<EmailAccount
		account="yuchberry@yuchs.com"
		password=""
		
		useFullNameSignIn="1"
		
		protocol="imap"
		host="imap.qiye.163.com"
		port="143"
		
		protocol_send="smtp"
		host_send="smtp.qiye.163.com"
		port_send="25"
		
		appendHTML="0"
	/>

163 网易免费企业邮

	<EmailAccount
		account="yuchberry@yuchs.com"
		password=""
		
		useFullNameSignIn="1"
		
		protocol="imap"
		host="imap.ym.163.com"
		port="143"
		
		protocol_send="smtp"
		host_send="smtp.ym.163.com"
		port_send="25"
		
		appendHTML="0"
	/>

配置Weibo模块

请查看这个文档，获得详细配置步骤。

配置IM模块

请查看这个文档，获得详细配置步骤。