MxsDoc

中文 | English

系统简介

MxsDoc是基于Web的文件管理系统，支持权限管理、历史版本管理、Office预览/编辑、WPS预览/编辑、在线解压缩、文件分享、文件加密、远程存储、远程文件推送、秒传、断点续传、智能搜索、文件备注、本地自动备份、异地自动备份、回收站、一键迁移、集群部署。

主要应用场景：文件管理系统、文档安全管理系统、分布式文档管理系统、协同办公系统、电子书、软件接口管理系统、自动备份软件、网页版SVN仓库、网页版GIT仓库、FTP客户端、SFTP客户端、SMB客户端、Linux系统远程文件访问。

一键安装 [一键安装，立即使用]

立即体验 [账号/密码: guest/guest]

全平台支持:Linux，Windows，Mac.

开源协议: 采用GPL 2.0协议;

多仓库支持

支持定义各自的文件存储、版本管理、权限管理、全文搜索和文件加密规则

存储更安全

本地化文件存储方案，避免系统意外损坏对仓库文件造成影响

历史版本

采用目前最流行的SVN和GIT版本仓库，支持增量历史版本管理，支持脱离MxsDoc系统进行访问

在线编辑

支持各种文本文件在线编辑，支持Office/WPS文件协同编辑，无任何外部依赖（无需安装和部署其他Office编辑软件或系统）

文件分享

支持文件和目录分享，支持访问权限设置和密码访问控制

全文搜索

支持文件名、文件备注、文件内容搜索，让文件查找更加快捷方便

后台管理

支持用户管理、用户组管理、仓库管理、系统管理

集群部署

支持热插拔式集群，服务器可随时加入或退出集群，支持参数一致性检测，无需人工检查

系统安装与升级

一、系统安装

1、一键安装包下载

国内下载地址：微云

国外下载地址：GitHub

2、安装

（1）解压系统安装包至本地目录

（2）运行start脚本启动系统

注意： 本地目录不得包含空格和中文

3、访问

本机访问：http://localhost:8100/DocSystem

远程访问：将localhost改为IP地址即可

二、系统升级

1、下载升级包【DocSystem.war】

国内下载地址：微云

国外下载地址：GitHub

2、升级

管理后台 --> 系统管理 --> 系统设置 --> 系统升级

三、系统手动升级

1、下载系统安装包

Linux系统下载【docsys-linux-x.xx.xx.tar.gz】

Windows系统下载【docsys-win-x.xx.xx.zip】

国内下载地址：微云

国外下载地址：GitHub

2、升级

（1）解压系统安装包至本地目录

（2）更新应用

 替换 [docsys/tomcat/webapps/DocSystem] 目录

（3）更新系统控制脚本

 替换 [docsys] 目录下所有脚本文件 [.bat/.sh/.vbs]

3、适用场景

低于V2.02.45的版本和特殊版本

限制与价格

限制

商业版价格

专业版价格

企业版价格

开发者版价格

技术咨询与购买

购买与咨询 请加群 : 953982034

常见问题

一、开发文档与使用文档

https://gitee.com/RainyGao/DocSys-Docs

二、证书安装

1、证书下载

下载授权证书

2、证书安装

管理后台 -> 系统设置 -> 证书安装

三、Office编辑常见问题

1、Linux系统Office无法预览和编辑

1.1、手动安装动态库

复制 DocSystem\web\static\office-editor\libs\Linux 目录下的所有动态库到 /usr/lib64 目录

1.2、手动修改以下目录的执行权限

chmod 777 -R "$CATALINA_HOME/webapps/DocSystem/web/static/office-editor/server/FileConverter/bin/"
chmod 777 -R "$CATALINA_HOME/webapps/DocSystem/web/static/office-editor/server/tools/"
chmod 777 -R "$CATALINA_HOME/webapps/DocSystem/web/static/office-editor/bin/"

1.3、手动修改以下目录的写入权限（可选）

chmod 755 -R "/data/"

1.4、重启MxsDoc

2、Linux系统Excel在线编辑退出后修改内容丢失

2.1、安装字体库

yum -y install fontconfig

2.2、添加中文字体

将 C:/Windows/Fonts 字体文件复制到 /usr/share/fonts 目录

2.3、生成 fonts.scale 文件

yum -y install ttmkfdir

2.4、刷新字体缓存

fc-cache

2.5、重新生成office字体库

运行 DocSystem\web\static\office-editor\bin\documentserver-generate-allfonts.sh

2.6、重启MxsDoc

3、Linux系统 Office 编辑握手延时过大，导致文件打开失败

与DNS解析的配置有关,解决方法如下：

（1）通过 hostnamectl 获取机器名

（2）在 /etc/hosts 文件中添加对应IP的反解析 添加以下内容： 内网IP 机器名全称 机器名（去掉.后缀） 实例： 192.168.0.11 AP-SHA-VM-P85.internal.sungard.corp AP-SHA-VM-P85

4、Windows系统Office无法预览和编辑

4.1、检查系统缺少的动态库并修复

双击运行 DocSystem\web\static\office-editor\bin\documentserver-generate-allfonts.bat ，根据报错提示确定需要修复的动态库

4.2、重启MxsDoc

四、数据库常见问题

1、 使用自定义mysql数据库无法登录

1.1、手动创建数据库

1.2、触发数据库初始化

删除docSys.ini/version文件，重启MxsDoc

2、 mysql无法向文件写入数据

通常发生在linux系统，Linux系统的一些特殊目录（例如：根目录和root目录）通常不允许写入文件

建议更换mxsdoc在Linux系统的安装目录

3、 mysql不支持带空格的路径

