1. 为什么要在 CentOS 7 上折腾一个私有网盘把文件放在别人的服务器上这件事本身没什么问题问题出在你对那份文件没有任何物理层面的掌控权。限速、容量墙、分享链接突然失效、某天打开发现文件被判定违规无法下载——这些场景只要遇到一次就会让人认真考虑自建存储这件事。Cloudreve 是我这几年用得比较顺手的一个选择它本身是一套用 Go 写的网盘系统支持本地存储、对象存储对接、多用户管理、离线下载、WebDAV 挂载前端界面也做得足够清爽关键是部署门槛不高一台 1 核 2G 的入门机器就能跑起来。CentOS 7 虽然已经进入维护末期但大量存量服务器、内网机器、公司测试环境仍然跑着它所以在 CentOS 7 上把 Cloudreve 跑稳依然是一个有现实需求的问题。这篇文章面向的是手上有台 CentOS 7 机器、想给自己或小团队搭一个文件中转站的人不管你是刚接触 Linux 的新手还是已经用过宝塔、LNMP 一类面板的老手都能从里面找到能直接抄的步骤。我会把整个流程拆成几个真实环节环境准备、数据库选型、Cloudreve 本体部署、反向代理与 HTTPS、开机自启与进程守护、以及上线之后最容易踩的那几个坑。每一步我都会说清楚为什么这么做而不是甩一堆命令让你照敲。因为自建网盘这件事命令谁都能复制真正让人卡住的往往是权限、端口、SELinux、反向代理配置这些细节。先说清楚一个前提本文所有操作都在一台干净的 CentOS 7 机器上完成假设你已经拿到 root 权限或者能 sudo 的账号并且机器能正常联网。如果你用的是内网机器需要提前把 yum 源配好否则后面装依赖会一直报错。2. 动手之前先把地基打牢系统环境与依赖梳理2.1 确认系统版本和基础工具是否齐全很多人一上来就下载 Cloudreve 二进制文件结果解压的时候发现没有 unzip装数据库的时候发现没有 wget来回折腾。所以第一步不是装网盘而是把基础工具补齐。先确认系统版本cat /etc/redhat-release uname -r正常应该看到类似CentOS Linux release 7.9.2009 (Core)的输出。接着把常用工具一次性装好yum install -y wget curl unzip vim net-tools lsof这里我特意把lsof和net-tools加进去因为后面排查端口占用、查看进程监听状态时会频繁用到。net-tools提供netstat虽然现在推荐用ss但很多人的肌肉记忆还是netstat装上不亏。2.2 时间同步这件事别偷懒CentOS 7 默认可能没有开启时间同步机器时间漂移会导致 HTTPS 证书校验失败、数据库连接异常、日志时间错乱。装一个 chrony 并启动yum install -y chrony systemctl enable chronyd systemctl start chronyd chronyc sources -v看到^*开头的行说明已经同步上了。这一步看起来和网盘没关系但后面配 HTTPS 的时候如果系统时间偏差太大证书验证会直接失败到时候你会以为是配置写错了其实是时间的问题。2.3 防火墙与 SELinux 的处理策略这是 CentOS 7 上最容易让人抓狂的两个东西。我的建议是防火墙按需开放端口SELinux 不要直接关而是用正确的方式处理。先说防火墙。Cloudreve 默认监听 5212 端口如果你后面要用 Nginx 反代还需要开放 80 和 443firewall-cmd --permanent --add-port5212/tcp firewall-cmd --permanent --add-servicehttp firewall-cmd --permanent --add-servicehttps firewall-cmd --reload firewall-cmd --list-all再说 SELinux。网上大量教程让你setenforce 0然后改配置文件永久关闭我不推荐这么做因为关掉 SELinux 等于放弃了一层安全防护而且有些生产环境不允许。正确的做法是让 Nginx 有权限访问后端端口setsebool -P httpd_can_network_connect 1这一条命令解决的就是Nginx 反代到 5212 端口返回 502的经典问题。如果你不设置这个布尔值SELinux 会默默拦掉 Nginx 发往后端的连接日志里还不一定写得清楚排查起来非常费劲。提示如果你确实因为某些特殊原因需要临时关闭 SELinux 做对比测试用setenforce 0临时生效即可测完记得setenforce 1恢复不要动/etc/selinux/config。2.4 创建专用运行用户不要让 Cloudreve 以 root 身份跑。创建一个独立的系统用户把程序和数据都放在这个用户的家目录或者一个专门的目录下useradd -r -m -d /opt/cloudreve -s /sbin/nologin cloudreve-r表示创建系统用户-s /sbin/nologin表示这个用户不能登录 shell纯粹用来跑服务。这样即使程序被攻破攻击者拿到的也只是一个低权限账号不会直接威胁整台机器。3. 数据库怎么选SQLite、MySQL 还是 PostgreSQL3.1 三种方案的适用场景对比Cloudreve 支持 SQLite、MySQL、PostgreSQL 三种数据库。很多人纠结选哪个其实答案取决于你的使用规模。我把三者的差异整理成一张表数据库优点缺点适合场景SQLite零配置单文件备份就是复制文件并发写入弱多用户同时操作易锁表个人使用、1-3 人小团队MySQL生态成熟性能稳定运维资料多需要单独安装配置占内存10 人以上、需要稳定并发PostgreSQL功能强大事务严谨配置相对复杂社区中文资料略少对数据一致性要求高的场景我的经验是如果你只是自己用或者两三个人共享SQLite 完全够用而且省去了装数据库的麻烦。Cloudreve 默认就是 SQLite开箱即用。但如果你打算给一个十几人的小团队用或者要开离线下载、多任务并发那还是老老实实上 MySQL。3.2 MySQL 的安装与初始化这里以 MySQL 5.7 为例CentOS 7 的 yum 源里默认是 MariaDB需要额外加 MySQL 官方源。先下载并安装源wget https://dev.mysql.com/get/mysql57-community-release-el7-11.noarch.rpm rpm -ivh mysql57-community-release-el7-11.noarch.rpm yum install -y mysql-community-server systemctl enable mysqld systemctl start mysqldMySQL 5.7 首次启动会生成一个临时 root 密码用下面这条命令找出来grep temporary password /var/log/mysqld.log拿到密码后登录并修改mysql -uroot -p ALTER USER rootlocalhost IDENTIFIED BY 你的强密码;然后创建 Cloudreve 专用的数据库和用户。这里有个细节不要用 root 账号连 Cloudreve单独建一个只对特定库有权限的账号CREATE DATABASE cloudreve CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; CREATE USER cloudrevelocalhost IDENTIFIED BY 另一个强密码; GRANT ALL PRIVILEGES ON cloudreve.* TO cloudrevelocalhost; FLUSH PRIVILEGES;字符集一定要用utf8mb4不要用utf8。因为utf8在 MySQL 里其实是不完整的实现存不了 emoji 和部分生僻字网盘里存文件名很容易遇到这类字符用错了后面会出现乱码或者插入失败。3.3 数据库连接参数的填写位置Cloudreve 第一次启动时会自动生成conf.ini配置文件数据库信息就填在里面。如果你用的是 SQLite这一节可以跳过如果用 MySQL等程序首次运行生成配置后再修改conf.ini的[Database]段[Database] Type mysql User cloudreve Password 另一个强密码 Host 127.0.0.1 Name cloudreve Port 3306注意Host写127.0.0.1而不是localhost因为 MySQL 客户端在解析localhost时可能走 socket 连接而 Cloudreve 走的是 TCP写 IP 更明确能避免一些连接上的玄学问题。4. 部署 Cloudreve 本体从下载到首次启动4.1 选对版本和下载方式Cloudreve 的发布包在它的 GitHub Releases 页面下载前先确认机器架构uname -m输出x86_64就下 amd64 版本输出aarch64就下 arm64 版本。以 amd64 为例cd /opt/cloudreve wget https://github.com/cloudreve/Cloudreve/releases/download/3.8.3/cloudreve_3.8.3_linux_amd64.tar.gz tar -zxvf cloudreve_3.8.3_linux_amd64.tar.gz chmod x cloudreve chown -R cloudreve:cloudreve /opt/cloudreve版本号请以官方最新发布为准我这里写的 3.8.3 只是举例。下载慢的话可以先用浏览器下好再传到服务器上不必死磕命令行。4.2 首次启动与初始管理员账号第一次启动必须用 cloudreve 用户身份否则生成的文件属主会变成 root后面权限会乱su -s /bin/bash cloudreve cd /opt/cloudreve ./cloudreve启动成功后终端会打印出初始管理员账号和密码类似Admin user name: admincloudreve.org Admin password: xxxxxxxx这个密码只显示一次务必立刻记下来。同时程序会在当前目录生成conf.ini和cloudreve.db如果用 SQLite。看到监听 5212 端口的提示后按 CtrlC 先停掉因为我们要把它做成系统服务而不是挂在终端里跑。4.3 用 systemd 托管进程把 Cloudreve 做成 systemd 服务好处是开机自启、崩溃自动重启、日志统一管理。创建服务文件vim /etc/systemd/system/cloudreve.service内容如下[Unit] DescriptionCloudreve Documentationhttps://docs.cloudreve.org Afternetwork.target Aftermysqld.service Wantsnetwork.target [Service] Usercloudreve Groupcloudreve WorkingDirectory/opt/cloudreve ExecStart/opt/cloudreve/cloudreve Restarton-abnormal RestartSec5s StandardOutputjournal StandardErrorjournal [Install] WantedBymulti-user.target几个关键点解释一下Aftermysqld.service保证数据库先起来再启动网盘避免连接失败Restarton-abnormal表示只有异常退出才重启正常停止不重启WorkingDirectory必须设对因为 Cloudreve 会在工作目录下找conf.ini和存数据。重载并启动systemctl daemon-reload systemctl enable cloudreve systemctl start cloudreve systemctl status cloudreve看到active (running)就说明起来了。这时候用ss -tlnp | grep 5212应该能看到监听状态。5. 反向代理与 HTTPS让访问地址体面起来5.1 为什么一定要上 Nginx 反代直接访问http://你的IP:5212也能用但有两个问题一是端口号难看二是没有 HTTPS登录密码在网络上裸奔。用 Nginx 反代到 80/443既能隐藏后端端口又能挂证书还能顺便做限速、防盗链、访问日志分析。这一步不是可选项是必选项。安装 Nginxyum install -y epel-release yum install -y nginx systemctl enable nginx5.2 反代配置的关键参数创建站点配置vim /etc/nginx/conf.d/cloudreve.conf内容如下server { listen 80; server_name pan.example.com; return 301 https://$server_name$request_uri; } server { listen 443 ssl http2; server_name pan.example.com; ssl_certificate /etc/nginx/ssl/pan.example.com.crt; ssl_certificate_key /etc/nginx/ssl/pan.example.com.key; ssl_protocols TLSv1.2 TLSv1.3; ssl_ciphers HIGH:!aNULL:!MD5; client_max_body_size 2048m; location / { proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header Host $http_host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-Proto $scheme; proxy_redirect off; proxy_pass http://127.0.0.1:5212; } }这里有几个参数是踩过坑才知道要加的。client_max_body_size默认只有 1M不改的话上传稍大一点的文件直接返回 413很多人以为是 Cloudreve 的问题其实是 Nginx 拦的。X-Forwarded-Proto要传否则 Cloudreve 生成分享链接时可能拼成 http 开头导致混合内容警告。proxy_set_header Host $http_host保留原始 HostCloudreve 靠它判断站点地址。5.3 证书获取与自动续期证书可以用 Lets Encrypt 免费申请用 certbot 最省事yum install -y certbot python2-certbot-nginx certbot --nginx -d pan.example.comcertbot 会自动改 Nginx 配置并配置续期定时任务。验证续期是否正常certbot renew --dry-run看到 Congratulations, all renewals succeeded 就放心了。证书 90 天过期自动续期一定要测不然某天早上打开网站发现证书过期浏览器一片红。注意申请证书需要域名已经解析到这台机器的公网 IP并且 80 端口能从外网访问。内网机器没法用这种方式只能自签证书或者用内网 CA自签证书浏览器会报警告这是正常的。6. 上线之后最容易踩的五个坑6.1 上传大文件失败先查 Nginx 再查 PHPCloudreve 是 Go 程序不依赖 PHP所以上传限制只可能来自两处Nginx 的client_max_body_size和 Cloudreve 后台的上传大小限制。前者改配置文件后者在管理面板的参数设置-上传里改。两个都放开之后还要注意磁盘剩余空间df -h看一眼别文件传一半磁盘满了。6.2 502 Bad Gateway 的排查顺序遇到 502按这个顺序查先systemctl status cloudreve看后端是否活着再ss -tlnp | grep 5212看端口是否监听然后getenforce看 SELinux 是否拦了 Nginx 的连接前面说的setsebool就是治这个最后看/var/log/nginx/error.log里的具体报错。这四步走完90% 的 502 都能定位。6.3 数据备份到底该备份什么很多人以为备份cloudreve.db就够了其实不够。完整的备份对象包括数据库文件SQLite 的.db或 MySQL 的 dump、conf.ini配置文件、uploads目录本地存储的文件、以及avatar头像目录。少备份一个恢复的时候就会缺东西。我习惯写个脚本每天凌晨打包一次保留最近 7 天#!/bin/bash DATE$(date %Y%m%d) tar -zcf /backup/cloudreve_$DATE.tar.gz /opt/cloudreve/uploads /opt/cloudreve/conf.ini /opt/cloudreve/cloudreve.db find /backup -name cloudreve_*.tar.gz -mtime 7 -delete6.4 忘记管理员密码怎么办Cloudreve 提供了命令行重置工具cd /opt/cloudreve ./cloudreve --database-script ResetAdminPassword执行后会输出新的随机密码。这个命令要在服务停止的状态下跑否则数据库可能被占用。跑完记得重启服务。6.5 离线下载功能为什么用不了Cloudreve 的离线下载依赖 Aria2需要单独部署一个 Aria2 服务然后在 Cloudreve 后台配置 RPC 地址和密钥。很多人以为装完 Cloudreve 就自带离线下载其实不是。Aria2 的配置涉及 RPC 监听、密钥、目录映射是另一个独立话题建议单独找时间折腾不要和主部署混在一起做否则出问题不好定位。7. 性能调优与长期维护的几点经验7.1 小内存机器的优化思路1 核 1G 的机器跑 Cloudreve 是能跑的但要关掉一些不必要的东西。MySQL 在 1G 内存上比较吃力建议改用 SQLiteNginx 的 worker 进程数调小系统层面可以加一点 swap 兜底dd if/dev/zero of/swapfile bs1M count1024 chmod 600 /swapfile mkswap /swapfile swapon /swapfile echo /swapfile swap swap defaults 0 0 /etc/fstabswap 不是万能的但能在内存吃紧时避免进程被 OOM killer 直接干掉给排查争取时间。7.2 日志轮转别忽视systemd 托管的服务日志默认进 journal时间长了会占满磁盘。限制一下 journal 大小journalctl --vacuum-size200M vim /etc/systemd/journald.conf把SystemMaxUse设成200M然后重启 journald。Nginx 的日志也要配 logrotateCentOS 7 默认已经配好了确认一下/etc/logrotate.d/nginx存在即可。7.3 定期检查磁盘和 inode网盘类应用最怕磁盘满。除了df -h看空间还要df -i看 inode因为大量小文件会先把 inode 耗尽这时候空间还有但就是写不进去。我一般把这两条命令写进监控脚本超过 80% 就发提醒。7.4 升级 Cloudreve 的正确姿势升级前先停服务、备份数据和配置然后替换二进制文件再启动。不要直接覆盖正在运行的程序也不要在没备份的情况下升级。跨大版本升级时先看官方发布说明有没有数据库结构变更有的话按说明执行迁移脚本。systemctl stop cloudreve cp /opt/cloudreve/cloudreve /opt/cloudreve/cloudreve.bak # 替换新版本二进制 chown cloudreve:cloudreve /opt/cloudreve/cloudreve systemctl start cloudreve保留一份旧版本二进制万一新版本有问题可以快速回滚这个习惯救过我两次。8. 关于自建网盘这件事的一些个人体会搭一个私有网盘技术难度其实不高真正花时间的是那些边角问题证书续期、备份策略、磁盘监控、权限管理。我见过太多人兴冲冲搭好用了两个月就因为一次磁盘满或者证书过期而弃用。所以我的建议是部署只是开始把备份和监控这两件事做扎实这个网盘才能真正长期为你服务。另外Cloudreve 的定位是够用就好它不是企业级网盘不要指望它扛住几百人并发。给个人或者小团队用它非常称职规模上去了该上对象存储就上对象存储该换方案就换方案别硬撑。技术选型这件事合适比先进重要得多。
1. 为什么要在 CentOS 7 上折腾一个私有网盘把文件放在别人的服务器上这件事本身没什么问题问题出在你对那份文件没有任何物理层面的掌控权。限速、容量墙、分享链接突然失效、某天打开发现文件被判定违规无法下载——这些场景只要遇到一次就会让人认真考虑自建存储这件事。Cloudreve 是我这几年用得比较顺手的一个选择它本身是一套用 Go 写的网盘系统支持本地存储、对象存储对接、多用户管理、离线下载、WebDAV 挂载前端界面也做得足够清爽关键是部署门槛不高一台 1 核 2G 的入门机器就能跑起来。CentOS 7 虽然已经进入维护末期但大量存量服务器、内网机器、公司测试环境仍然跑着它所以在 CentOS 7 上把 Cloudreve 跑稳依然是一个有现实需求的问题。这篇文章面向的是手上有台 CentOS 7 机器、想给自己或小团队搭一个文件中转站的人不管你是刚接触 Linux 的新手还是已经用过宝塔、LNMP 一类面板的老手都能从里面找到能直接抄的步骤。我会把整个流程拆成几个真实环节环境准备、数据库选型、Cloudreve 本体部署、反向代理与 HTTPS、开机自启与进程守护、以及上线之后最容易踩的那几个坑。每一步我都会说清楚为什么这么做而不是甩一堆命令让你照敲。因为自建网盘这件事命令谁都能复制真正让人卡住的往往是权限、端口、SELinux、反向代理配置这些细节。先说清楚一个前提本文所有操作都在一台干净的 CentOS 7 机器上完成假设你已经拿到 root 权限或者能 sudo 的账号并且机器能正常联网。如果你用的是内网机器需要提前把 yum 源配好否则后面装依赖会一直报错。2. 动手之前先把地基打牢系统环境与依赖梳理2.1 确认系统版本和基础工具是否齐全很多人一上来就下载 Cloudreve 二进制文件结果解压的时候发现没有 unzip装数据库的时候发现没有 wget来回折腾。所以第一步不是装网盘而是把基础工具补齐。先确认系统版本cat /etc/redhat-release uname -r正常应该看到类似CentOS Linux release 7.9.2009 (Core)的输出。接着把常用工具一次性装好yum install -y wget curl unzip vim net-tools lsof这里我特意把lsof和net-tools加进去因为后面排查端口占用、查看进程监听状态时会频繁用到。net-tools提供netstat虽然现在推荐用ss但很多人的肌肉记忆还是netstat装上不亏。2.2 时间同步这件事别偷懒CentOS 7 默认可能没有开启时间同步机器时间漂移会导致 HTTPS 证书校验失败、数据库连接异常、日志时间错乱。装一个 chrony 并启动yum install -y chrony systemctl enable chronyd systemctl start chronyd chronyc sources -v看到^*开头的行说明已经同步上了。这一步看起来和网盘没关系但后面配 HTTPS 的时候如果系统时间偏差太大证书验证会直接失败到时候你会以为是配置写错了其实是时间的问题。2.3 防火墙与 SELinux 的处理策略这是 CentOS 7 上最容易让人抓狂的两个东西。我的建议是防火墙按需开放端口SELinux 不要直接关而是用正确的方式处理。先说防火墙。Cloudreve 默认监听 5212 端口如果你后面要用 Nginx 反代还需要开放 80 和 443firewall-cmd --permanent --add-port5212/tcp firewall-cmd --permanent --add-servicehttp firewall-cmd --permanent --add-servicehttps firewall-cmd --reload firewall-cmd --list-all再说 SELinux。网上大量教程让你setenforce 0然后改配置文件永久关闭我不推荐这么做因为关掉 SELinux 等于放弃了一层安全防护而且有些生产环境不允许。正确的做法是让 Nginx 有权限访问后端端口setsebool -P httpd_can_network_connect 1这一条命令解决的就是Nginx 反代到 5212 端口返回 502的经典问题。如果你不设置这个布尔值SELinux 会默默拦掉 Nginx 发往后端的连接日志里还不一定写得清楚排查起来非常费劲。提示如果你确实因为某些特殊原因需要临时关闭 SELinux 做对比测试用setenforce 0临时生效即可测完记得setenforce 1恢复不要动/etc/selinux/config。2.4 创建专用运行用户不要让 Cloudreve 以 root 身份跑。创建一个独立的系统用户把程序和数据都放在这个用户的家目录或者一个专门的目录下useradd -r -m -d /opt/cloudreve -s /sbin/nologin cloudreve-r表示创建系统用户-s /sbin/nologin表示这个用户不能登录 shell纯粹用来跑服务。这样即使程序被攻破攻击者拿到的也只是一个低权限账号不会直接威胁整台机器。3. 数据库怎么选SQLite、MySQL 还是 PostgreSQL3.1 三种方案的适用场景对比Cloudreve 支持 SQLite、MySQL、PostgreSQL 三种数据库。很多人纠结选哪个其实答案取决于你的使用规模。我把三者的差异整理成一张表数据库优点缺点适合场景SQLite零配置单文件备份就是复制文件并发写入弱多用户同时操作易锁表个人使用、1-3 人小团队MySQL生态成熟性能稳定运维资料多需要单独安装配置占内存10 人以上、需要稳定并发PostgreSQL功能强大事务严谨配置相对复杂社区中文资料略少对数据一致性要求高的场景我的经验是如果你只是自己用或者两三个人共享SQLite 完全够用而且省去了装数据库的麻烦。Cloudreve 默认就是 SQLite开箱即用。但如果你打算给一个十几人的小团队用或者要开离线下载、多任务并发那还是老老实实上 MySQL。3.2 MySQL 的安装与初始化这里以 MySQL 5.7 为例CentOS 7 的 yum 源里默认是 MariaDB需要额外加 MySQL 官方源。先下载并安装源wget https://dev.mysql.com/get/mysql57-community-release-el7-11.noarch.rpm rpm -ivh mysql57-community-release-el7-11.noarch.rpm yum install -y mysql-community-server systemctl enable mysqld systemctl start mysqldMySQL 5.7 首次启动会生成一个临时 root 密码用下面这条命令找出来grep temporary password /var/log/mysqld.log拿到密码后登录并修改mysql -uroot -p ALTER USER rootlocalhost IDENTIFIED BY 你的强密码;然后创建 Cloudreve 专用的数据库和用户。这里有个细节不要用 root 账号连 Cloudreve单独建一个只对特定库有权限的账号CREATE DATABASE cloudreve CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; CREATE USER cloudrevelocalhost IDENTIFIED BY 另一个强密码; GRANT ALL PRIVILEGES ON cloudreve.* TO cloudrevelocalhost; FLUSH PRIVILEGES;字符集一定要用utf8mb4不要用utf8。因为utf8在 MySQL 里其实是不完整的实现存不了 emoji 和部分生僻字网盘里存文件名很容易遇到这类字符用错了后面会出现乱码或者插入失败。3.3 数据库连接参数的填写位置Cloudreve 第一次启动时会自动生成conf.ini配置文件数据库信息就填在里面。如果你用的是 SQLite这一节可以跳过如果用 MySQL等程序首次运行生成配置后再修改conf.ini的[Database]段[Database] Type mysql User cloudreve Password 另一个强密码 Host 127.0.0.1 Name cloudreve Port 3306注意Host写127.0.0.1而不是localhost因为 MySQL 客户端在解析localhost时可能走 socket 连接而 Cloudreve 走的是 TCP写 IP 更明确能避免一些连接上的玄学问题。4. 部署 Cloudreve 本体从下载到首次启动4.1 选对版本和下载方式Cloudreve 的发布包在它的 GitHub Releases 页面下载前先确认机器架构uname -m输出x86_64就下 amd64 版本输出aarch64就下 arm64 版本。以 amd64 为例cd /opt/cloudreve wget https://github.com/cloudreve/Cloudreve/releases/download/3.8.3/cloudreve_3.8.3_linux_amd64.tar.gz tar -zxvf cloudreve_3.8.3_linux_amd64.tar.gz chmod x cloudreve chown -R cloudreve:cloudreve /opt/cloudreve版本号请以官方最新发布为准我这里写的 3.8.3 只是举例。下载慢的话可以先用浏览器下好再传到服务器上不必死磕命令行。4.2 首次启动与初始管理员账号第一次启动必须用 cloudreve 用户身份否则生成的文件属主会变成 root后面权限会乱su -s /bin/bash cloudreve cd /opt/cloudreve ./cloudreve启动成功后终端会打印出初始管理员账号和密码类似Admin user name: admincloudreve.org Admin password: xxxxxxxx这个密码只显示一次务必立刻记下来。同时程序会在当前目录生成conf.ini和cloudreve.db如果用 SQLite。看到监听 5212 端口的提示后按 CtrlC 先停掉因为我们要把它做成系统服务而不是挂在终端里跑。4.3 用 systemd 托管进程把 Cloudreve 做成 systemd 服务好处是开机自启、崩溃自动重启、日志统一管理。创建服务文件vim /etc/systemd/system/cloudreve.service内容如下[Unit] DescriptionCloudreve Documentationhttps://docs.cloudreve.org Afternetwork.target Aftermysqld.service Wantsnetwork.target [Service] Usercloudreve Groupcloudreve WorkingDirectory/opt/cloudreve ExecStart/opt/cloudreve/cloudreve Restarton-abnormal RestartSec5s StandardOutputjournal StandardErrorjournal [Install] WantedBymulti-user.target几个关键点解释一下Aftermysqld.service保证数据库先起来再启动网盘避免连接失败Restarton-abnormal表示只有异常退出才重启正常停止不重启WorkingDirectory必须设对因为 Cloudreve 会在工作目录下找conf.ini和存数据。重载并启动systemctl daemon-reload systemctl enable cloudreve systemctl start cloudreve systemctl status cloudreve看到active (running)就说明起来了。这时候用ss -tlnp | grep 5212应该能看到监听状态。5. 反向代理与 HTTPS让访问地址体面起来5.1 为什么一定要上 Nginx 反代直接访问http://你的IP:5212也能用但有两个问题一是端口号难看二是没有 HTTPS登录密码在网络上裸奔。用 Nginx 反代到 80/443既能隐藏后端端口又能挂证书还能顺便做限速、防盗链、访问日志分析。这一步不是可选项是必选项。安装 Nginxyum install -y epel-release yum install -y nginx systemctl enable nginx5.2 反代配置的关键参数创建站点配置vim /etc/nginx/conf.d/cloudreve.conf内容如下server { listen 80; server_name pan.example.com; return 301 https://$server_name$request_uri; } server { listen 443 ssl http2; server_name pan.example.com; ssl_certificate /etc/nginx/ssl/pan.example.com.crt; ssl_certificate_key /etc/nginx/ssl/pan.example.com.key; ssl_protocols TLSv1.2 TLSv1.3; ssl_ciphers HIGH:!aNULL:!MD5; client_max_body_size 2048m; location / { proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header Host $http_host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-Proto $scheme; proxy_redirect off; proxy_pass http://127.0.0.1:5212; } }这里有几个参数是踩过坑才知道要加的。client_max_body_size默认只有 1M不改的话上传稍大一点的文件直接返回 413很多人以为是 Cloudreve 的问题其实是 Nginx 拦的。X-Forwarded-Proto要传否则 Cloudreve 生成分享链接时可能拼成 http 开头导致混合内容警告。proxy_set_header Host $http_host保留原始 HostCloudreve 靠它判断站点地址。5.3 证书获取与自动续期证书可以用 Lets Encrypt 免费申请用 certbot 最省事yum install -y certbot python2-certbot-nginx certbot --nginx -d pan.example.comcertbot 会自动改 Nginx 配置并配置续期定时任务。验证续期是否正常certbot renew --dry-run看到 Congratulations, all renewals succeeded 就放心了。证书 90 天过期自动续期一定要测不然某天早上打开网站发现证书过期浏览器一片红。注意申请证书需要域名已经解析到这台机器的公网 IP并且 80 端口能从外网访问。内网机器没法用这种方式只能自签证书或者用内网 CA自签证书浏览器会报警告这是正常的。6. 上线之后最容易踩的五个坑6.1 上传大文件失败先查 Nginx 再查 PHPCloudreve 是 Go 程序不依赖 PHP所以上传限制只可能来自两处Nginx 的client_max_body_size和 Cloudreve 后台的上传大小限制。前者改配置文件后者在管理面板的参数设置-上传里改。两个都放开之后还要注意磁盘剩余空间df -h看一眼别文件传一半磁盘满了。6.2 502 Bad Gateway 的排查顺序遇到 502按这个顺序查先systemctl status cloudreve看后端是否活着再ss -tlnp | grep 5212看端口是否监听然后getenforce看 SELinux 是否拦了 Nginx 的连接前面说的setsebool就是治这个最后看/var/log/nginx/error.log里的具体报错。这四步走完90% 的 502 都能定位。6.3 数据备份到底该备份什么很多人以为备份cloudreve.db就够了其实不够。完整的备份对象包括数据库文件SQLite 的.db或 MySQL 的 dump、conf.ini配置文件、uploads目录本地存储的文件、以及avatar头像目录。少备份一个恢复的时候就会缺东西。我习惯写个脚本每天凌晨打包一次保留最近 7 天#!/bin/bash DATE$(date %Y%m%d) tar -zcf /backup/cloudreve_$DATE.tar.gz /opt/cloudreve/uploads /opt/cloudreve/conf.ini /opt/cloudreve/cloudreve.db find /backup -name cloudreve_*.tar.gz -mtime 7 -delete6.4 忘记管理员密码怎么办Cloudreve 提供了命令行重置工具cd /opt/cloudreve ./cloudreve --database-script ResetAdminPassword执行后会输出新的随机密码。这个命令要在服务停止的状态下跑否则数据库可能被占用。跑完记得重启服务。6.5 离线下载功能为什么用不了Cloudreve 的离线下载依赖 Aria2需要单独部署一个 Aria2 服务然后在 Cloudreve 后台配置 RPC 地址和密钥。很多人以为装完 Cloudreve 就自带离线下载其实不是。Aria2 的配置涉及 RPC 监听、密钥、目录映射是另一个独立话题建议单独找时间折腾不要和主部署混在一起做否则出问题不好定位。7. 性能调优与长期维护的几点经验7.1 小内存机器的优化思路1 核 1G 的机器跑 Cloudreve 是能跑的但要关掉一些不必要的东西。MySQL 在 1G 内存上比较吃力建议改用 SQLiteNginx 的 worker 进程数调小系统层面可以加一点 swap 兜底dd if/dev/zero of/swapfile bs1M count1024 chmod 600 /swapfile mkswap /swapfile swapon /swapfile echo /swapfile swap swap defaults 0 0 /etc/fstabswap 不是万能的但能在内存吃紧时避免进程被 OOM killer 直接干掉给排查争取时间。7.2 日志轮转别忽视systemd 托管的服务日志默认进 journal时间长了会占满磁盘。限制一下 journal 大小journalctl --vacuum-size200M vim /etc/systemd/journald.conf把SystemMaxUse设成200M然后重启 journald。Nginx 的日志也要配 logrotateCentOS 7 默认已经配好了确认一下/etc/logrotate.d/nginx存在即可。7.3 定期检查磁盘和 inode网盘类应用最怕磁盘满。除了df -h看空间还要df -i看 inode因为大量小文件会先把 inode 耗尽这时候空间还有但就是写不进去。我一般把这两条命令写进监控脚本超过 80% 就发提醒。7.4 升级 Cloudreve 的正确姿势升级前先停服务、备份数据和配置然后替换二进制文件再启动。不要直接覆盖正在运行的程序也不要在没备份的情况下升级。跨大版本升级时先看官方发布说明有没有数据库结构变更有的话按说明执行迁移脚本。systemctl stop cloudreve cp /opt/cloudreve/cloudreve /opt/cloudreve/cloudreve.bak # 替换新版本二进制 chown cloudreve:cloudreve /opt/cloudreve/cloudreve systemctl start cloudreve保留一份旧版本二进制万一新版本有问题可以快速回滚这个习惯救过我两次。8. 关于自建网盘这件事的一些个人体会搭一个私有网盘技术难度其实不高真正花时间的是那些边角问题证书续期、备份策略、磁盘监控、权限管理。我见过太多人兴冲冲搭好用了两个月就因为一次磁盘满或者证书过期而弃用。所以我的建议是部署只是开始把备份和监控这两件事做扎实这个网盘才能真正长期为你服务。另外Cloudreve 的定位是够用就好它不是企业级网盘不要指望它扛住几百人并发。给个人或者小团队用它非常称职规模上去了该上对象存储就上对象存储该换方案就换方案别硬撑。技术选型这件事合适比先进重要得多。
