安装 Yeastar 智慧办公

本文描述了在私有部署过程中，如何连接服务器主机，并使用 Linux 命令将 Yeastar 智慧办公安装到你的专有服务器上。

前提条件

已获取 Yeastar 智慧办公安装包的下载链接。

步骤一、连接服务器主机

连接服务器主机。
本文以终端模拟器 Xshell 为例进行操作。
1. 运行 Xshell，在左上角点击文件并选择新建。
2. 在弹窗中，完成常规栏中的设置：
  - 名称：指定一个名称以帮助你识别此连接。
  - 协议：保持默认值 SSH。
  - 主机：输入服务器主机的 IP 地址。
  - 端口：保持默认值 22。
3. 在右侧类别栏中，点击 用户身份验证，并输入用户名和密码。
4. 在弹窗底部，点击连接。
连接成功后，运行以下命令并输入当前账号的密码开启 root 权限。
```
sudo -i
```
可选操作：安装 lrzsz。
在安装过程中会使用 lrzsz（rz 命令）上传文件，如系统中未安装此程序，则运行以下命令，安装 lrzsz：
```
apt install lrzsz
```
故障排查：显示无法安装此程序？

运行命令 apt-get update 更新程序源，然后再次尝试安装。

步骤二、下载 Yeastar 智慧办公安装包

Linux 系统支持多种下载文件的方式，本文以 wget 命令为例。

运行以下命令，在服务器根目录下下载 Yeastar 智慧办公安装包。

wget -P /root https://xxx.bin

重要提示

替换命令中的 https: //xxx.bin 为Yeastar 智慧办公安装包下载链接后再执行命令，否则将无法执行下载。
下载过程可能会持续数十分钟，在下载完成之前请不要断开与服务器主机的连接。

步骤三、解密安装包

安装包下载完成后，运行以下命令：
```
openssl enc -aes256 -d -md sha256 -salt -in workplace-xx.x.x.x.bin -out workplace-xx.x.x.x.tar.gz 
```
重要提示
- xx.x.x.x 指代为安装包的版本号，请将命令中的两个 xx.x.x.x 都替换为你当前安装包的版本号再运行，否则会解密失败。
- 示例：安装包版本号为：workplace-71.5.0.19，则输入 “openssl enc -aes256 -d -md sha256 -salt -in workplace-71.5.0.19.bin -out workplace-71.5.0.19.tar.gz”。
在 enter aes-256-cbc decryption password: 栏输入解密密码 Yeastar12345@ ，按下 Enter 键。系统将自动开始解密文件。

重要提示

输入密码时不会有字符显示，但是系统会记录你输入的内容。如果出现解密失败的提示，可能是因为密码输入有误，此时可重新执行 1-2 的操作。
运行以下命令查看解密结果：
```
ls  
```
如果在列出的文件中看见 workplace-xx.x.x.x.tar.gz（x 指代为安装包的实际版本号）文件，则说明已解密成功，可以进行下一步操作。

步骤四、解压安装包

运行以下命令进行解压：

tar -xzvf workplace-xx.x.x.x.tar.gz

重要提示

替换命令中的 xx.x.x.x 为你当前安装包的版本号再运行，否则会解压失败。

步骤五、可选操作：导入 SSL 证书文件

对于需要使用对接或 第三方集成 功能的在线版本，则需要导入 SSL 证书文件。

运行以下命令，创建证书文件目录。
```
mkdir ./workplace-xx.x.x.x/cert
```
重要提示

替换命令中的 xx.x.x.x 为你当前安装包的版本号再运行，否则会创建失败。
运行以下命令，访问证书文件目录。
```
cd workplace-xx.x.x.x/cert 
```
重要提示

替换命令中的 xx.x.x.x 为你当前安装包的版本号再运行，否则将会访问失败。
运行以下命令，上传 smart.key 和 smart.cer 文件。
```
rz      
```

步骤六、导入并编辑 .env 文件

依次运行以下命令，访问 workplace 的目录。
```
cd ~
```
```
cd workplace-xx.x.x.x
```
重要提示

替换命令中的 xx.x.x.x 为你当前安装包的版本号再运行，否则将会访问失败。
运行以下命令，上传 secret.env 文件。
```
rz
```
运行以下命令，打开 .env 文件
```
vi .env 
```

按下 i 键，进入修改模式，并完成 Basic Settings 章节的配置：

配置项	默认值	说明
HOST_IP	127.0.0.1	替换默认值为部署主机的 IP 地址。
HOST_DOMAIN_NAME	workplace.com	替换默认值为用于访问服务的域名或 IP 地址。
TZ	UTC	替换默认值为服务器所在时区, 中国时区可填：Asia/Chongqing 或 Asia/Shanghai。
MYSQL_ROOT_PASSWORD	Do_not_use_default_password!	设置数据库root密码并替换默认值，该密码将作为设置MySQL容器的初始密码, 使用外部数据库时可以为空。
MYSQL_USER	user	数据库用户名, 用于访问`MYSQL_DATABASE`指定的数据库; 如果使用外部数据库服务, 请务必确认MYSQL_USER具备对`MYSQL_DATABASE`的`DML`和`DDL`操作权限(创建表及增删改查). 设置新用户名并替换默认值，或记录默认用户名。
MYSQL_PASSWORD	Do_not_use_default_password!	设置`MYSQL_USER`所指定的数据库用户密码并替换默认值。
REDIS_PASSWORD	Do_not_use_default_password!	设置 Redis 密码并提替换默认值。
S3_ACCESS_KEY_ID	admin	Minio 容器的初始 Admin 账号的用户名，如果使用外部 S3 服务（如AWS S3），则该用户名会作为有权限访问 S3 Bucket 的用户的 Access Key Id。设置新用户名并替换默认值，或记录默认用户名。
S3_SECRET_ACCESS_KEY	Do_not_use_default_password!	设置 Minio容器 Admin 账号的初始密码并替换默认值，如果使用外部 S3 服务（如AWS S3），则改密码会作为有权限访问 S3 Bucket 的用户的 Secret Access Key。
EMQX_DASHBOARD_USER	admin	EMQX Dashboard 的初始 Admin 账号的用户名。设置新用户名并替换默认值，或记录默认用户名。
EMQX_DASHBOARD_PASSWORD	Do_not_use_default_password!	设置 EMQX Dashboard 的 Admin 账号的初始密码并替换默认值。
RMQ_CONSOLE_USER	admin	RocketMQ Dashboard 的初始 Admin 账号的用户名设置新用户名并替换默认值，或记录默认用户名。
RMQ_CONSOLE_PASSWORD	Do_not_use_default_password!	设置 RocketMQ Dashboard 的 Admin 账号的初始密码并替换默认值。

如果在步骤五中，你没有导入 SSL 证书，则你需要在 Advanced Settings 章节中完成以下两项内容的配置：
- SSL_ENABLED：修改默认值为 false
- HTTP_PROTOCOL：修改默认值为 http
按下 Esc 键退出编辑模式，运行下述命令保存更改并退出 .env 文件。
```
:wq
```

步骤七、安装 Yeastar 智慧办公

运行以下命令安装 Yeastar 智慧办公。

./workplace-xx.x.x.x/install

重要提示

替换命令中的 xx.x.x.x 为下载的安装包的版本号再运行，否则会升级失败。
安装过程会持续数分钟，在此期间请保持与服务器主机的连接。

后续步骤

现在你需要根据你所购买的版本激活 Yeastar 智慧办公系统，详细指引参见以下文章：

在线版本参见：
离线版本参见：离线激活并注册企业账号

最后更新: 2022-12-14
创建日期: 2022-05-07