简介这是一套基于Cloudreve的私人云盘源码面向希望自建文件存储与共享服务的个人用户、小型团队及企业运维人员可部署在本地服务器上实现员工数据随时备份与文件传输。压缩包共约2000个文件整体19.42MB以776个PHP核心程序、322个JavaScript脚本、148个HTML页面和71个CSS样式为主另含23个SQL数据库脚本、46个JSON配置及若干Markdown说明文档构成完整的前后端与安装体系。资源附带以宝塔面板为例的搭建教程涵盖PHP7.0以上环境、fileinfo扩展安装、建站建库、源码上传、运行安装入口及伪静态规则配置等关键环节并配有安装视频演示。目前已有699人学习下载。读者可获得一套简洁美观的云网盘系统支持多类型文件与视频的共享传输既能用于个人私有云搭建也可作为企业内部文件备份与协作平台借助教程与源码快速完成部署与二次开发。1. Cloudreve 云盘源码从零搭一套能跑文件共享的私有云盘手里有台闲置云主机想给自己或小团队弄个文件共享盘又不想把数据放在别人服务器上这个念头很多人都有。Cloudreve 就是干这个的一套开源的云网盘系统源码PHP 写的支持本地存储、对象存储、WebDAV、多用户、分享链接和离线下载界面简洁部署门槛不高。标题里说的「私人云盘源码 搭建教程 文件共享传输」落到实操就是三件事把源码跑起来、把存储和数据库配通、把上传下载和分享链路验证一遍。这篇按我实际搭过几套的经验写从环境选型到参数配置到踩坑排查新手能照着复现熟手能直接看边界和调优点。适合想自建网盘的个人、小团队运维以及需要私有文件共享传输但预算有限的场景。2. 环境选型与源码获取云主机系统怎么选、PHP 版本怎么定2.1 云主机用什么系统Ubuntu 22.04 与宝塔面板的取舍搭 Cloudreve 第一步不是下载源码是决定跑在什么环境上。常见做法有两种一种是纯命令行Ubuntu 22.04 Nginx PHP MySQL 手动配另一种是用宝塔面板这类可视化面板把 Nginx、PHP、MySQL 一键装好再挂站点。两种都能跑通区别在维护成本。纯命令行的好处是干净、可控出问题看日志定位直接适合熟悉 Linux 的人。缺点是 PHP 扩展、伪静态、权限这些要自己一项项配。宝塔的好处是新手友好站点、数据库、SSL、伪静态都能点出来缺点是面板本身占资源且部分默认配置和 Cloudreve 的伪静态规则不完全一致需要手动改。我一般给新手的建议是先用宝塔把整套跑通理解各组件关系后再考虑迁到纯命令行。云主机配置上1 核 2G 能跑起来但要开离线下载或多人同时传大文件建议 2 核 4G 起步磁盘按你要存的文件量算系统盘之外单独挂一块数据盘放上传目录方便扩容和迁移。注意不要把上传目录放在系统盘根目录下后期磁盘满了迁移很麻烦一开始就挂数据盘并规划好路径。2.2 PHP 版本与扩展Cloudreve 对运行环境的具体要求Cloudreve 是 PHP 应用对版本有要求。较新的版本一般要求 PHP 7.4 及以上推荐 8.0 或 8.1。PHP 8.2 部分版本可能有兼容提示稳妥起见用 8.0/8.1。需要的扩展主要有fileinfo、gd、mysqli、pdo_mysql、curl、mbstring、openssl、zip。缺哪个装哪个装完记得重启 PHP-FPM。用宝塔的话在「软件商店」装 PHP 8.1然后在「已安装」里点设置进「安装扩展」把上面几个勾上。纯命令行用 apt 装# Ubuntu 22.04 安装 PHP 8.1 及 Cloudreve 所需扩展 sudo apt update sudo apt install -y php8.1-fpm php8.1-mysql php8.1-gd php8.1-curl \ php8.1-mbstring php8.1-xml php8.1-zip php8.1-fileinfo php8.1-openssl # 验证扩展是否加载 php -m | grep -E fileinfo|gd|mysqli|pdo_mysql|curl|mbstring|openssl|zip这段命令先装 PHP-FPM 和扩展包再用php -m列出已加载模块grep 过滤出 Cloudreve 需要的几个。如果某个没输出说明没装上回去补装对应包再重启php8.1-fpm。参数上php8.1-fpm是进程管理器Nginx 通过它处理 PHP 请求版本号要和后面 Nginx 配置里的 socket 路径一致否则 502。2.3 源码获取与目录规划放哪、权限怎么给源码从 Cloudreve 官方发布渠道获取下载后解压到网站根目录。目录规划建议路径用途权限建议/www/wwwroot/cloudreve程序根目录属主 www:www755/www/wwwroot/cloudreve/uploads本地上传目录属主 www:www755可写/www/data/cloudreve数据盘挂载点单独磁盘755解压后要给运行用户写权限否则上传和安装会失败# 假设网站目录为 /www/wwwroot/cloudreve运行用户为 www cd /www/wwwroot/cloudreve chown -R www:www . chmod -R 755 . # 如果 uploads 目录单独存在确保可写 chmod -R 775 uploadschown把属主改成 Web 运行用户chmod 755给目录读执行权限775给 uploads 组写权限。权限给太开比如 777有安全风险给太紧上传会报「无法写入」。判断标准安装向导能过、后台上传测试文件成功就说明权限对了。3. 数据库与站点配置把 Cloudreve 跑起来的关键参数3.1 建库建用户字符集和权限的坑Cloudreve 需要 MySQL 5.7 或 MariaDB 10.2。建库时字符集用utf8mb4排序规则utf8mb4_unicode_ci否则中文文件名和 emoji 会乱码或报错。-- 创建数据库和专用用户避免直接用 root CREATE DATABASE cloudreve DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; CREATE USER cloudrevelocalhost IDENTIFIED BY 换成你的强密码; GRANT ALL PRIVILEGES ON cloudreve.* TO cloudrevelocalhost; FLUSH PRIVILEGES;这段 SQL 建了一个cloudreve库字符集 utf8mb4然后建专用用户并只授权这个库。用专用用户而不是 root是为了最小权限原则万一程序被攻破影响范围限于本库。密码要够强别用 123456。FLUSH PRIVILEGES让权限立即生效。提示如果安装向导连数据库报「Access denied」先确认用户名、密码、库名三者一致再确认用户 host 是 localhost 还是 %远程连库要用 %。3.2 Nginx 伪静态与 PHP 配置URL 重写和上传大小Cloudreve 用伪静态做路由Nginx 要配 rewrite 规则否则除首页外都 404。宝塔里在站点设置「伪静态」粘贴规则纯命令行写进 server 块# Cloudreve 伪静态规则放在 server 块内 location / { try_files $uri $uri/ /index.php?$query_string; } # PHP 处理socket 路径按实际 PHP 版本改 location ~ \.php$ { fastcgi_pass unix:/run/php/php8.1-fpm.sock; fastcgi_index index.php; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; include fastcgi_params; }try_files让不存在的路径交给 index.php 处理这是伪静态核心。fastcgi_pass指向 PHP-FPM 的 socket路径要和实际版本匹配写错就是 502。上传大文件还要改 PHP 和 Nginx 的上传限制; php.ini 中调整按需改大小 upload_max_filesize 2048M post_max_size 2048M max_execution_time 600 memory_limit 512Mupload_max_filesize和post_max_size要一起改后者不能小于前者。max_execution_time给大文件上传留时间太小会中途断。Nginx 侧还要加client_max_body_size 2048m;否则 Nginx 先拦下来PHP 根本没机会处理。3.3 安装向导与管理员初始化第一次登录要做什么浏览器访问站点域名进入安装向导依次填数据库信息、管理员邮箱和密码、站点 URL。安装完成后用管理员账号登录后台。第一件事是进「存储策略」确认默认本地存储路径再进「用户组」看默认容量和权限。# 安装完成后检查关键目录和配置文件是否生成 ls -la /www/wwwroot/cloudreve/ # 确认 config 目录和 uploads 目录存在且可写 ls -ld /www/wwwroot/cloudreve/uploads安装向导会生成配置文件如果卡在某一步先看uploads是否可写、数据库是否连得上。安装完建议立刻改后台默认路径、关掉安装入口删掉 install 相关文件或按官方说明锁定避免被人重装。4. 文件共享传输链路验证上传、下载、分享怎么测4.1 本地上传与对象存储存储策略怎么选Cloudreve 支持本地存储和对象存储如 S3 兼容、阿里云 OSS、腾讯云 COS 等。个人小规模用本地存储最省事数据在自己盘上。要扩容或做 CDN 加速就接对象存储。本地存储配置在后台「存储策略」里填上传路径、访问域名。对象存储要填 Endpoint、Bucket、AccessKey、SecretKey。选型上本地存储读写走服务器磁盘速度受磁盘和带宽限制对象存储走外网省服务器磁盘但有流量费。我一般先用本地存储跑通确认功能没问题再按需切对象存储。# 本地存储时确认上传目录磁盘空间和权限 df -h /www/data # 测试写入 sudo -u www touch /www/data/cloudreve/test.txt echo okdf -h看磁盘余量sudo -u www touch用运行用户测试写入能创建说明权限没问题。如果上传报错先看这里再看 PHP 错误日志。4.2 分享链接与权限外链怎么发、有效期怎么设Cloudreve 的分享功能是核心。后台上传文件后右键或操作栏点分享生成分享链接可设提取码、有效期、下载权限。分享链接走伪静态路由所以前面 Nginx 规则必须对否则分享页 404。验证分享链路用无痕窗口打开分享链接输入提取码下载文件确认能下完且文件完整。如果分享页能开但下载失败多半是存储策略的访问域名或权限问题如果分享页 404回去查伪静态。注意分享链接的访问域名要和站点域名一致换域名后旧分享链接会失效迁移前先通知使用者。4.3 WebDAV 与离线下载进阶功能的开启条件WebDAV 让 Cloudreve 能挂载到本地文件管理器像本地盘一样用。后台开启 WebDAV记下地址和账号密码用系统自带映射或第三方客户端连。离线下载依赖服务器能访问目标资源且要装对应组件不是所有环境都能开。# 测试 WebDAV 是否可达替换为你的地址和账号 curl -u 用户名:密码 -X PROPFIND https://你的域名/dav/ -H Depth: 1curl发 PROPFIND 请求返回 207 或多行 XML 说明 WebDAV 通了。返回 401 是账号密码错404 是路径或伪静态问题。离线下载如果开不了先确认服务器出网正常、相关扩展已装再查后台任务日志。5. 避坑与排查搭 Cloudreve 最常见的 5 个翻车点5.1 安装页 404 或白屏现象访问域名进不了安装向导404 或空白。原因伪静态没配或 PHP 没跑起来。解决先确认 Nginx 伪静态规则已加再确认 PHP-FPM 在运行、socket 路径对。看 Nginx 错误日志和 PHP 错误日志白屏多半是 PHP 报错被吞了开display_errors临时看。5.2 上传大文件失败或中断现象小文件能传大文件传到一半失败。原因PHP 的upload_max_filesize、post_max_size或 Nginx 的client_max_body_size太小。解决三处一起改大改完重启 PHP-FPM 和 Nginx。还要看max_execution_time太小会超时。5.3 中文文件名乱码现象上传中文名文件后显示乱码。原因数据库字符集不是 utf8mb4或连接字符集不对。解决建库时就用 utf8mb4已建错的导出重建成 utf8mb4 再导入。程序侧一般不用改问题多在库。5.4 分享链接打不开或下载 403现象分享页能开点下载 403 或失败。原因存储策略的访问域名不对或上传目录权限不足。解决核对存储策略里的访问域名和实际域名一致检查 uploads 目录属主和权限用运行用户测试写入。5.5 磁盘满导致服务异常现象用一段时间后上传失败、页面报错。原因数据盘或系统盘满。解决df -h看哪个盘满清理日志和临时文件把上传目录迁到独立数据盘。平时设监控别等满了才发现。6. 进阶技巧用反向代理加 HTTPS 把私有云盘收尾跑通之后最后一步是让它能安全对外用。核心是 HTTPS 和反向代理。用宝塔的话站点设置里一键申请 Lets Encrypt 证书开强制 HTTPS。纯命令行用 certbot# 用 certbot 为 Nginx 申请证书替换域名 sudo apt install -y certbot python3-certbot-nginx sudo certbot --nginx -d 你的域名 # 自动续期测试 sudo certbot renew --dry-runcertbot --nginx会自动改 Nginx 配置加证书和跳转renew --dry-run测试续期是否正常。证书有了登录和传输才不会被明文嗅探。反向代理场景比如前面还有一层网关要确保X-Forwarded-For和X-Forwarded-Proto传下去否则程序拿到的协议是 http可能跳转异常。再给一个我常用的验证清单搭完照着过一遍检查项命令或操作预期PHP 扩展php -m所需扩展都在伪静态访问分享页正常打开上传传 100M 文件成功且完整下载下载刚传的文件校验一致HTTPS浏览器看锁标有效证书续期certbot renew --dry-run成功我自己的习惯是每搭一套新环境先把这份清单跑一遍再交付能省掉后面一堆「玄学」问题。Cloudreve 这套源码胜在轻量和够用个人和小团队自建文件共享完全撑得住关键是把环境、权限、伪静态这三块一次配对后面基本不用怎么管。希望帮到你。本文还有配套的精品资源点击获取