先锋云盘安装程序教程

先锋男儿

云盘服务器需求：

需要独立服务器，或者阿里云、腾讯云等云服务器部署。

CUP至少1核，内存1G以上，磁盘空间10G以上。有运行shell脚本权限安装的服务器。
安装Centos7以上的linux 操作系统。

第一次使用centos服务器，请安装必要的依赖模块。 运行Yum update 命令。再运行安装依赖模块。

1. yum -y install unzip libxslt libxslt-devel  libjpeg libjpeg-devel libicu-devel

复制代码

开启防火墙端口 20081 端口。

方式1：centos服务器在线安装

Centos7以上系统的服务器环境部署

安装软件包的目录：
本安装包安装后的目录在 /home/xfplay_cloud

目录结构：

/home/xfplay_cloud
……/wwwlogs 日志文件目录
……/www 站点目录
…………/xfcloud
………………云盘文件
……/xfcloud 服务器环境目录
…………/init.d nginx和mysql 以及 php-fpm 和redis的启动脚本
…………/mysql
…………/nginx
…………/php
…………/data mysql的数据存放目录data
………………

自动创建新的用户和用户组xfplay_cloud 用于本环境。

Mysql、nginx的运行用户 和用户组 是 xfplay_cloud用户 和 xfplay_cloud 组；
并非采用root安装，所以安装后，环境没有添加到 自动启动服务器内；
采用非root 权限安装，不会和当前服务器既有环境冲突，解决在已经有nginx、mysql 和php环境的服务器上安装本安装包；

提供在线和离线两种方式进行一键安装包的安装 ，完成搭建Nginx 1.14.1+ php 7.2.6 + mysql5. 5.6 服务器环境；

在线安装

在centos7服务器的shell窗口，用以下脚本获取安装包并安装。

下面参数 需要按您的实际进行修改：
参数 DB_Root_Password=\"Xfcloud111\" 修改成您的密码，即Xfcloud111换成您要设置的密码；这个参数是mysql的root密码以及云盘后台管理员账号admin的密码；注意密码长度一定要大于8位字符，包含大小写和字母，不含特殊字符。

用你的站点域名替换SiteDomain=\"192.168.142.137\" 中的 192.168.142.137 成你的域名；

1. wget http://xfcloud.xfplay.com/xfcloudInstall.tar.gz -cO xfcloudInstall.tar.gz && tar zxf xfcloudInstall.tar.gz && cd xfcloudInstall && LNMP_Auto=\"y\" DBSelect=\"2\" DB_Root_Password=\"Xfcloud111\" InstallInnodb=\"y\" SiteDomain=\"192.168.142.137\" PHPSelect=\"8\" SelectMalloc=\"1\" ./install.sh lnmp

复制代码

如图以上命令也可以分成 下载安装包和 解压并安装 两个步骤：

卸载环境

1. $ /home/xfcloudInstall/uninstall.sh

复制代码

然后按照提示操作，选择1 ，等待3秒后，按回车，即可卸载环境。卸载后用 离线安装方式 可以重新安装。

离线安装

在线安装和离线安装的参数只多了 蓝色部分。其他部分的参数和离线安装相同；
Wget是获取远程安装包到本地，并命名为xfcloudInstall.tar.gz

下载安装包 xfcloudInstall.tar.gz 文件 ，上传压缩包到服务器 的/home目录下。

开始安装步骤：

安装命令：

切换当前目录到home目录；

1. $ cd /home

复制代码

复制安装命令：（记得IP 为服务器IP）

1. $ tar zxf xfcloudInstall.tar.gz && cd xfcloudInstall && LNMP_Auto=\"y\" DBSelect=\"2\" DB_Root_Password=\"Xfcloud111\" InstallInnodb=\"y\" SiteDomain=\"192.168.142.137\" PHPSelect=\"8\" SelectMalloc=\"1\" ./install.sh lnmp

复制代码

上面命令开始后开始自动安装。安装过程如下图所示：

首先安装mysql服务器，然后安装nginx和php环境；
Mysql安装后监听23306端口
Nginx安装后监听20081端口
Redis 监听 26237 端口

用命令 netstat -nltp 可以查看服务器上各端口监听情况。

如下图所示，服务器环境安装成功后监听的端口号：

自动开始安装服务器环境。

命令启动 服务：

1. service xfcloudhttp stop|start|restart|reload
   
2. service xfcloudsql stop|start|restart
   
3. service xfcloud-fpm stop|start|restart
   
4. service xfcloud-caching stop|start|restart

复制代码

如图所示是重启 nginx 服务的命令执行：

环境的启动脚本部署在 /home/xfplay_cloud/xfcloud/init.d/ 目录，所以也可以用

1. /home/xfplay_cloud/xfcloud/init.d/nginx stop|start|restart|reload
   
2. /home/xfplay_cloud/xfcloud/init.d/mysql stop|start|restart|reload
   
3. /home/xfplay_cloud/xfcloud/init.d/php-fpm stop|start|restart|reload
   
