用对象存储替代本地目录是ThinkPHP 6.1分布式附件同步最稳妥轻量方案；优先选腾讯云COS或阿里云OSS，通过Storage接口统一调用，密钥存.env，严格校验文件类型，大文件分片上传，多环境隔离Bucket。
直接用对象存储替代本地目录，是解决 ThinkPHP 6.1 分布式环境下附件同步最稳妥、最轻量的方式。本地文件上传到某台服务器后，其他节点根本读不到，硬做文件同步（rsync、NFS）既不可靠又增加运维负担。对象存储天然跨服务器、高可用、带 CDN 加速，适配 TP6.1 的 SDK 也成熟稳定。
选型：优先接入腾讯云 COS 或阿里云 OSS
两者在 TP6.1 中都有官方或社区维护良好的 SDK 支持，无需自研适配层：
- 腾讯云 COS：用
qcloud/cos-sdk-v5，PHP 7.2+ 兼容性好，临时密钥 + 客户端直传方案成熟 - 阿里云 OSS：用
aliyuncs/oss-sdk-php，支持内网 Endpoint（同地域 ECS 直连不走公网），节省流量 - 避免使用 MinIO 自建——除非你有专职运维团队，否则小项目容易陷入权限、证书、版本升级等细节陷阱
代码层：统一走 Storage 接口，不写死路径
TP6.1 原生支持 think\facade\Filesystem，配合配置可无缝切换驱动：
- 在
config/filesystem.php中定义cos或oss磁盘，填入对应 access_key、secret_key、bucket、region 等 - 上传时统一用
Storage::disk('cos')->put($path, $file)，而不是move_uploaded_file()到public/uploads - URL 拼接不再拼
/uploads/xxx.jpg，而是调用Storage::disk('cos')->url($path)获取完整外链
安全与规范：绕不开的三个实操要点
很多项目卡在这几步，不是不会传，而是传得不稳、不安全、不持久：
立即学习“PHP免费学习笔记（深入）”；
-
密钥绝不硬编码：把
access_key、secret_key放进.env，通过Env::get('COS_SECRET_KEY')读取；生产环境禁用debug，防止泄露 -
文件类型白名单必须校验：前端限制只是参考，后端需严格检查 MIME 类型（如
image/jpeg）和扩展名（如.jpg），拒绝.php、.htaccess等危险后缀 -
大文件走分片上传：单文件超 20MB 时，别用普通表单 POST，改用 SDK 的
uploadPart+completeMultipartUpload流程，避免超时和内存溢出
多环境适配：开发/测试/生产用不同 Bucket
避免误删线上图片，也防止测试数据污染正式资源：
- 在
.env中按环境区分配置：COS_BUCKET=your-app-dev/COS_BUCKET=your-app-prod - Bucket 权限设为「私有读写」，所有访问 URL 都带签名（或通过 CDN 配置 Referer 白名单+防盗链）
- 开发环境可保留本地磁盘驱动（
public），但确保代码中无if (APP_ENV === 'dev')这类硬分支逻辑
