服务器部署

服务器分为然之协同办公和xxd(go server)两部分,都需要部署。

部署然之协同服务器端

  1. 下载安装然之协同办公系统最新版:http://www.ranzhi.org/download.html
  2. 下载喧喧1.3.0的 然之扩展包 ,解压后将其代码覆盖到然之根目录,在然之数据库中执行 db/upgradexuanxuan1.3.sql;
  3. 以管理员身份登录然之,进入后台 -> 系统 -> 喧喧 ,设置一个长度为32的密钥,在 xxd 的配置文件中设置相同的密钥;
  4. 服务器的登录地址为 xxd 的访问地址,登录帐号和密码为然之协同办公系统内对应用户的帐号和密码;
  5. 调试时设置 ranzhi/config/my.php 中 debug=true,在 ranzhi/tmp/log/xuanxuan.log.php 中查看日志。
  6. 使用windows一键安装包部署时关闭 Apache 用户访问验证功能。

部署xxd(go server)

1.下载对应的xxd服务器版本,并解压缩:

操作系统 64位 32位
Windows 7+ {filename.xxd_win64}
{filename.xxd_win32}
Mac OS10+ {filename.xxd_mac}
Linux {filename.xxd_linux64}
{filename.xxd_linux32}
2.修改目录中的config文件:


[server]
# 监听的服务器ip地址 
# 此ip地址应该和喧喧客户端登录时输入的ip地址或者域名所对应的ip地址一致
ip=127.0.0.1

# 与聊天客户端通讯的端口
chatPort=11444

# 通用端口,该端口用于客户端登录时验证,以及文件上传下载使用
commonPort=11443

# 是否启用https , 设置为 0 则使用http协议, 1为https协议
isHttps=1

# 上传文件的保存路径,最后的“/”不能省略,表示路径
uploadPath=tmpfile/

# 上传文件的大小,支持:K,M,G
uploadFileSize=32M

[ranzhi]
# xuanxuan是自定义然之服务器名称,客户端登录时需要
# token从然之服务器中获取,长度为32个字符
# 设置某个服务器为default后,客户端省略服务器名称时默认使用default
# 地址格式为ranzhiName=http[s]://ip[:port]/xuanxuan.php,token[,default],[]中的内容为选填项,然之访问端口为80时可以省略端口号
# 例如:
# demo=http://demo.ranzhi.org/xuanxuan.php,88888888888888888888888888888888
# localhost=http://127.0.0.1:81/ranzhi/xuanxuan.php,88888888888888888888888888888888
xuanxuan=http://127.0.0.1/ranzhi/xuanxuan.php,88888888888888888888888888888888,default

# NOTE: Windows accept / as path separator.
[log]
# 程序运行日志的保存路径
logPath=log/

[certificate]
# 证书的保存路径,默认情况下xxd会生成自签名证书
crtPath=certificate/
配置文件完成后就可以启动服务器


3.启动服务器

Linux平台
执行命令 ./xxd,启动服务器 ,若启动失败,请查看log目录下面的日志文件,按照提示解决问题。

需要开机启动和后台执行,请把启动命令加入到  /etc/rc.d/rc.local  文件的最后。

# rc.local
/xxdPath/xxd &


Windows平台
在命令终端中执行 ./xxd.exe 启动服务器,若启动失败,请查看log目录下面的日志文件,按照提示解决问题。
需要开机启动和后台执行的,请把启动命令加入到计划任务中。

xxd性能简单测试

性能测试结果请看:xxd性能简单测试

证书配置

运行xxd后会在xxd当前目录生成certificate文件夹,服务会自动生成两个证书main.key和main.crt这两个证书为自己生成,浏览器可能会拦截

将购买的受信任的证书直接替换即可,注意证书的格式和名称