4. /home/xfplay_cloud/xfcloud/init.d/redis stop|start|restart|reload

复制代码

可以用 chkconfig xfnginx [ xfnginx| xfmysql| xfphp-fpm | xfcloud-caching ] on 添加到开机启动。

管理员后台初始化

等待安装完成即可通过 http://192.168.142.137:20081/admin（把ip部分 替换成您的） 打开云盘 。(注意服务器安全端口要 添加 放行 20081、 23306端口)。

当在浏览器输入URL访问时，显示nginx 502 错误时，是由于环境的 php-fpm 未启动成功。

可以通过service xfphp- fpm restart 启动。

如果启动时，出现找不到 **pid 文件错误信息。要重新安装环境。 重新安装前，先要卸载之前的安装。 执行安装包里面的 ./uninstall.sh 脚本进行卸载。 然后重新按离线安装方法，进行脚本环境部署。

安装包安装成功后，再浏览器打开网址出现登录界面。

云盘安装后，默认的管理员账号是admin

默认的管理员账号密码是 安装时设置的参数 DB_Root_Password 的具体值。

管理员 admin 登陆 http://192.168.142.137:20081/admin

普通用户登陆 http://192.168.142.137:20081/login

登录后，如果界面显示的语言不是“简体中文”。请在界面点击右上角的头像，进入“设置”界面，找到左侧菜单第一栏的“个人”-“个人信息” 设置语言为“简体中文”。

域名绑定与激活

1.进入后台，点击头像，在弹出下拉菜单中选择“设置”，进入系统参数设置界面： 找到左侧菜单，找到最底部一栏的 “其他设置”，进入域名激活与绑定的设置界面。

2.域名管理。

新增域名前，确保域名已经正常解析到云盘安装的服务器IP上。

默认，域名管理一栏，有安装云盘时设置的域名。 其处于“未激活|激活”状态。点击“激活”，系统返回一个 验证码。请在弹出的输入框内输入收到的验证码。完成域名的激活。

注意：域名未解析到当前服务器，无法激活域名（访问云盘的域名或ip要能在公网访问到才能激活）。 只有经过在后台激活的域名才能通过扫码登录，以及云盘App登录。

填写站点的网址，先锋号授权中心URL（官方获取）；默认。

设置站点名称

“设置界面”，左侧菜单 找到“主题”菜单，设置站点的名称以及 站点简介信息。

开启Redis缓存

服务器环境安装的redis 绑定在127.0.0.1 端口号是 26237，
用 vi命令 编辑 /home/xfplay_cloud/xfcloud/www/xfcloud/config/config.php
追加下面 参数 用于开启云盘redis缓存。

1. \'memcache.local\' => \'\\OC\\Memcache\\Redis\',
   
2. \'redis\' => array (
   
3. \'host\' => \'127.0.0.1\',
   
4. \'port\' => \'26237\',
   
5. \'password\' => \'\',
   
6. \'timeout\' => 1.5,
   
7. \'memcache.locking\' => \'\\OC\\Memcache\\Redis\',
   
8. ),

复制代码

增加位置 如图，注意格式正确。

redis 启用后站点报500错误，可以查看 服务器redis是否正常监听26237端口，如果正常监听。用命令登陆redis的客户端，清除所有缓存记录；

1. /home/xfplay_cloud/xfcloud/redis/bin/redis-cli -p 26237
   
2. 127.0.0.1:26237> flushall

复制代码

MISCONF Redis is configured to save RDB snapshots, but it is currently not able to persist on disk. Commands that may modify the data set are disabled, because this instance is configured to report errors during writes if RDB snapshotting fails (stop-writes-on-bgsave-error option). Please check the Redis logs for details about the RDB error.

执行：

1. 127.0.0.1:26237>  config set stop-writes-on-bgsave-error no

复制代码

然后重启 redis 服务器；

1. /home/xfplay_cloud/xfcloud/init.d/redis restart

复制代码

普通会员登录

普通会员的入口地址是 http://192.168.142.137:20081/login

管理员地址，专门供管理员通过账号密码登录。而用户采用app或先锋号授权的登录方式。
管理员不能在后台添加用户。后台添加的用户，在用户登陆界面无法登录。

常见问题：

问：云盘程序安装后，浏览器打开报500服务器内部错误？

答：这个问题一般是数据库没启动导致程序连接不上数据库； 检查云盘目录所属用户：用户组，如果为root用户和用户组，更改为nginx 运行的用户一般为 xfplay_cloud：xfplay_cloud 通过目录 Chown 命令修改云盘目录用户和用户组所属；

问：云盘程序打开页面报错，如何查看错误具体细节？

答：在云盘目录 /data 下，日志文件xfcloud.log ，查看日志最后一次访问产生的日志记录，找到错误的具体问题。

方式2：Linux宝塔面板安装

如果已经安装有宝塔面板，可以通过宝塔面板新建站点安装云盘。

宝塔安装 云盘 环境：
采用nginx + php7.2 +mysql 5.6以上的配置；

