Nextcloud 搭建个人网盘教程：对接对象存储扩展容量

摘要

Nextcloud 是成熟的开源网盘程序，支持文件同步、在线预览、日历联系人和多端客户端，适合个人和小团队自建私有云盘。本文完成 Nextcloud 的部署，并把底层存储从服务器本地磁盘切换为对象存储，从而摆脱系统盘容量限制。文中包含配置选择、程序部署、存储对接、HTTPS 启用、性能调优与备份策略，同时说明本地存储和对象存储各自的适用场景。

一、本地存储还是对象存储

这是部署前需要先决定的事，它影响后续所有配置。

本地磁盘存储：文件直接放在服务器的云硬盘上。读写延迟低，配置简单，适合数据量不大、追求响应速度的场景。局限是容量受磁盘规格限制，扩容需要扩展云硬盘，且数据可靠性依赖单块磁盘。

对象存储作为后端：文件存放在对象存储中，服务器只负责运行程序逻辑。优势明显：容量不受服务器磁盘限制，可按实际用量付费；对象存储提供更高的数据持久性；服务器磁盘只需承载程序本身，规格可以选小一些。代价是文件读写要经过网络，延迟高于本地磁盘，大量小文件操作时差异更明显。

选择建议：

有一点必须提前明确：把已在使用的实例从本地存储改为对象存储，可能导致原有文件不可见。 如果是已有实例需要切换，正确做法是按对象存储方式搭建一套新实例，再把旧实例的数据迁移过去，而不是直接改配置。本文按全新部署来写。

二、配置与前置条件

Nextcloud 面向个人、家庭和中小团队，对各项资源需求不高，选择资源均衡的规格即可。

内存值得多给一些。Nextcloud 的 PHP 运行时支持内存缓存来提升性能，内存充裕时响应体验差别明显。多人使用场景建议 4 GB 起，用户数较多时可考虑 8 GB。

需要说明的是，Nextcloud 官方不支持在 Windows 环境部署服务端，会遇到文字编码等问题，请使用 Linux 系统。

数据库方面，MySQL 5.7 以上、MariaDB 10.2 以上或 PostgreSQL 都可以。SQLite 虽然能跑但性能受限，不建议在实际使用中采用。自建数据库省成本，使用云数据库则默认具备主备高可用和自动备份，运维负担更小，可按需选择。

需要放通的端口：

轻量应用服务器在实例详情页的「防火墙」页签点击「添加规则」，协议选 TCP、填入端口、策略选允许；云服务器 CVM 在安全组的「入站规则」中添加。

还需要准备一个域名并完成解析。服务器位于中国内地时，域名指向该服务器提供网站服务需要先完成 ICP 备案。

三、准备对象存储

在对象存储控制台创建一个存储桶，记录以下信息，后面配置要用：

两个要点：

存储桶权限设置为私有读写。 网盘里的文件不应该可以被公网直接访问，权限设为公有读会造成文件泄露。Nextcloud 通过密钥访问存储桶，不需要公开权限。

密钥建议使用子账号并限定权限范围。 不要直接用主账号密钥。为这个用途单独创建子账号，只授予该存储桶的读写权限，这样密钥泄露的影响范围可控。

存储桶与服务器同地域是个容易忽略的优化点。跨地域访问会走公网，既增加延迟也产生流量费用。

四、部署 Nextcloud

用 Docker Compose 部署，各组件版本关系清晰，后续升级也方便。

创建项目目录：

mkdir -p ~/apps/nextcloud && cd ~/apps/nextcloud

编写 compose.yaml：

services:
  db:
    image: mariadb:10.11
    command: --transaction-isolation=READ-COMMITTED --log-bin=ROW
    volumes:
      - db-data:/var/lib/mysql
    environment:
      MYSQL_ROOT_PASSWORD: 改成强密码
      MYSQL_PASSWORD: 改成强密码
      MYSQL_DATABASE: nextcloud
      MYSQL_USER: nextcloud
    restart: unless-stopped

  redis:
    image: redis:7-alpine
    command: redis-server --requirepass 改成强密码
    volumes:
      - redis-data:/data
    restart: unless-stopped

  app:
    image: nextcloud:29-apache
    ports:
      - "8080:80"
    volumes:
      - nc-data:/var/www/html
    environment:
      MYSQL_HOST: db
      MYSQL_DATABASE: nextcloud
      MYSQL_USER: nextcloud
      MYSQL_PASSWORD: 与上面保持一致
      REDIS_HOST: redis
      REDIS_HOST_PASSWORD: 与上面保持一致
      PHP_MEMORY_LIMIT: 1G
      PHP_UPLOAD_LIMIT: 10G
    depends_on:
      - db
      - redis
    restart: unless-stopped

