支持本地私有化部署。支持虚拟机,支持云服务器!
WhatsSaaS 系统如何搭建和运行
第一步:安装mysql
第二步:配置whatsaas的配置文件,去到项目文件夹, conf/app.conf 配置正确的serverurl 和数据库连接信心
如果你需要实时本地能打开word文件或cad文件,需要安装mqtt 服务
安装emqx教程如下:https://docs.emqx.com/en/emqx/v5.1/deploy/install-rhel.html
如果你需要实时在线协同编辑文档,需要装onlyoffice,
如果你暂时都不需要以上两个需求,则直接可以运行系统
第三步 启动系统
请先尝试 chmod -R 777 到这个项目文件夹
Linux下 需要cd到whatssaas文件夹下,如果你是临时启动测试一下,可以直接使用命令:
./whatssaas_linux_amd64_Vx.x
如果你想 永久启动可以使用命令:
nohup ./whatssaas_linux_amd64_Vx.x &
(ps:whatssaas_linux_amd64_Vx.x 请填写正确的名称)
第四步浏览器访问
http://你的IP地址:8848
特别提醒:如果别人电脑无法访问,请尝试关闭防火墙或开8848端口
问题 :Ubuntu 安装Mysql数据库
要在Ubuntu上安装MySQL并导入数据库,可以按照以下步骤进行操作:
安装MySQL:
打开终端,并输入以下命令以安装MySQL服务器:
sudo apt update
sudo apt install mysql-server
启动MySQL服务:
安装完成后,MySQL服务会自动启动。可以使用以下命令检查服务状态:
sudo systemctl status mysql
如果未运行,可以使用以下命令手动启动服务:
sudo systemctl start mysql
配置MySQL:
运行以下命令来进行MySQL安全性配置:
sudo mysql_secure_installation
按照提示进行配置,包括设置root密码和其他安全选项。
登录MySQL:
使用以下命令登录到MySQL shell:
sudo mysql -u root -p
输入之前设置的root密码。
创建数据库:
在MySQL shell中,可以使用以下命令创建一个新的数据库:
CREATE DATABASE whatssaas;
导入数据库:
将数据库文件(通常是以.sql为后缀)复制到服务器上,并使用以下命令导入数据库:
use whatssaas
source /实际路径/whatssaas.sql
以上就是在Ubuntu上安装MySQL并导入数据库的基本步骤。请根据实际情况调整命令和参数。
问题 0:系统默认端口号和账号密码是什么?
答案:
默认端口号为8848,系统运行之后,在浏览器访问
服务器的IP地址:8848 即可访问系统
账号:market@teamwork.market
密码:123456
问题 1:系统支持内网运行吗?
答案:WhatsSaaS 支持纯内网环境运营,无需连接任何外网,
问题 2:系统免费版最大支持多少人数?如果超过这个人数怎么激 活?
答案:系统免费版支持 2 人以下,如果超过 2 人之后系统会跳转 到激活界面,需要 license 激活之后才能使用,我们支持离线激活方式。
如果需要继续使用免费版,在激活界面上选择继续使用免费版,超出人数部分的人员会被自动删除
问题 3:系统已经启动了,但显示账号密码错误,怎么解决?
答案:
第一:请确认已经安装了 Mysql,请自行百度linux 下安装mysql8.0
第二:确保已经在 Mysql 数据库中创建了 whatssaas 数据库,并且 导入了 whatssaas.sql 数据
第三:请确保 系统文件夹中 conf/app.conf 的数据库配置项配置成 你的数据库连接信息,
下面为例子,具体根据你的数据库配置进行修改
#Mysql 配置#
host =127.0.0.1:3306
user =root
password =root
database =whatssaas
prefix =my_
charset =utf8
第四:配置完之后请重启 whatssaas 服务
至于如何启动服务 这里在再说明一下
请先尝试 chmod -R 777 到这个项目文件夹
Linux下 需要cd到whatssaas文件夹下,如果你是临时启动测试一下,可以直接使用命令: ./whatssaas_linux
如果你想 永久启动可以使用命令:nohup ./whatssaas_linux &
后面如果想重启服务,需要用ps -aux 找到whatssaas_linux的进程,并使用kill -9 进程id 进行删除
问题 3-1 国产OceanBase 4.0 社区版支持(可选数据库)
国产OceanBase 4.0 社区版 docker 安装
- 搜索 OceanBase 数据库相关镜像
docker search oceanbase
- 拉取 OceanBase 数据库最新镜像
docker pull oceanbase/oceanbase-ce
- 启动 OceanBase 数据库实例
docker run -p 2881:2881 --name obstandalone -e MINI_MODE=0 -d oceanbase/oceanbase-ce
- 检查 OceanBase 数据库实例
启动预计需要 2~5 分钟。执行以下命令,如果返回 boot success!,则表示启动成功
docker logs obstandalone | tail -1
默认用户名为root@sys,密码为空
也可以用Mysql 连接工具Navicat登陆
终端连接命令
obclient -uroot@sys -h127.1 -P2881
更新最大连接超时时间
set global ob_query_Timeout=36000000000
更新数据库连接密码
切换到mysql 数据库,使用命令 use mysql; 接着
set password for root = password(‘123’); 注意:123更新到你的密码;
**导入数据库注意事项 导入前需要将数据库文件的字体utf8_unicode_ci更换成utf8_general_ci
然后就可以去配置文件里更改端口号为2881 即可连接上 OceanBase
问题 3-1:群晖怎么启动系统和停止系统?
启动系统:
1.安装MariaDB 10套件并设置root用户密码;
2.安装phpMyAdmin套件并登录到MariaDB 10并建立数据库whatssaas;
3:导入数据库文件whatssaas.sql 到刚才建立的whatssaas数据库中
4:正确配置whatssaas的数据库连接参数
去到系统文件夹中 conf/app.conf 的数据库配置项配置成 你的数据库连接信息,
下面为例子,具体根据你的数据库配置进行修改
#Mysql 配置#
host =127.0.0.1:3306
user =root
password =root
database =whatssaas
prefix =my_
charset =utf8
4.计划任务添加计划任务,用户名选择root,在任务脚本位置输入对应运行路径,例如:cd /volume1/web/whatssaas && ./whatssaas_linux_amd64 &,其中/volume1/web/whatssaas为程序所在文件夹路径,该路径是你上传系统文件的所在位置,添加后运行任务
注意高端群晖机器 要用 whatssaas_linux_amd64
即可在浏览器输入地址访问。
服务器的IP地址:8848,例如192.168.0.110:8848 即可访问系统
停止系统:
1.需找到whatsaas_linux_arm64的运行进程ID 如下图所示
2.然后建立任务,关闭进程即可
问题 4:为什么我的图片无法显示,下载文件下载失败?
答案:请在系统文件夹中 conf/app.conf 的项中配置成服务器的局 域网 IP 地址,不能填写 127.0.0.1 或 localhost ###服务器地址 请正确修改为你的服务器地址 ,最好用内网 IP
serverurl = http://192.168.88.101:8848
问题 5:whatssaas 是已经内置了 OnlyOffice 了吗?
答案:没有内置 OnlyOffice,需要自己搭建 OnlyOffice 服务器。官 方配置指导地址 https://www.onlyoffice.com/download- docs.aspx?from=default#docs-community
若您实在搞定不了 OnlyOffice,我们提供已配置好的 OnlyOffice 服 务器,开箱即用,省心。淘宝地址如下 https://h5.m.taobao.com/awp/core/detail.htm?ft=t&id=696003596 092
问题 6:为什么我在线 编辑文件失败?
答案:
第一 :请确保已经安装了 onlyoffice,参考地址如下
1:首先,确保您的系统上已经安装了Docker。您可以通过运行以下命令来检查是否已经安装:
docker --version
如果返回了Docker的版本信息,表示已安装。
2:接下来,您需要拉取OnlyOffice的Docker镜像。运行以下命令来拉取OnlyOffice镜像:
docker pull onlyoffice/documentserver
3:容器创建和运行。要创建并运行OnlyOffice的Docker容器,可以使用以下命令:
docker run -i -t -d -p 9003:80 --restart=always onlyoffice/documentserver JWT_ENABLED=false
该命令将创建和启动OnlyOffice容器,并将其与主机的9003端口进行映射,以便可以通过浏览器访问OnlyOffice。
如果打开whatsaas预览是发现出现以下错误
修复方式
确定容器的ID。运行以下命令以查找OnlyOffice容器的ID:
docker container ls -a
找到 onlyoffice的 container id
此命令将显示正在运行的Docker容器的列表,包括OnlyOffice容器及其相关信息。请记下OnlyOffice容器的ID。
进入容器并查找local.json文件。使用以下命令进入OnlyOffice容器:
docker exec -it [container_id] bash
请将[container_id]替换为上一步中获得的OnlyOffice容器的ID。
用命令进入 cd /etc/onlyoffice/documentserver/
然后用命令 ls 查看该文件夹下所有文件如图所示
你会发现default.json 和local.json 这两个文件,者两个文件都要修改,我们一个个修改,先修改local.json
在修改前我们先让docker 支持vi 命令
执行命令:apt-get update
然后再执行:apt-get install vim
之后就可以用vim命令编辑文件了
执行vim local.json
找到
键盘:i进入编辑模式
将index,outbox,browser 都设置为false
保存文件用命令:wq!
同理 修改default.json文件
vim default.json
“allowPrivateIPAddress”: false,
修改为
“allowPrivateIPAddress”: true,
保存default.json 文件
:wq!
命令 exit 推出docker bash 面板
重启 onlyoffice 94db188a为 onlyoffice的container id
docker exec -it 94db188a16df /bin/bash -c “supervisorctl restart all”
千万别重启docker,因为重启docker 配置文件会被重置
第二:请在系统文件夹中 conf/app.conf 的项中正确配置 ###OnlyOffice 地址 请修改为你的 OnlyOffice 地址服务器地址
onlyofficeurl = http://192.168.88.101:9003 。
第三:测试地址能正常打开 http://192.168.88.101:9003/web-apps/apps/api/documents/api.js
注意:192.168.88.103 为例子,请修改为你的实际 ip 地址
问题 6-1:群晖 DSM7.2 系统 docker 安装 onlyoffice 保姆
群晖DSM7.2系统docker安装onlyoffice保姆级教程
问题 7:为什么局域网内其他人无法访问系统?
答案:
第一:请检查其他人电脑能不能 ping 通服务器电脑。
第二:请检查服务器防火墙是否已开启需要的端口号,例如 8848,80,9001,3306
问题 8:系统支持什么系统?
答案:Linux。 仅需要安装一个mysql,配置好网站配置文件即可启动,我们的系统也支持群晖的硬件
系统建议最低配置为四核八G内存
问题 9:?
答案:
问题 10:如果我要迁移服务器,怎么操作?
答案:请导出数据库,备份 whatssaas 整个项目文件夹即可,如果 迁移后服务器的 IP 地址发生变化,请到数据库文件,用文本编辑器批量 替换原 ip 地址到连接到新 ip 地址。
问题 11:如果我要升级版本,怎么操作?
答案:
0:停止服务
1:备份数据库
2:根据新版本数据库升级要求升级数据库
3:根据新版本的config文件与当前版本的config文件进行对比,修改对应增加部分
4:覆盖其他所有文件
5:重启服务
强烈建议本地需要搭建有测试环境,测试环境没有问题再更新到正式环境
问题 12:如何确保服务器安全并确保有很好的性能?
答案:可以修改mysql数据库默认端口,启用新的普通用户代替root直接连接数据库,mysql不开放远程连接,修改默认ssh端口和设置禁止root直接登录,根据你的服务器的硬件去配置优化mysql的连接参数,例如最大连接数等等参数,mysql的参数优化得好不好直接决定了一个系统的性能,下面的参数参考配置为8核 16G内存的服务器
Mysql my.ini 参数优化可以参考如下
max_connections=4000
thread_cache_size=500
innodb_buffer_pool_size=1000M
innodb_log_file_size=512M
innodb_log_buffer_size=32M
innodb_flush_log_at_trx_commit = 0
innodb_lock_wait_timeout = 50
key_buffer_size=400M
innodb_log_buffer_size=20M
query_cache_size=40M
read_buffer_size=4M
sort_buffer_size=4M
read_rnd_buffer_size=8M
tmp_table_size=16M
thread_cache_size=64
back_log=500
wait_timeout=60
问题 13:数据库和 onlyoffice 可以独立到另外到服务器吗?
答案:可以,只要系统间能联通就行。
问题 14:为什么某些文件有版本管理按钮,某些文件没有版本管 理?
答案:目前支持版本管理的文件为 word,excel,ppt 等普通等办公文 档,他们支持在线实时编辑,其他文件不支持线上版本管理,需要自己 线下命好好版本号上传进行版本管理。
问题 15:如何修改超管到账号?
答案:去到数据库管理,打开 tw_member 表,找到 market@teamwork.market,更改为贵司到邮箱地址。
问题 16:超管账号密码忘记了咋办?
答案:去到数据库管理,打开 tw_member 表,重置密码 e10adc3949ba59abbe56e057f20f883e 该密码明文为:123456 并重启 whatssaas 服务
问题 17:登录窗口 隐私协议处能否设置为自动勾选?
答案:不能,根据法律规定,不能设置为默认勾选,如果您未阅读 过 whatssaas 隐私协议相关规定,请务必仔细查阅一遍,确认勾选则默 认你同意该协议。
问题 18:系统支持什么浏览器?
答案:请用 Google Chrome 或 edge 等主流浏览器以获得最佳体 验。我们强烈建议用 Google Chrome
问题 19:系统有手机版和电脑桌面版吗?
答案:手机版(安卓)正在开发中,苹果和桌面应用暂无开发计划。
问题 20:为什么我的项目创建后日期变成01/01/0001?
答案:
如果你在linux下安装我们的软件,日期格式必须是CST Model,你可以使用这样的命令:
ln -s /usr/share/zoneinfo/Asia/Shanghai /etc/localtime
您可以将正确的时区更改为您的时区,然后您可以使用命令 date 检查日期是否更改为 cst
问题 21:为什么我修改了配置文件不生效?
答案:请重启服务
问题 23:为什么我云服务器防火墙已经开放了指定端口,还是无法访问?
第一 :请确认防火墙已经重启
第二 :请确认云服务的安全组已开放端口
问题 24:我上传的文件会保存在哪?
默认路径保存在如下图所示的upload 文件夹里
问题 25:Docker 安装mqtt?
首先保证先安装docker
sudo yum update
sudo yum install -y yum-utils device-mapper-persistent-data lvm2
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
sudo yum install -y docker-ce docker-ce-cli containerd.io
sudo systemctl start docker
docker version
docker run --name emq -p 18083:18083 -p 1883:1883 -p 8084:8084 -p 8883:8883 -p 8083:8083 -d registry.cn-hangzhou.aliyuncs.com/synbop/emqttd:2.3.6