宝塔面板部署Discuz! Q – 附内测版申请方法及安装教程

Discuz! Q 是更轻的，更易变现的，更移动端的，更开放的和更易于二次开发的社区产品。Discuz! Q 内测版申请地址目前已经开通了，DNSPod 用户优先体验 Discuz! Q 内测版。

内测版本为提供给 DNSPod 忠实用户及开发者预先体验，暂时并不合适在生产环境中使用，建议优先用于开发环境。这篇文章还是用宝塔面板来安装体验Discuz! Q。

具体的申请安装和部署

---

1、申请

申请地址：https://www.dnspod.cn/promo/discuzq

演示地址：https://discuz.chat/

DNSPod 用户优先体验 Discuz! Q 内测版！参与方式如下：

• 登录 DNSPod
• 确保域名账户内 至少有1个域名
• 下载使用

如果你没有域名，你要么注册一个要么转入一个。在申请页面，点击“申请内测权限”→“获取部署权限”→“查看部署文档”如图：

申请内测就简单提一下，下面说说如何用宝塔部署。

2、准备

2.1 服务器要求

Discuz! Q 对系统有一些要求，请确保你的服务器满足以下要求：

1. MySQL >= 5.7
2. PHP >= 7.2.0
3. NGINX安装好
4. 准备一个域名
5. BCMath PHP 拓展
6. Ctype PHP 拓展
7. JSON PHP 拓展
8. Mbstring PHP 拓展
9. OpenSSL PHP 拓展
10. PDO PHP 拓展
11. Tokenizer PHP 拓展
12. XML PHP 拓展
13. 安装composer（教程：linux宝塔面板安装composer的方法）

2.2、删除禁用函数

为了防止下载的时候出现问题请先删除pcntl_signal()、putenv()。这些在“PHP管理”→“禁用函数”中删除，如图：

3、下载 Discuz! Q

Discuz! Q 使用 Composer 来管理项目依赖。因此，在使用 Discuz! Q 之前，请确保你的机器已经安装了 Composer。

3.1 内测下载 Discuz! Q

首先注册腾讯云帐号并实名认证，然后在内测申请处完成申请。

接下来，在API密钥管理处新建一个密钥，运行下列命令可下载 Discuz! Q，具体命令如下：（最好是新建网站，之后进入到网站根目录下载。）

首先注册腾讯云帐号并实名认证，然后在内测申请处完成申请。

接下来，在API密钥管理处新建一个密钥，运行列命令可下载 Discuz! Q

composer create-project --prefer-dist qcloud/discuz --repository=https://cloud.discuz.chat

composer会提示输入用户名和密码，请在用户名处输入通过API密钥管理创建的 SecretId，在密码处输入 SecretKey。当composer询问是否将密码保存时，可选择Yes。只要你已经登记过内测资格，就可以开始下载了。

你也可以在开始下载之前，先用下面的命令设置一下用户名和密码，这样下载时就不会再询问用户名和密码。输入下面的命令时，请用你自己的 SecretId 和 SecretKey 替换下面命令中的 <SecretId> 和 <SecretKey>

composer config -g http-basic.cloud.discuz.chat <SecretId> <SecretKey>

composer会自动下载Discuz! Q和依赖的所有第三方库。由于composer自身的原因，在下载第三方库时可能会比较慢，也有可能会在下载一些国外资源的时候出错，如果遇到这样的问题，请使用搜索引擎搜索解决，也可使用腾讯云的composer镜像。

请注意

请不要泄露自己的SecretId和SecretKey，泄露这两个信息等同于将自己的整个腾讯云帐号拱手送人，可能会导致高额帐单或数据丢失

#Web 服务器配置

Web服务器推荐启用SSL(https协议)，如果没有SSL证书，可以到这里申请。

#Nginx

如果你使用 Nginx ，除了PHP的相关配置之外，还要在你的站点配置中加入以下配置，建议(非强制)开启 https 和 http2 ，将root目录指向 discuz/public 目录，同时一定要配置 location /、location /install 和 location /api ，将所有的请求将引导至 index.html 前端控制器和后端 index.php API控制器：

    listen 443 ssl http2;
    listen 80;
    server_name www.xxx.com;
    root /home/www/discuz/public;

    ssl_certificate /xxx/server.crt;
    ssl_certificate_key /xxx/server.key;


    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout  24h;

    ssl_prefer_server_ciphers   on;
    ssl_ciphers EECDH+AESGCM:EDH+AESGCM:AES256+EECDH:AES256+EDH;
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ecdh_curve secp521r1:secp384r1;
    ssl_session_tickets off;
    ssl_stapling  on;
    ssl_stapling_verify on;
    ssl_buffer_size 4k;

    add_header Strict-Transport-Security "max-age=31536000; includeSubDomains; preload" always;
    add_header X-Frame-Options "SAMEORIGIN";
    add_header X-XSS-Protection "1; mode=block";
    add_header X-Content-Type-Options "nosniff";

    index index.html;

    location /install {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location /api {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location / {
        try_files $uri $uri/ /index.html;
    }

    location = /favicon.ico { access_log off; log_not_found off; }
    location = /robots.txt  { access_log off; log_not_found off; }

    error_page 404 /index.php;

#Apache

Apache要在配置中，将 DocumentRoot 指向 discuz/public 目录，同时通过重写规则，将 /install 和 /api 请求转发给 index.php，其它请求由 index.html 处理

  DocumentRoot /app/public
  <IfModule mod_rewrite.c>
    RewriteEngine on
    RewriteRule ^/install.*  /index.php?%{QUERY_STRING} [L,QSA,PT]
    RewriteRule ^/api.*  /index.php?%{QUERY_STRING} [L,QSA,PT,E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
    RewriteCond %{DOCUMENT_ROOT}/%{REQUEST_FILENAME} !-f
    RewriteCond %{DOCUMENT_ROOT}/%{REQUEST_FILENAME} !-d
    RewriteRule (.*) /index.html [L]
  </IfModule>

#通过站点启动安装

部署好服务器环境后，打开 http://{您的域名}/install 进入安装界面，按照页面提示进行安装。

#进入后台

安装完成后，请访问 http://{您的域名}/admin 进入后台，输入在安装的时候设置的管理员账号和密码，进行管理与配置。

#配置说明

#公共路径

安装完 Discuz! Q 之后，你的 web 服务的文档目录指向 public 路径。该路径下的 index.php 文件作为所有接口控制器, index.html 作为所有前端 HTTP 请求控制器。

#配置文件

Discuz! Q 的所有配置文件存放在 config 目录下。每个选项都有文档标注，便于通过文件查看并熟悉对你有用的选项。

#目录权限

在安装 Discuz! Q 后，你可能需要配置一些权限。 storage 目录在你的 web 服务下应该是可写的权限，否则 Discuz! Q 将无法运行。

#应用密钥

在安装过程中，应用密钥已经通过 php disco key:generate 命令为你设置好了。

通常，这个字符串应该是 32 个字符长度。这个密钥将会设置在 config.php 文件中。如果应用密钥还没有设置，你的用户会话和其他的加密数据将会不安全

#其他配置

Discuz! Q 几乎不需要除上面所说的其他什么配置了。打开你的站点开始你建站之旅然而，你可能会想要再次查看 config/config.php 文件和它的注释说明。它包含一些你希望根据你应用来更改的选项，诸如： timezone 和 locale 。

接下来，在API密钥管理处新建一个密钥，运行下列命令可下载 Discuz! Q，具体命令如下：（最好是新建网站，之后进入到网站根目录下载。）