通常发生在windows系统，建议将mxsdoc安装在不带空格的目录下

4、mysql启动时缺少libiao库

通常发生在linux系统，有些Linux系统没有默认安装libiao库，手动安装即可

5、mysql Crash导致无法再次启动

删除tc.log文件，重新启动mysql即可

五、什么是分布式远程存储

1、仓库文件可以存储在远程文件服务器（FTP/SFTP/SMB/SVN/GIT/MXSDOC）

2、在当前仓库可查看远程文件服务器文件

3、可将当前仓库文件推送到远程服务器

4、可将远程服务器文件拉取到当前仓库

5、仓库可以独立于远程文件服务器进行文件操作和版本管理

六、什么是文件服务器前置

1. 设置为文件服务器前置的仓库，可以作为的文件服务器的客户端使用，

2. 在该仓库页面上，能够查看和操作文件服务器（FTP/SFTP/SMB/SVN/GIT/MXSDOC）上的文件和目录

七、如何使用MxsDoc作为自动备份工具

1. 新建仓库

2. 设置文件存储路径，自定义为需要备份的目录

3. 设置自动备份

（1）本地自动备份需要指定本地备份目录

（2）异地自动备份需要指定备份的文件服务器（目前支持FTP/SFTP/SMB/SVN/GIT/MXSDOC）

（3）根据自己需求勾选备份时间

八、其他常见问题

1、Linux系统中文乱码

1.1、查看当前使用的系统语言

echo $LANG

1.2、查看是否已安装有中文语言包

locale

如有 zh cn 表示已经安装了中文语言

1.3、安装中文语言包

yum groupinstall chinese-support

1.4、修改系统默认语言

vi /etc/sysconfig/i18n

修改为 LANG="zh_CN.UTF-8" 并重启系统

2、Windows的共享文件夹无法远程访问

1. 打开控制面板-->程序和功能-->启用或关闭windows功能-->勾选SMB 1.0/CIFS文件共享支持

2. 重启系统

3、数据库文件导入后仓库找不到

原来的数据库字段和新的格式不一致，重置数据库后再导入即可

4、数据库文件导入后仓库的全文搜索设置异常

数据库直接导入不会触发仓库的数据初始化，导致仓库的全文搜索配置为空引起异常，重启系统即可

5、LDAP设置说明

5.1 LDAP设置格式如下

ldap://【域控服务器地址】:【端口】/【基础DN】;【鉴权方式】;【鉴权账号】;【鉴权密码】;【登录账号属性】;【登录校验方式】

5.2 参数说明

【域控服务器地址】

域控服务地址，可以是域名或IP地址

【域控服务器端口】

端口默认为389

【基础DN】

域控服务器的basedn，例如：ou=test,dc=gofreeteam,dc=com，请根据自己公司的basedn进行设置

【鉴权方式】

域控服务器登录验证方式，例如：authentication=simple，支持以下鉴权方式：

simple\none\DIGEST-MD5\EXTERNAL\CRAM-MD5\GSSAPI

【鉴权账号】

设置了该参数表示使用指定账号进行域控服务器登录验证，例如：userAccount=admin，否则使用登录账号进行域控服务器账号验证

【鉴权密码】

仅在设置了鉴权账号的情况下生效，例如：userPassword=admin123

【登录账号属性】

默认用户登录账号的属性为 uid，设置了该参数，表明使用指定属性查询登录账号的信息，例如：loginMode=cn

【登录校验方式】

如果设置了鉴权账号，该参数无效

authMode=0：使用【loginMode=userName,basedn】进行鉴权，不需要密码，例如：【uid=guest,ou=test,dc=gofreeteam,dc=com】

authMode=1：使用【loginMode=userName,basedn】进行鉴权，需要密码

authMode=2：使用登录用户名、密码进行鉴权

authMode=3：使用登录用户名鉴权，在鉴权通过后，读取LDAP信息后再进行密码校验

6、FTP服务器连接成功，但无法获取文件列表

FTP服务器为被动模式情况下，需要在MxsDoc的FTP配置中增加参数 isPassive=1

7、nginx反向代理设置

upstream mxsdoc {
    ip_hash:
    server 192.168.0.2:8100;
    server 192.168.0.3:8100;
}
server {
	listen 80;
	server_name dw.gofreeteam.com;
	rewrite ^/$ http://$host/DocSystem/  permanent;	
	location / {
            proxy_http_version 1.1;
            proxy_set_header Upgrade $http_upgrade;
            proxy_set_header Connection 'upgrade';
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For  $proxy_add_x_forwarded_for;
            proxy_cookie_path /DocSystem/ /;
            proxy_set_header Cookie $http_cookie;
            proxy_pass http://mxsdoc;
        }
}

8、nginx反向代理时，大文件上传时提示服务器异常

将nginx的client_max_body_size改为100M

九、调试日志获取

1、调试日志获取（系统可登录）

1. 进入系统设置页面（管理后台 -> 系统设置）

2. 调试日志等级设置为debug

3. 测试完成后，点击下载

2、调试日志获取（系统无法登录时）

1. 调试日志等级设置为debug

   将 docsys\tomcat\webapps\docSys.ini\debugLogLevel 文件里的内容改为 0

2. Windows系统：用startWithLog.bat启动，日志在docsys/logs目录

3. Linux系统： start.sh > docSys.log

联系方式

个人QQ: 652055239

个人Email: gaoyu@gofreeteam.com

官方QQ群号：953982034

重点说明： 申请进群时提供的是码云star显示的名字(列如下图)，管理员会挨个审核是否已star，如果没有star或者乱填的直接拒绝，出现拒绝2次的永久不允许进群：