简介

logo_white.png

Cloudreve - Make the cloud easy for everyone

Packagist
Latest Unstable Version
License

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

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

HomePage

目前已经实现的特性:

  • 快速对接多家云存储,支持七牛、又拍云、阿里云OSS、AWS S3、Onedrive、自建远程服务器,当然,还有本地存储
  • 可限制单文件最大大小、MIMEType、文件后缀、用户可用容量
  • 自定义主题配色
  • 基于Aria2的离线下载
  • 图片、音频、视频、文本、Markdown、Ofiice文档 在线预览
  • 移动端全站响应式布局
  • 文件、目录分享系统,可创建私有分享或公开分享链接
  • 用户个人主页,可查看用户所有分享
  • 多用户系统、用户组支持
  • 初步完善的后台,方便管理
  • 拖拽上传、分片上传、断点续传、下载限速(*实验性功能)
  • 多上传策略,可为不同用户组分配不同策略
  • 用户组基础权限设置、二步验证
  • WebDAV协议支持

安装需求

  • LNMP/AMP With PHP5.6+
  • curl、fileinfo、gd扩展
  • Composer

简要安装说明

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`

后续操作

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

  • 修改初始账户密码
  • 到 设置-基础设置 中更改站点URL,如果不更改,程序无法正常接受回调请求
  • 添加Crontab定时任务 :你的域名/Cron
  • 如果你打算使用本地上传策略并且不准备开启外链功能,请将·public/uploads·目录设置为禁止外部访问
  • 如需启用二步验证功能,请依次执行composer require phpgangsta/googleauthenticator:dev-master composer require endroid/qr-code安装二步验证支持库

文档

许可证

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扩展 启用fileinfocurlgd 用于处理文件输出、网络请求、验证码生成 安装并启用相关扩展

选择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@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目录设置为禁止外部访问、禁止脚本执行

重装

如果因为某些问题您需要重装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需要curlfileinfogd扩展支持,请先安装并启用这些扩展。如果您尝试在虚拟主机上安装,请联系您的主机提供商安装以上扩展。

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

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

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

请依次检查:

  • application/database.php是否存在,如果不存在请手动创建写入数据库信息
  • runtime及其子目录是否有写入权限
  • 其他原因,编辑application/config.php打开debug模式,查看详细报错

安装后所有页面空白

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

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

  1. 点击这里下載自动打包的前端静态文件;
  2. 将压缩包下static目录下的所有文件解压至程序目录下的static目录下。
文档更新时间: 2019-10-11 15:50   作者:cklx