QStack云管系统安装说明

qstack

1. 环境要求

系统基于ThinkPHP6.0开发，环境要求如下：

运行环境 : IIS+PHP+MySQL、Apache+PHP+MySQL、Nginx+PHP+MySQL
服务器推荐配置 : CPU - 2核,内存 - 2G,硬盘 - 10G
PHP版本 : 只支持PHP7.3
MySQL版本 : 5.6或者5.7
请勿使用 Debug 版本或 32 位的 PHP
Windows平台下线程安全版，一般用于Apache或IIS，非线程安全一般用于Nginx
解码器
- Windows(非线程安全)采用qstack_nzts_x64.dll
- Windows(线程安全)采用qstack_zts_x64.dll
- Linux(非线程安全)qstack_nzts_x64.so
- Linux(线程安全)qstack_zts_x64.so
- Windows在PHP安装目录下的ext目录里加入以上符合环境的.dll文件,Linux在PHP安装目录下的extensions目录里加入以上符合环境的.so文件

2. 安装宝塔 (其它面板工具请自行参考相关教程)

此手册教程以宝塔Linux面板为例,Windows教程请自行参考官方教程地址
宝塔面板官方教程地址 : https://www.bt.cn/bbs/thread-19376-1-1.html ，在教程中我们服务器选装的是Centos7.6系统，因此在服务器中执行命令 :
yum install -y wget && wget -O install.sh http://download.bt.cn/install/install_6.0.sh && sh install.sh
回车后开始自动安装，安装大概需要5-15分钟。
安装成功后，会显示出你的宝塔面板登录地址、帐号和密码，如图 :

3. 网站部署

此手册选择LNMP的方式部署网站,其它方式请自行参考相关教程。

在浏览器中输入上一步获取到的宝塔面板地址(外网、内网地址自行选择) http://ip:8888/33b01324 进行访问, 然后输入获取的账号(username)和密码(password)登录宝塔。
在"软件商店"的菜单按照Nginx、MySQL、PHP7.3 的顺序安装这三大套件，安装过程大概需要5-10分钟。
安装完成后，查看"已安装"，如图 :

网站部署

打开"网站"菜单，添加"网站",如图

输入网站的"域名"，网站的根目录会自动生成
输入数据库的"用户名"，数据库密码会自动生成，也可以自行修改
PHP版本选择PHP-73

源码上传

网站创建后，选择对应网站的"根目录"进去，如下图 :
点击"上传"，选择"qstack3.0.zip"源码压缩包，将该压缩包上传到"www.qstack.com"目录下，并解压，如下图:

4. 网站配置

网站目录配置 : 点击"设置"，取消"防跨站攻击"的勾选，网站目录设置为"/www/wwwroot/qstack",由于网站框架是ThinkPHP6，所以运行目录应选择"/public",如下图 :

伪静态配置,本例为Nginx，故配置Nginx的伪静态规则

其它伪静态规则配置

apache伪静态规则

<IfModule mod_rewrite.c>
  Options +FollowSymlinks -Multiviews
  RewriteEngine On
  RewriteCond %{REQUEST_FILENAME} !-d
  RewriteCond %{REQUEST_FILENAME} !-f
  RewriteRule ^(.*)$ index.php?/$1 [QSA,PT,L]
</IfModule>

nginx伪静态规则

location / {
    if (!-e $request_filename){
       rewrite  ^(.*)$  /index.php?s=$1  last;   break;
    }
}

IIS伪静态规则

<?xml version="1.0"encoding="utf-8"?>
<configuration> 
  <system.webServer> 
    <rewrite> 
      <rules> 
        <rule name="qstack"stopProcessing="true"> 
          <match url="^(.*)$"ignoreCase="false"/>  
          <conditions logicalGrouping="MatchAll"> 
            <add input="{REQUEST_FILENAME}"matchType="IsDirectory"ignoreCase="false"negate="true"/>  
            <add input="{REQUEST_FILENAME}"matchType="IsFile"ignoreCase="false"negate="true"/> 
          </conditions>  
          <action type="Rewrite"url="index.php?s=/{R:1}"appendQueryString="true"/> 
        </rule> 
      </rules> 
    </rewrite> 
  </system.webServer> 
</configuration>

扩展配置(解密扩展)

点击"文件"菜单，可以看到根目录下的www目录情况，将qstack_nzts_x64.so文件上传到"/www/server/php/73/lib/php/extensions/no-debug-non-zts-20180731"目录下
点击"软件商店"菜单，选择"PHP-73"软件，点击"设置"，找到"配置文件"选项，打开将"extension=qstack_nzts_x64"插入到文件末尾,如下图 :
启用"shell_exec"函数,找到"PHP-73"软件，点击"设置",在"禁用函数"里删除"shell_exec"即可
重启PHP服务

5. 网站安装

访问 http://域名/install 进行安装

点击"同意安装协议" ，如果您使用的是Linux系统，在目录、文件权限检查的时候，默认网站目录及文件所有者是www用户,目录权限是755,如若发现有目录不可写入，请自行检查设置文件目录权限

填写前面第二个步骤创建的qstack数据库配置信息,配置自己的团队拥有者账号信息(即后台超级管理员登录信息)

进入数据库安装

数据库以及网站安装完成，如下图 :

点击"完成"可访问系统前台，点击"登录后台"可访问系统后台

6. 系统授权

3.2.2之后的系统版本支持免授权直接使用，只需要使用免费版功能的用户可以不需要进行系统授权操作。

各个版本之间的差异，以及授权的购买方式，请上 https://www.qstack.net/product/authorize.html 进行了解。

登陆系统后，点击系统右上角的“基础版”按钮。
输入在平台购买的授权码，点"确定"进行激活。
授权成功后版本图标会发生变化，同时系统的相应功能也解锁。

至此，所有安装及系统授权操作完毕。

michael

Nginx默认安装的版本为1.20会出现下里面的错误提示，将版本调整为1.16即可
宝塔面包-软件商店-Nginx管理-版本切换-ngnix 1.16```
code_text

ERROR:检测到配置文件有错误，请先排除后再操作
nginx: [emerg] open( "/www/server/nginx/conf/enable-php.conf"
 failed (2: No SuCh file or directory) in
 /www/server/nginx/conf/nginx.conf:.71
nginx: configuration file /www/server/nginx/conf/nginx.conf test failed

michael