云盘开源程序Cloudreve介绍及搭建介绍

目前已经实现的特性：

安装

本文将会介绍Cloudreve在不同场景下的安装方式，请根据您的情况按照说明进行操作，如果遇到麻烦，请仔细核对步骤是否正确。

安装前的准备

选择部署环境

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

环境检查

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

选择Cloudreve版本

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

选择安装方式

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

开始安装

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

使用完整安装包安装

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

1. 前往安装包发布页下载最新的安装包，解压至您网站的根目录。**注意：目前Cloudreve只支持在根目录下使用；
2. 给runtime目录写入权限，如果你使用本地存储，public 目录及其子目录也需要有写入权限；
3. 配置URL重写，Cloudreve的配置方式与ThinkPHP相同，如果遇到麻烦，你也可以参考有关ThinkPHPURL重写的配置教程。

   如果您使用的是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/

后续操作

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

以下操作是必须的：

• 登录后台（初始用户名admin@cloudreve.org 初始密码 admin 后台URlhttp://你的域名/Admin），前往用户 - 编辑中修改初始管理员用户的用户名及密码；
• 到设置 - 基本设置中检查站点URL是否正确（结尾要带/，如果站点启用https，这里也应保持一致）；
• 添加Crontab定时任务：

    * * * * * curl http://你的域名/Cron

  如果因为环境设置无法使用Crontab，您也可以使用一些免费的网站监控服务。设法让http://你的域名/Cron被定期访问即可。

以下操作不是必须的，但仍推荐完成：

• 如果你需要使用二步验证功能，请在程序目录下依次执行composer require phpgangsta/googleauthenticator:dev-master composer require endroid/qrcode安装二步验证扩展
• 如果你打算使用本地上传策略并且不准备开启外链功能，请将public/uploads目录设置为禁止外部访问、禁止脚本执行

官网：https://cloudreve.org

github：https://github.com/cloudreve/Cloudreve