安装cloudreve
简介
Cloudreve - Make the cloud easy for everyone
使用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
-
如果您的服务器在国内,由于众所周知的原因,您可能需要切换至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