1. server
   
2. {
   
3. #下面是nginx 虚拟站点的基本配置
   
4. listen 80;
   
5. server_name www.wp.cn;
   
6. index index.php index.html index.htm default.php default.htm default.html;
   
7. root /www/wwwroot/www.wp.cn;
   
8. 
   
9. #SSL-START SSL相关配置，请勿删除或修改下一行带注释的404规则
   
10. #error_page 404/404.html;
    
11. #SSL-END
    
12. 
    
13. #ERROR-PAGE-START 错误页配置，可以注释、删除或修改
    
14. error_page 404 /404.html;
    
15. error_page 502 /502.html;
    
16. #ERROR-PAGE-END
    
17. 
    
18. #PHP-INFO-START PHP引用配置，可以注释或修改
    
19. #include enable-php-72.conf;
    
20. #PHP-INFO-END
    
21. 
    
22. #REWRITE-START URL重写规则引用,修改后将导致面板设置的伪静态规则失效
    
23. #include /www/server/panel/vhost/rewrite/www.wp.cn.conf;
    
24. #REWRITE-END
    
25. #禁止访问的文件或目录
    
26. location ~ ^/(\\.user.ini|\\.htaccess|\\.git|\\.svn|\\.project|LICENSE|README.md)
    
27. {
    
28. return 404;
    
29. }
    
30. 
    
31. #一键申请SSL证书验证目录相关设置
    
32. location ~ \\.well-known{
    
33. allow all;
    
34. }
    
35. 
    
36. 
    
37. #下面是云盘站点的必须配置方式
    
38. 
    
39. location / {
    
40. rewrite ^ /index.php$request_uri;
    
41. }
    
42. 
    
43. location ~ ^\\/(?:build|tests|config|lib|3rdparty|templates|data)\\/ {
    
44. deny all;
    
45. }
    
46. location ~ ^\\/(?:\\.|autotest|occ|issue|indie|db_|console) {
    
47. deny all;
    
48. }
    
49. 
    
50. location ~ ^\\/(?:index|remote|public|cron|core\\/ajax\\/update|status|ocs\\/v[12]|updater\\/.+|ocs-provider\\/.+)\\.php(?:$|\\/) {
    
51. fastcgi_split_path_info ^(.+?\\.php)(\\/.*|)$;
    
52. include fastcgi.conf;
    
53. fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    
54. fastcgi_param PATH_INFO $fastcgi_path_info;
    
55. #fastcgi_param HTTPS on;
    
56. #Avoid sending the security headers twice
    
57. fastcgi_param modHeadersAvailable true;
    
58. fastcgi_param front_controller_active true;
    
59. fastcgi_pass unix:/tmp/php-cgi-72.sock;
    
60. fastcgi_intercept_errors on;
    
61. fastcgi_request_buffering off;
    
62. }
    
63. 
    
64. location ~ ^\\/(?:updater|ocs-provider)(?:$|\\/) {
    
65. try_files $uri/ =404;
    
66. index index.php;
    
67. }
    
68. location ~ \\.(?:css|js|woff2?|svg|gif)$ {
    
69. try_files $uri /index.php$request_uri;
    
70. add_header Cache-Control \"public, max-age=15778463\";
    
71. add_header X-Content-Type-Options nosniff;
    
72. add_header X-XSS-Protection \"1; mode=block\";
    
73. add_header X-Robots-Tag none;
    
74. add_header X-Download-Options noopen;
    
75. add_header X-Permitted-Cross-Domain-Policies none;
    
76. add_header Referrer-Policy no-referrer;
    
77. 
    
78. # Optional: Don\'t log access to assets
    
79. access_log off;
    
80. }
    
81. location ~ \\.(?:png|html|ttf|ico|jpg|jpeg)$ {
    
82. try_files $uri /index.php$request_uri;
    
83. # Optional: Don\'t log access to other assets
    
84. access_log off;
    
85. }
    
86. access_log /www/wwwlogs/www.wp.cn.log;
    
87. error_log /www/wwwlogs/www.wp.cn.error.log;
    
88. }

复制代码

以上配置信息，最后两行代码是 宝塔站点配置文件自动生成站点配置信息。

Ubuntu 16.04.6 系统安装

安装包 下载并安装，把下面命令的DB_Root_Password 的值换成你的管理员密码，SiteDomain的值换成你的服务器IP地址。

wget [color=var(--common_blue1_color,#0089ff)]http://xfcloud.xfplay.com/xfcloudInstall_ubuntu.tar.gz -cO xfcloudInstall.tar.gz && tar zxf xfcloudInstall.tar.gz && cd xfcloudInstall && LNMP_Auto="y" DBSelect="2" DB_Root_Password="Xfcloud111" InstallInnodb="y" SiteDomain="192.168.142.137" PHPSelect="8"  SelectMalloc="1"  ./install.sh lnmp

如果提示没有权限安装，可以用su root  到 root权限下安装。
安装后的目录结构部署和centos7 的教程一致。