安装

#服务器要求

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

MySQL >= 5.7

PHP >= 7.2.0

BCMath PHP 扩展

Ctype PHP 扩展

Curl PHP 扩展

Dom PHP 扩展

Fileinfo PHP 扩展

GD PHP 扩展

JSON PHP 扩展

Mbstring PHP 扩展

OpenSSL PHP 扩展

PDO 与 PDO_mysql PHP 扩展

Tokenizer PHP 扩展

XML PHP 扩展

#下载 Discuz! Q

#内测下载 Discuz! Q

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

接下来，在API密钥管理处新建一个密钥，然后选择下面的一种方法下载 Discuz! Q

注意

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

#推荐方法: 使用腾讯云镜像安装

基于官方提供的腾讯云镜像，可快速安装，不再需要自己修改配置。请点击这里 打开官方镜像，点击『免费使用』，基于镜像创建CVM。注意以下事项：

操作系统的root密码在创建云主机的过程中设置

宝塔面板使用了 8888 端口，登录用户名为 adminadmin 密码为 adminadmin，服务器创建完成后，请 务必修改端口、用户名、密码、设置安全登录地址

数据库已经事先创建好，名为 discuz，用户名也是 discuz，密码请通过宝塔面板 重新设置

网站已经创建并配置完成，名为 discuz.local ，请绑定自己的域名，并在绑定域名后将网站设置为非默认网站

先配置好域名与证书(如果有需要)，然后访问 Discuz! Q安装工具： http://域名/dl.php 或 https://域名/dl.php

因为要下载Discuz! Q，服务器必须能访问公网，如果遇到 dl.php 找不到的情况，请确认自己的服务器能访问公网后，重启服务器

如果宝塔或安装工具无法访问，请检查自己的 安全组设置

如果基于IP安装后要修改域名，请参考安装常见问题

#方法二：使用Discuz! Q安装工具

请在你的Web服务器上安装并配置好PHP，在要安装 Discuz! Q 的地方建一个 discuz 目录，下面再建一个 public 目录。将站点的根目录指向刚建立好的 public 目录。

然后请点击这里 下载安装工具，将下载后的文件放入 public 目录。最终的目录结构类似以下：

/wwwroot

└── discuz

└── public /dl.php ，并按提示操作。下载工具会检查所有相关的环境要求是否满足要求，请在每一步解决完所有的错误后，再进行下一步操作。按下载工具向导一步一步完成后，Discuz! Q 就会完成安装。

#方法三：使用composer在线下载

使用这种方法安装之前，请确保你的机器已经安装了Composer 。

请在你需要安装Discuz! Q的地方通过命令行运行以下命令，这个命令运行完之后，会在当前目录下创建一个名叫 discuz 的子目录。

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

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

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

composer config -g http-basic.cloud.discuz.chat composer会自动下载Discuz! Q和依赖的所有第三方库。由于composer自身的原因，在下载第三方库时可能会比较慢，也有可能会在下载一些国外资源的时候出错，如果遇到这样的情况，请参考安装常见问题

源代码下载完成后，请按本文档完成接下来的Web服务器配置、进入安装界面、配置计划任务等工作。

#方法四：基于Docker容器运行Discuz! Q

首先确保你已经按上面的内测要求完成了内测申请，并准备好了 SecretId 和 SecretKey。同时你的服务器安装好了 docker-ce 运行环境，如果还没有下载，腾讯云提供了镜像。

接下来，请运行以下命令，并在用户名处输入 SecretId，密码处输入 SecretKey，并确认命令返回登录成功

docker login registry.discuz.chat

下一步可以直接启动Discuz! Q

docker run -d -p 80:80 -p 443:443 registry.discuz.chat/tencent/dzq:latest

docker会自动下载并运行最新版本的Discuz! Q。此容器基于 Ubuntu 18.04，其中安装了 Nginx 1.14, PHP 7.2, MySQL 5.7 和所有的相关依赖，并且已经完成了Web服务器配置和计划任务配置，可直接进入安装界面进行初始化。数据库 root 用户的密码已被设置为 root。

注意

以上命令用于快速启动并测试Discuz! Q，数据库和站点数据都将保存在容器内部，容器被删除将会造成数据丢失。

如果您想基于容器长期运行Discuz! Q，建议将数据库和站点数据保存于容器外部，请参考容器的更多配置说明进行配置

#Discuz! Q 正式版下载

正式版下载方案敬请期待

#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

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]

#通过站点启动安装

在进入安装界面之前，请确保 php-fpm 的运行用户，拥有 config, storage 和 public 三个目录的写权限。

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

注意

请一定要访问外部用户将要访问的协议( http:// 或 https:// ) 加 域名 加 /install 进行安装，否则会导致自动获取的站点URL配置不正确，站点工作不正常。

#进入后台

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

#计划任务

目前统计财务报表需要用到系统计划任务，Linux 服务器配置如下：

* * * * * php /home/wwwroot/discuss/disco schedule:run > /dev/null 2>&1

#配置说明

#公共路径

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