# DocSys **Repository Path**: codePlain/DocSys ## Basic Information - **Project Name**: DocSys - **Description**: MxsDoc是基于Web的文件管理系统，支持权限管理、历史版本管理、Office预览/编辑、WPS预览/编辑、在线解压缩、文件分享、文件加密、远程存储、远程文件推送、秒传、断点续传、智能搜索、文件备注、回收站、自动备份、一键迁移、集群部署。 主要应用场景：文件管理系统、协同办公系统、电子书、知识管理系统、软件接口管理系统、自动备份软件、网页版SVN仓库、网页版GIT仓库。GPL 2.0开源协议. - **Primary Language**: Java - **License**: GPL-2.0 - **Default Branch**: master - **Homepage**: http://dw.gofreeteam.com - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 1293 - **Created**: 2024-01-27 - **Last Updated**: 2024-01-27 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # MxsDoc [中文 ](README.md) | [English](README_EN.md) ### 系统简介 MxsDoc是基于Web的文件管理系统，支持权限管理、历史版本管理、Office预览/编辑、WPS预览/编辑、在线解压缩、文件分享、文件加密、远程存储、远程文件推送、秒传、断点续传、智能搜索、文件备注、本地自动备份、异地自动备份、回收站、一键迁移、集群部署。 主要应用场景：文件管理系统、文档安全管理系统、分布式文档管理系统、协同办公系统、电子书、软件接口管理系统、自动备份软件、网页版SVN仓库、网页版GIT仓库、FTP客户端、SFTP客户端、SMB客户端、Linux系统远程文件访问。 ### [一键安装](https://gitee.com/RainyGao/DocSys/blob/master/README.md#%E4%B8%80%E7%B3%BB%E7%BB%9F%E5%AE%89%E8%A3%85) [一键安装，立即使用] ### [立即体验](http://dw.gofreeteam.com) [账号/密码: guest/guest] ### 全平台支持:Linux，Windows，Mac. ![输入图片说明](https://images.gitee.com/uploads/images/2020/0614/223719_03bd18e1_1558129.png "docsys_首页1.png") ### 开源协议: 采用GPL 2.0协议; ![输入图片说明](https://images.gitee.com/uploads/images/2020/0613/105551_20a8ac4f_1558129.png "docsys_首页2.png") ### 多仓库支持 支持定义各自的文件存储、版本管理、权限管理、全文搜索和文件加密规则 ![输入图片说明](https://images.gitee.com/uploads/images/2020/0613/105615_5aa90a26_1558129.png "docsys_仓库列表1.png") ### 存储更安全 本地化文件存储方案，避免系统意外损坏对仓库文件造成影响 ![输入图片说明](https://images.gitee.com/uploads/images/2020/0613/105650_d4a010aa_1558129.png "docsys_仓库主页1.png") ### 历史版本 采用目前最流行的SVN和GIT版本仓库，支持增量历史版本管理，支持脱离MxsDoc系统进行访问 ![输入图片说明](https://images.gitee.com/uploads/images/2020/0613/105708_0888bd30_1558129.png "docsys_仓库主页3.png") ### 在线编辑 支持各种文本文件在线编辑，支持Office/WPS文件协同编辑，无任何外部依赖（无需安装和部署其他Office编辑软件或系统） ![输入图片说明](https://images.gitee.com/uploads/images/2020/0613/105732_88ed0a73_1558129.png "docsys_仓库主页2.png") ### 文件分享 支持文件和目录分享，支持访问权限设置和密码访问控制 ![输入图片说明](https://images.gitee.com/uploads/images/2020/0613/105757_67ca6763_1558129.png "docsys_仓库主页4.png") ### 全文搜索 支持文件名、文件备注、文件内容搜索，让文件查找更加快捷方便 ![输入图片说明](https://images.gitee.com/uploads/images/2020/0613/105917_2ee5c143_1558129.png "docsys_仓库列表2.png") ### 后台管理 支持用户管理、用户组管理、仓库管理、系统管理 ![输入图片说明](https://images.gitee.com/uploads/images/2020/0613/105813_e858feb3_1558129.png "docsys_管理后台1.png") ### 集群部署 支持热插拔式集群，服务器可随时加入或退出集群，支持参数一致性检测，无需人工检查 ![输入图片说明](WebRoot/web/images/cluster.png.png) # 系统安装与升级 ### 一、系统安装 #### 1、一键安装包下载 国内下载地址：[微云](https://share.weiyun.com/0Kjpf2o0) 国外下载地址：[GitHub](https://github.com/RainyGao-GitHub/DocSys/releases) #### 2、安装 （1）解压系统安装包至本地目录 （2）运行start脚本启动系统 **注意：** 本地目录不得包含空格和中文 #### 3、访问 本机访问：http://localhost:8100/DocSystem 远程访问：将localhost改为IP地址即可 ### 二、系统升级 #### 1、下载升级包【DocSystem.war】 国内下载地址：[微云](https://share.weiyun.com/0Kjpf2o0) 国外下载地址：[GitHub](https://github.com/RainyGao-GitHub/DocSys/releases) #### 2、升级 管理后台 --> 系统管理 --> 系统设置 --> 系统升级 ### 三、系统手动升级 #### 1、下载系统安装包 Linux系统下载【docsys-linux-x.xx.xx.tar.gz】 Windows系统下载【docsys-win-x.xx.xx.zip】 国内下载地址：[微云](https://share.weiyun.com/0Kjpf2o0) 国外下载地址：[GitHub](https://github.com/RainyGao-GitHub/DocSys/releases) #### 2、升级 （1）解压系统安装包至本地目录 （2）更新应用 替换 [docsys/tomcat/webapps/DocSystem] 目录 （3）更新系统控制脚本 替换 [docsys] 目录下所有脚本文件 [.bat/.sh/.vbs] #### 3、适用场景 低于V2.02.45的版本和特殊版本 | 版本 | 说明 | | ------------- | ------------- | | V2.02.51 | 图片缩略图预览支持 | # 限制与价格 ### 限制 | 功能限制 | 个人版 | 专业版 | 企业版 | 开发者版 | | ------------- | ------------- | ------------- | ------------- | ------------- | | 价格 | [免费](http://dw.gofreeteam.com/DocSystem/web/sales/select.html) | [购买](http://dw.gofreeteam.com/DocSystem/web/sales/select.html) | [购买](http://dw.gofreeteam.com/DocSystem/web/sales/select.html) | 面议 | | 文件管理功能 | + | + | + | + | | 权限管理功能 | + | + | + | + | | 用户管理功能 | + | + | + | + | | 历史版本功能 | + | + | + | + | | 文件备注功能 | + | + | + | + | | 全文搜索功能 | + | + | + | + | | 文件分享功能 | + | + | + | + | | 在线解压功能 | + | + | + | + | | 文本文件预览 | + | + | + | + | | 文本文件编辑 | + | + | + | + | | 跨仓库推送功能 | + | + | + | + | | 跨服务器推送功能 | + | + | + | + | | Office文件预览 | + | + | + | + | | Office文件编辑 | + | + | + | + | | WPS文件预览 | + | + | + | + | | WPS文件编辑 | + | + | + | + | | 日志管理功能 | + | + | + | + | | 远程存储功能 | - | - | + | + | | 本地自动备份 | - | - | + | + | | 异地自动备份 | - | - | + | + | | 文件加密功能 | - | - | + | + | | LDAP单点登录 | - | - | + | + | | 版本回退功能 | - | - | - | + | | 备份恢复功能 | - | - | - | + | | 回收站功能 | - | - | - | + | | 第三方接入 | - | - | - | + | | 集群部署 | - | - | - | + | | 用户限制 | 10人 | 购买 | 购买 | 面议 | | 软件升级 | 不限 | 不限 | 不限 | 不限 | ### 商业版价格 #### 专业版价格 |有效期/用户数量 | 50人 | 100人 | 200人 | 500人 | 1000人 | 不限 | | ------------- | --------------- | ------------- | ------------- | ------------- | ------------- | ------------- | | 长期 | 5500元 | 7500元 | 9500元 | 12500元 | 18500元 | 26500元 | #### 企业版价格 |有效期/用户数量 | 50人 | 100人 | 200人 | 500人 | 1000人 | 不限 | | ------------- | --------------- | ------------- | ------------- | ------------- | ------------- | ------------- | | 长期 | 9500元 | 12500元 | 18500元 | 26500元 | 35000元 | 50000元 | #### 开发者版价格 |有效期/用户数量 | 50人 | 100人 | 200人 | 500人 | 1000人 | 不限 | | ------------- | --------------- | ------------- | ------------- | ------------- | ------------- | ------------- | | 长期 | 面议 | 面议 | 面议 | 面议 | 面议 | 面议 | # 技术咨询与购买 ## 购买与咨询 请加群 : 953982034 # 常见问题 ### 一、开发文档与使用文档 https://gitee.com/RainyGao/DocSys-Docs ### 二、证书安装 #### 1、证书下载 [下载授权证书](http://dw.gofreeteam.com/DocSystem/web/sales/select.html) #### 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次的永久不允许进群： ![输入图片说明](WebRoot/web/images/starexample.png)