volumes:
  db-data:
  redis-data:
  nc-data:

几处配置的作用：

• MYSQL_HOST: db 用的是容器服务名。填 localhost 或 127.0.0.1 连不上，因为在容器内这些地址指向容器自身。
• PHP_UPLOAD_LIMIT 决定单文件上传上限。默认值偏小时，上传大文件会失败。这个值要和后面反向代理的请求体大小限制一起放宽，只改一处不生效。
• 镜像标签固定了主版本号。不要用 latest，Nextcloud 跨大版本升级有约束，版本失控容易出问题。

启动服务：

docker compose up -d
docker compose ps

所有容器状态为 running 后，访问 http://服务器IP:8080 进入安装向导，创建管理员账号。数据库信息通常已通过环境变量自动填好。

五、配置对象存储为主存储

这一步要在完成初始安装、但尚未上传任何文件时进行。

进入应用配置文件所在位置：

docker compose exec app bash
cd /var/www/html/config

编辑 config.php，在配置数组中加入对象存储相关设置。以 S3 兼容协议对接为例：

'objectstore' => array(
    'class' => '\\OC\\Files\\ObjectStore\\S3',
    'arguments' => array(
        'bucket'   => '你的存储桶名称',
        'key'      => '你的密钥ID',
        'secret'   => '你的密钥Key',
        'hostname' => '存储桶的访问域名',
        'region'   => '存储桶所属地域',
        'use_ssl'  => true,
        'use_path_style' => false,
    ),
),

具体参数名称与取值格式，请以对象存储的 S3 兼容协议文档为准，不同服务的地域标识和域名格式存在差异。

修改后退出容器并重启应用：

exit
docker compose restart app

验证是否生效：登录 Nextcloud 网页端上传一个测试文件，然后到对象存储控制台查看存储桶，应该能看到新增的对象。注意 Nextcloud 存入的对象名是内部标识而非原始文件名，这是正常的——文件名和目录结构保存在数据库中，对象存储只存内容。

如果上传后存储桶里没有新对象，检查应用日志：

docker compose logs app --tail 100

常见原因是密钥权限不足、域名或地域填写有误、存储桶名称不匹配。

六、配置域名与 HTTPS

先在域名服务商处添加 A 记录指向服务器公网 IP，解析生效后验证：

dig +short pan.example.com

返回 IP 与服务器公网 IP 一致后，配置反向代理。以 Caddy 为例：

pan.example.com {
    reverse_proxy 127.0.0.1:8080 {
        header_up X-Real-IP {remote_host}
    }
    request_body {
        max_size 10GB
    }
}

request_body max_size 必须按实际上传需求设置。这一项与前面 PHP_UPLOAD_LIMIT 要配套，两处取较小值生效。上传大文件返回 413 时，通常就是这里没放开。

配置完成后，还要告诉 Nextcloud 它的对外访问地址，否则会提示访问来源不受信任。编辑 config.php：

'trusted_domains' => array(
    0 => 'pan.example.com',
),
'overwrite.cli.url' => 'https://pan.example.com',
'overwriteprotocol' => 'https',

overwriteprotocol 这一项在使用反向代理时必须设置，否则程序生成的链接会是 http 开头，导致浏览器混合内容告警和部分功能异常。

重启应用使配置生效。

七、验证部署是否成功

逐项确认：

网页端可通过 HTTPS 访问

curl -I https://pan.example.com

应返回 200 或 302，无证书告警。

文件上传下载正常：上传一个文件，刷新后能看到，下载后内容完整。

对象存储确实在工作：在对象存储控制台确认存储桶中出现了新对象。这一步验证了存储后端真的生效，而不是文件仍在写本地磁盘。

大文件上传通过：上传一个接近上限的大文件。小文件测试完全不会暴露大小限制问题，这一项必须单独验证。

客户端同步可用：在电脑或手机上安装 Nextcloud 客户端，填入域名和账号，确认能登录并同步。移动端还可以验证照片自动备份功能。

后台检查项无严重告警：登录管理后台的概览页面，查看系统自检结果。会列出缺失的推荐配置项，逐条处理能提升性能和安全性。

八、性能优化

启用内存缓存

