支持本地私有化部署。支持虚拟机,支持云服务器!

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 安装

  1. 搜索 OceanBase 数据库相关镜像
docker search oceanbase
  1. 拉取 OceanBase 数据库最新镜像
docker pull oceanbase/oceanbase-ce
  1. 启动 OceanBase 数据库实例
docker run -p 2881:2881 --name obstandalone -e MINI_MODE=0 -d oceanbase/oceanbase-ce
  1. 检查 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
image

然后就可以去配置文件里更改端口号为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 即可访问系统
wecom-temp-5899-2c5de0035ac5c8789882d70a4478bf7f

停止系统:

1.需找到whatsaas_linux_arm64的运行进程ID 如下图所示
wecom-temp-108871-a94272219839a5bfda0eb63c9d566163

2.然后建立任务,关闭进程即可
wecom-temp-9581-757aac3fa5beaa3e84e26bec1a9d5d3a

问题 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预览是发现出现以下错误
image-1688874956948
修复方式
确定容器的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。
image-1688875222059

用命令进入 cd /etc/onlyoffice/documentserver/
然后用命令 ls 查看该文件夹下所有文件如图所示
image-1688875421139
你会发现default.json 和local.json 这两个文件,者两个文件都要修改,我们一个个修改,先修改local.json

在修改前我们先让docker 支持vi 命令
执行命令:apt-get update
然后再执行:apt-get install vim
之后就可以用vim命令编辑文件了
执行vim local.json
找到
image-1688876026920
键盘:i进入编辑模式
将index,outbox,browser 都设置为false
image-1688876114841
保存文件用命令: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
image

问题 21:为什么我修改了配置文件不生效?

答案:请重启服务

问题 23:为什么我云服务器防火墙已经开放了指定端口,还是无法访问?

第一 :请确认防火墙已经重启
第二 :请确认云服务的安全组已开放端口

问题 24:我上传的文件会保存在哪?

默认路径保存在如下图所示的upload 文件夹里
wecom-temp-12103-d0b20ed680a1f8d044bc0ad4c96918d4

问题 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