文章目录「隐藏」

安装cloudreve

简介

Cloudreve - Make the cloud easy for everyone

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

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

目前已经实现的特性：

快速对接多家云存储，支持七牛、又拍云、阿里云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扩展	启用 `fileinfo` 、 `curl` 、 `gd`	用于处理文件输出、网络请求、验证码生成	安装并启用相关扩展

选择Cloudreve版本

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

选择安装方式

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

开始安装

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

使用完整安装包安装

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

前往安装包发布页下载最新的安装包，解压至您网站的根目录。**注意：目前Cloudreve只支持在根目录下使用；
给runtime 目录写入权限，如果你使用本地存储， public 目录及其子目录也需要有写入权限；

配置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>

前往 您的域名/CloudreveInstaller 进行环境检查、填写数据库信息并导入数据库；
安装完成后还需要进行后续操作，请参考后续操作章节。

使用 `Composer` 安装

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

安装 Composer ；

执行以下命令：
```
curl -sS https://getcomposer.org/installer | php
mv composer.phar /usr/local/bin/composer
```
详细安装说明请参阅http://docs.phpcomposer.com/00-intro.html
如果您的服务器在国内，由于众所周知的原因，您可能需要切换至Composer中国全量镜像以加快安装速度；
在空白的网站根目录下执行
```
composer create-project hfo4/cloudreve:dev-master ./
```
此命令会下载所需依赖并安装开发版的Cloudreve。
等待安装依赖库后，会自动执行安装脚本，按照提示输入数据库账户信息。在此过程中，请给 runtime 目录写入权限，如果你使用本地存储， public 目录及其子目录也需要有写入权限；在安装过程中还额外需要 application static 目录的写入权限，但这两个目录在安装后就可以恢复原有权限配置；
```
   ___ _                 _
  / __ | ___  _   _  __| |_ __ _____   _____
 / /  | |/ _ | | | |/ _` | '__/ _   / / _
/ /___| | (_) | |_| | (_| | | |  __/ V /  __/
____/|_|___/ __,_|__,_|_|  ___| _/ ___|

                Ver XX
================================================
#按提示输入信息
......
```

出现以下提示即表明安装完成：

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

按照使用完整安装包安装章节中第3步的说明配置URL重写规则；
安装完成后还需要进行后续操作，请参考后续操作章节。

使用Docker安装

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

后续操作

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

以下操作是必须的：

登录后台（初始用户名 admin@cloudreve.org"">`admin@cloudreve.org 初始密码 admin 后台URl http://你的域名/Admin ），前往 用户 - 编辑`中修改初始管理员用户的用户名及密码；
到 设置 - 基本设置 中检查 站点URL 是否正确（结尾要带 / ，如果站点启用 https ，这里也应保持一致）；
添加 Crontab 定时任务：
```
  * * * * * curl http://你的域名/Cron
```
如果因为环境设置无法使用 Crontab ，您也可以使用一些免费的网站监控服务。设法让 http://你的域名/Cron 被定期访问即可。

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

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

重装

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

备份原有网站目录、数据库；
删除数据库中所有以sd_开头的数据表；
删除application/database.php文件；
前往您的域名/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重写规则未配置好，请参考开始安装章节进行配置。

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

请依次检查：

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

安装后所有页面空白

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

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

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

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

M	T	W	T	F	S	S
		1	2	3	4	5
6	7	8	9	10	11	12
13	14	15	16	17	18	19
20	21	22	23	24	25	26
27	28	29	30	31

焱讲

生活需要一场演讲，H5、小程序多终端支持

cloudreve安装 – Powered by MinDoc

安装cloudreve

简介

Cloudreve - Make the cloud easy for everyone

安装需求

简要安装说明

1.使用Composer安装主程序

2.目录权限

3.URL重写

4.完成

后续操作

文档

许可证

安装

安装前的准备

选择部署环境

环境检查

选择Cloudreve版本

选择安装方式

开始安装

使用完整安装包安装

使用 `Composer` 安装

使用Docker安装

后续操作

重装

升级

使用增量更新包升级

使用 `git` 手动升级

常见问题

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

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

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

安装后所有页面空白