cloudreve安装 – Powered by MinDoc

/ 0评 / 0

安装cloudreve

简介

Cloudreve - Make the cloud easy for everyone

主页 | 论坛 | 演示站 | QQ群

使用ThinkPHP + React + Redux + Material-UI构建的网盘系统,能够助您以较低成本快速搭建起公私兼备的网盘。

目前已经实现的特性:

安装需求

简要安装说明

1.使用Composer安装主程序

#安装开发版
$ composer create-project hfo4/cloudreve:dev-master
#等待安装依赖库后,会自动执行安装脚本,按照提示输入数据库账户信息
   ___ _                 _                    
  / __ | ___  _   _  __| |_ __ _____   _____ 
 / /  | |/ _ | | | |/ _` | '__/ _   / / _ 
/ /___| | (_) | |_| | (_| | | |  __/ V /  __/
____/|_|___/ __,_|__,_|_|  ___| _/ ___| 

                Ver XX
================================================
#按提示输入信息
......
#出现如下提示表示安装完成
Congratulations! Cloudreve has been installed successfully.

Here's some informatioin about yor Cloudreve:
Homepage: https://pan.cloudreve.org/
Admin Panel: https://pan.cloudreve.org/Admin
Default username: admin@cloudreve.org
Default password: admin

2.目录权限

 runtime 目录需要写入权限,如果你使用本地存储, public  目录也需要有写入权限

3.URL重写

对于Apache服务器,项目目录下的 .htaccess 已经配置好重写规则,如有需求酌情修改.对于Nginx服务器,以下是一个可供参考的配置:

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

4.完成

后台地址: http://您的域名/Admin  初始用户名:admin@cloudreve.org"">`admin@cloudreve.org 初始密码: admin`

后续操作

以下操作不是必须的,但仍推荐你完成这些操作:

文档

许可证

GPLV3

安装

安装前的准备

选择部署环境

Cloudreve目前支持在虚拟主机、独立服务器、Docker等虚拟环境中安装,但Cloudreve的正常运行对部署环境有着一定的要求。Cloudreve的基本运行环境为 Apache/nginx  + MySQL  +  PHP ,对于日后不同的使用需求,可能还需要增加新的要求。

环境检查

此处列出的仅为基本要求,后续安装时还需要进行额外项目检查。

检查项 要求 说明 不满足的解决方案
PHP版本 大于或等于5.6 满足Cloudreve基本需求的最低PHP版本为5.6 升级PHP版本
MySQL版本 大于或等于5.5.3 满足Cloudreve基本需求的最低MySQL版本为5.6 升级MySQL版本
服务器程序( nginx/Apache  等) 启用 UrlRewrite 相关模块 用于URL重写(伪静态)  Apache :启用 url_rewrite 模块; nginx :无需启用新模块,但是需进行后续额外配置(见后文)
php扩展 启用 fileinfo  curl  gd  用于处理文件输出、网络请求、验证码生成 安装并启用相关扩展

选择Cloudreve版本

Cloudreve目前有开发版和稳定版。其中开发版更新较快、潜在Bug较多、新特性较多;稳定版更新则相对缓慢。目前Cloudreve仍处于起步状态,因此仍推荐你选择开发版以获得较快的Bug修复、功能更新速度。

选择安装方式

Cloudreve可以通过完整安装包、Composer、Docker进行安装,您可以根据喜好及需求选择安装方式。其中使用Composer安装全程可在命令行下进行,完整安装包安装可使用WebUI操作。

开始安装

选择以下任意一种方式开始安装。

使用完整安装包安装

Cloudreve在每个 commit 后都会自动打包安装包,其中已包含依赖库、静态资源,安装步骤较为简单,也是我们推荐的方式。

  1. 前往安装包发布页下载最新的安装包,解压至您网站的根目录。**注意:目前Cloudreve只支持在根目录下使用;

  2.  给runtime 目录写入权限,如果你使用本地存储, public  目录及其子目录也需要有写入权限;

  3. 配置URL重写,Cloudreve的配置方式与 ThinkPHP 相同,如果遇到麻烦,你也可以参考有关 ThinkPHP URL重写的配置教程。

    如果您使用的是 Apache ,一般情况下无需进行额外配置,只需要启用 url_rewrite 模块即可。

    如果您使用的是 nginx ,请在网站配置文件中添加以下内容:

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

    如果您使用的是 kangle ,请将程序根目录下 .htaccess 的内容改为:

    <IfModule mod_rewrite.c>
        RewriteEngine on
        RewriteBase /
        RewriteCond %{REQUEST_FILENAME} !-d
        RewriteCond %{REQUEST_FILENAME} !-f
        RewriteRule (.*)$ index.php/$1?%{QUERY_STRING} [QSA,PT,L]
    </IfModule>

    如果您使用的是 IIS ,请先在IIS中安装 urlwrite ,并在程序根目录新建 web.config ,键入以下内容:

    <?xml version="1.0" encoding="UTF-8"?>
    <configuration>
      <system.webServer>
        <rewrite>
          <rules>
            <rule name="WPurls" enabled="true" stopProcessing="true">
              <match url=".*" />
              <conditions logicalGrouping="MatchAll">
                <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
                <add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
              </conditions>
              <action type="Rewrite" url="index.php/{R:0}" />
            </rule>
          </rules>
        </rewrite>
      </system.webServer>
    </configuration>
  4. 前往 您的域名/CloudreveInstaller 进行环境检查、填写数据库信息并导入数据库;

  5. 安装完成后还需要进行后续操作,请参考后续操作章节。

使用 Composer 安装

 Composer 为PHP的包管理器,你可以使用 Composer 在命令行环境下进行安装。

  1. 安装 Composer 

    执行以下命令:

    curl -sS https://getcomposer.org/installer | php
    mv composer.phar /usr/local/bin/composer

    详细安装说明请参阅http://docs.phpcomposer.com/00-intro.html

  2. 如果您的服务器在国内,由于众所周知的原因,您可能需要切换至Composer中国全量镜像以加快安装速度;

  3. 在空白的网站根目录下执行

    composer create-project hfo4/cloudreve:dev-master ./

    此命令会下载所需依赖并安装开发版的Cloudreve。

  4. 等待安装依赖库后,会自动执行安装脚本,按照提示输入数据库账户信息。在此过程中,请给 runtime 目录写入权限,如果你使用本地存储, public  目录及其子目录也需要有写入权限;在安装过程中还额外需要 application  static 目录的写入权限,但这两个目录在安装后就可以恢复原有权限配置;

       ___ _                 _
      / __ | ___  _   _  __| |_ __ _____   _____
     / /  | |/ _ | | | |/ _` | '__/ _   / / _
    / /___| | (_) | |_| | (_| | | |  __/ V /  __/
    ____/|_|___/ __,_|__,_|_|  ___| _/ ___|
    
                    Ver XX
    ================================================
    #按提示输入信息
    ......
  5. 出现以下提示即表明安装完成:

    Congratulations! Cloudreve has been installed successfully.
    
    Here's some informatioin about yor Cloudreve:
    Homepage: https://pan.aoaoao.me/
    Admin Panel: https://pan.aoaoao.me/Admin
    Default username: admin@cloudreve.org
    Default password: admin
  6. 按照使用完整安装包安装章节中第3步的说明配置URL重写规则;

  7. 安装完成后还需要进行后续操作,请参考后续操作章节。

使用Docker安装

你可以使用由 @ilemonrain 维护的Docker镜像:https://hub.docker.com/r/ilemonrain/cloudreve/

后续操作

安装完成后还需要进行一些后续操作以避免奇怪的问题及安全隐患。

以下操作是必须的:

以下操作不是必须的,但仍推荐完成:

重装

如果因为某些问题您需要重装Cloudreve请按照以下步骤操作。

  1. 备份原有网站目录、数据库;
  2. 删除数据库中所有以sd_开头的数据表;
  3. 删除application/database.php文件;
  4. 前往您的域名/CloudreveInstaller重新安装。

升级

Cloudreve会在每个稳定版本发布的同时,在release页面发布增量更新包,适用于开发版和稳定版。如使用的是开发版,也可以使用 git 更新至最新的版本,无需等待安装包。

使用增量更新包升级

在Cloudreve后台 其他  -  关于 中查看当前版本,在release页面下载与你版本对应的升级包,一般名为 update_patch_for_您当前版本.zip 

备份当前网站文件、数据库,参考发布说明中的升级说明部分进行升级。一般必须进行的步骤为:覆盖升级包到网站根目录、访问后台首页升级数据库。

注意:每个稳定版发布时,只会发布与其相近版本的旧版升级包,如果您所使用的版本过旧,请以此覆盖过去的升级包以升级至最新版本。

使用 git 手动升级

此种方法适用于开发版并且未对Cloudreve程序进行改动的用户。升级前请确保已安装 git ,并且网站根目录下的 .git 目录未被删除。

在网站根目录下执行以下命令:

git pull

如果您修改了代码,可能会需要进行合并操作。

点击这里下载最新的静态资源文件,将其中 static 目录下的所有内容覆盖至网站目录下 stiatic 目录中。

常见问题

这里记录了安装过程中常被问到的问题及解决建议。

Composer安装Cloudreve时提示 The requested PHP extension ext-XXX * is missing from your system 

这是PHP扩展未达到要求所致,Cloudreve需要 curl  fileinfo  gd 扩展支持,请先安装并启用这些扩展。如果您尝试在虚拟主机上安装,请联系您的主机提供商安装以上扩展。

安装成功后页面 404 / No input file specified .

URL重写规则未配置好,请参考开始安装章节进行配置。

安装后首页提示”遇到错误”

请依次检查:

安装后所有页面空白

安装方式有误导致前端静态文件缺失。目前Cloudreve代码的主仓库中不含静态文件,直接clone下来安装会有文件缺失。您可以使用官网安装包安装,其中已包含静态文件,或者使用 composer creat-project 命令安装,详情参考开始安装章节。

如果您不想重新安装,可以参考以下步骤手动补全静态文件:

  1. 点击这里下載自动打包的前端静态文件;
  2. 将压缩包下 static 目录下的所有文件解压至程序目录下的 static 目录下。

文档更新时间: 2019-10-11 15:50   作者:cklx