Nextcloud 支持把重复的数据库查询结果缓存到内存。在 config.php 中配置本地缓存和分布式缓存：

'memcache.local' => '\\OC\\Memcache\\APCu',
'memcache.distributed' => '\\OC\\Memcache\\Redis',
'memcache.locking' => '\\OC\\Memcache\\Redis',
'redis' => array(
    'host' => 'redis',
    'port' => 6379,
    'password' => '与 compose 中一致',
),

文件锁定使用 Redis 很重要。多客户端同时同步时，缺少分布式锁会出现文件冲突。

配置后台任务

Nextcloud 有一批定期任务需要执行。默认的网页触发方式不可靠，建议改用系统定时任务：

sudo crontab -e

*/5 * * * * docker compose -f /home/用户名/apps/nextcloud/compose.yaml exec -T -u www-data app php cron.php

在管理后台的基本设置中把后台任务方式改为 Cron。

其他调优点

• 调大 PHP 内存上限，处理大文件和预览生成时更从容。
• 关闭不使用的应用，减少每次请求的加载开销。
• 预览图生成较耗资源，可限制生成尺寸的种类。
• 数据库定期优化，用户和文件数量多时效果明显。

九、常见问题与排查

提示访问来源不受信任

域名未加入 trusted_domains。编辑 config.php 补充后重启。

上传大文件失败或返回 413

三处都要检查：反向代理的请求体大小限制、PHP 的上传大小限制、Nextcloud 自身设置。取值最小的那一处决定实际上限。

页面样式错乱或链接指向 http

确认 overwriteprotocol 已设为 https，overwrite.cli.url 已设为完整的 https 地址。

文件上传后对象存储中没有新对象

对象存储配置未生效。检查密钥权限、存储桶名称、访问域名和地域标识，并查看应用日志中的具体报错。

同步客户端反复冲突

多为文件锁定未配置分布式锁所致。确认 memcache.locking 已指向 Redis。

响应缓慢

先确认内存缓存已启用，这是影响最大的单项。再检查是否配置了系统定时任务——后台任务堆积会拖慢整体响应。使用对象存储时，跨地域访问也会带来额外延迟，确认存储桶与服务器同地域。

数据库连接失败

容器化部署时数据库主机应填容器服务名。同时确认数据库容器处于运行状态，以及密码与配置一致。

十、备份与维护

备份要覆盖三部分

数据库和配置文件必须自己备份。用了对象存储后，文件本体的可靠性由对象存储保障，但数据库丢失会导致所有文件失去索引——对象还在，却不知道哪个对象对应哪个文件。所以数据库备份优先级最高。

数据库备份示例：

docker compose exec -T db \
  mysqldump -u nextcloud -p密码 nextcloud | gzip > ~/nc-db-$(date +%Y%m%d).sql.gz

写成脚本加入定时任务，并把备份文件同步到对象存储，不要只留在本机。

恢复演练不能省

备份能生成不代表能恢复。首次配置完成后做一次完整恢复演练：用备份的数据库和配置在另一个环境还原，确认文件列表正常、能下载文件。之后每隔一段时间抽查一次。

变更前创建快照

升级 Nextcloud 大版本、调整存储配置前，给实例创建一份快照。轻量应用服务器在实例详情页的「快照」页签操作，通常 5 分钟内完成且无需关机。回滚会把整块系统盘恢复到快照时间点，之后写入的数据会被清除，运行中的实例会自动关机。每个地域的免费快照配额有上限，使用存储型套餐的实例不支持创建快照。

升级要按版本顺序

Nextcloud 不支持跨多个大版本直接升级，需要逐版本进行。升级前先阅读版本说明，确认应用兼容性，并完成备份。

日常检查

• 每周确认备份任务执行成功。
• 关注管理后台的自检告警，逐项处理。
• 检查对象存储用量和费用趋势。
• 留意磁盘剩余空间，数据库和预览图缓存会持续增长。

内容合规

上传到网盘的内容必须是你有权保存和传播的。用于多人共享时，注意不要传播未获授权的第三方作品，也不要在其中存放他人的个人敏感信息。

部署完成后，如果还想把图床、相册等服务的存储也统一到对象存储，或需要为多个自建服务配置统一的域名入口，可以作为下一步方向。

存储扩展方面，对象存储 COS 提供高持久性和按量计费，配合网盘场景可以摆脱本地磁盘容量限制；运行程序本身的机器，个人和小团队用轻量应用服务器较为省心，需要灵活调整规格时可选择云服务器 CVM。