nextcloud 可直接以 s3 兼容对象存储为主存储，需通过 docker 环境变量（如 objectstore_s3_bucket、host、key、secret）或 config.php 硬编码配置，禁用本地磁盘；迁移需停服并同步 data/ 目录结构至桶内。
直接在 Nextcloud 后端对接 S3 对象存储，核心是绕过本地磁盘，让所有用户文件统一写入 S3 兼容的存储服务（如 AWS S3、腾讯云 COS、雨云 ROS、Ceph RGW 或自建 Garage）。这不是“挂载外部存储”，而是把 S3 当作主存储（primary storage），需通过 Docker 环境变量或配置文件深度集成。
S3 作为主存储：Docker 环境变量配置法
这是最简洁、生产推荐的方式，适用于 nextcloud/all-in-one 或自定义 Docker Compose 部署：
-
必须设置的 4 个基础变量：
OBJECTSTORE_S3_BUCKET（桶名）、OBJECTSTORE_S3_HOST（S3 接口地址，如s3.ap-southeast-1.amazonaws.com或cos.ap-beijing.myqcloud.com）、OBJECTSTORE_S3_KEY（AK）、OBJECTSTORE_S3_SECRET（SK） -
强烈建议补充的变量：
OBJECTSTORE_S3_REGION（区域标识，影响签名和路由）、OBJECTSTORE_S3_SSL=true（强制 HTTPS）、OBJECTSTORE_S3_PORT=443（默认端口） -
注意兼容性细节：部分国产对象存储（如 COS、ROS）需关闭 V4 签名或显式指定
OBJECTSTORE_S3_USE_PATH_STYLE=true，否则会报 403 或 404
启用 External storage support 插件（仅用于外部挂载，非主存储）
如果你只是想把 S3 当作“额外网盘”挂在个人首页（比如 /s3-backup 目录），而非替换全部存储，则走插件路径：
- 进入 Nextcloud 管理后台 → 应用 → 已禁用的应用 → 启用 External storage support
- 进入个人设置 → 外部存储 → 添加存储 → 类型选 Amazon S3 → 填入桶名、Access Key、Secret Key、Region、Endpoint（含协议和端口）
- 首次保存可能报错；若用 Ceph RGW 或自建 Garage，需提前在对象网关中手动创建对应 bucket，并确认该用户有
read/write权限
配置文件硬编码方式（适合非 Docker 部署）
若你用源码或 LAMP 方式部署 Nextcloud，需手动编辑 PHP 配置文件：
- 编辑
config/config.php，在'objectstore' => [...]段落填入完整 S3 参数（参考官方文档s3.config.php结构） - 关键字段包括：
'class' => '\OC\ObjectStore\S3'、'arguments' => [...]，其中'bucket'、'hostname'、'key'、'secret'、'region'、'use_ssl'、'path_style'、'version' => 'latest' - 修改后务必检查 Web 服务器对
config/目录的读取权限，并重启 PHP-FPM 或 Apache
迁移已有数据需谨慎
将运行中的 Nextcloud 切换到 S3 主存储，不是简单改配置就能生效：
- 新部署推荐直接使用 S3 配置启动，避免迁移风险
- 旧实例迁移需先停服务，用
occ files:scan --all确保元数据一致，再用rsync或aws s3 sync把data/下各用户目录上传至 S3 桶根路径（结构需严格匹配bucket/userid/files/...） - 迁移后首次访问可能较慢——Nextcloud 会按需重建文件缓存和缩略图
