私有镜像同步路径由镜像服务端（如Satis、Private Packagist、Toran Proxy）自身配置控制，与Composer客户端无关；客户端仅通过HTTP下载，不参与同步。
私有镜像同步路径由谁控制？
Composer 本身不提供“同步路径”的配置项，composer install 或 composer update 时下载的包默认解压到 vendor/ 目录下，这个路径由 Composer 的安装逻辑硬编码决定，不能通过镜像配置修改。所谓“自定义私有镜像同步路径”，实际是混淆了两个概念：镜像源（下载地址）和本地安装路径。
想改 vendor 目录位置？用 COMPOSER_VENDOR_DIR 环境变量
如果你真正想做的是把 vendor 目录挪到别处（比如项目外统一管理、或挂载到 SSD），那不是镜像的事，而是 Composer 的安装行为控制：
- 设置环境变量：
COMPOSER_VENDOR_DIR=/path/to/your/vendor，再运行composer install - 也可以写进
composer.json："config": { "vendor-dir": "/absolute/path/to/vendor" }（注意必须是绝对路径，相对路径会被忽略） - 该配置只影响当前项目，不会改变镜像源的任何行为
私有镜像本身要不要同步文件？看你是用哪种方案
如果你在搭建私有镜像（如 Satis、Private Packagist、Toran Proxy），它们的“同步”指的是从 packagist.org 或 GitHub 拉取元数据和 ZIP 包并缓存到本地磁盘——这个缓存路径才是可配的，但和 Composer 客户端无关：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- Satis：在
satis.json中用"archive": { "directory": "/var/www/satis/dist" }控制 ZIP 存放位置 - Private Packagist：后台有「Storage」设置页，指定 NFS/S3/本地路径
- Toran Proxy：配置文件
toran.json中"cache_dir"和"dist_dir"分别控制元数据与 ZIP 缓存路径 - 这些路径只影响服务端存储，客户端
composer install仍走 HTTP 下载，不受影响
常见误操作和报错提示
很多人试过在 repositories 里加 "url": "file:///some/path" 想直接读本地目录，结果遇到：
-
Could not fetch packages from 'file://' repository: file:// URLs are not supported for security reasons—— Composer 1.10+ 默认禁用file://协议，除非加--prefer-source且配置"secure-http": false - 即使绕过限制，
file://源也无法触发“同步”，它只是让 Composer 去读一个已存在的packages.json，所有包仍需手动准备 - 用
path类型仓库时，路径必须是相对于composer.json的相对路径，且目标目录下必须有合法的composer.json，否则报Could not parse version constraint
真正需要“同步路径”的人，往往其实没分清服务端缓存和客户端安装——先确认你是在配镜像服务，还是在跑 composer 命令，这两者路径配置完全不在一个地方。
