私有仓库不等于安全，需主动配置三道防线：启用gpg签名、强制https并禁用目录浏览、客户端开启元数据验证；ci中须正确注入composer_auth且校验，lock文件必须含有效shasum。
不安全是默认状态，安全需要你主动配置每一道防线。私有仓库本身不等于安全，它只是把风险从公开网络转移到了你的内网边界——而绝大多数团队在这条边界上留着敞开的门。
为什么私有仓库会成为攻击入口
私有仓库不是保险箱，而是带锁的玻璃柜：代码物理隔离了，但元数据、包文件、认证流程如果没加固，攻击者仍能通过中间人、目录遍历、凭证泄露等方式突破。2025年某电商公司被黑的真实案例就是因 composer.json 直接引用了伪造的 GitHub 仓库 URL，Composer 没做签名验证就拉下了恶意支付模块。
- 未启用元数据签名时，
packages.json可被篡改，引导 Composer 安装任意版本（包括后门包） -
repositories配置中使用"type": "vcs"且 URL 是 HTTPS 公共地址时，等同于把私有逻辑暴露在公网可索引路径下 - Nginx/Apache 配置中开启
autoindex on，会导致整个/packages目录裸奔，实习生用 curl 就能下载所有源码 - CI 环境里硬编码密码到
COMPOSER_AUTH，日志或缓存可能泄露凭证
必须启用的三项基础防护
这三项不是“建议”，是上线前必须验证的底线配置，缺一不可。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 在 Satis 构建时启用签名：
"archive": {"format": "zip", "skip-dev": true}+ 运行php bin/satis build satis.json web/ --sign，生成带 GPG 签名的packages.json - 私有仓库服务端强制 HTTPS，并关闭目录浏览：Nginx 中删除
autoindex on，添加location / { try_files $uri =404; } - 客户端启用元数据验证：项目根目录下运行
composer config -g repo.packagist.org.allow_ssl_downgrade false，并确保 PHP 的openssl扩展已启用
CI/CD 中私有认证的正确写法
环境变量注入看似简单，但 COMPOSER_AUTH 的 JSON 格式极易出错，一个逗号缺失就会让整个构建失败且无明确报错。
- 正确格式必须是单行、无换行、键名严格小写：
COMPOSER_AUTH='{"http-basic":{"packages.your-company.com":{"username":"ci","password":"xxx"}}}' - 不要在 CI 脚本里拼接 JSON，用
jq生成：echo '{"http-basic": {"'"$REPO_HOST"'": {"username": "'"$CI_USER"'", "password": "'"$CI_TOKEN"'"}}}' | jq -c - CI 流水线第一步加校验：
composer config --global --list | grep -q "http-basic" || (echo "MISSING AUTH CONFIG" >&2; exit 1) - 禁止在
composer.json里写死凭证，哪怕注释掉也不行——Git 历史不可逆，密码就永远留在那里
最容易被忽略的 lock 文件陷阱
composer.lock 不只是依赖快照，它还固化了仓库来源和签名状态。一旦你启用了 Satis 签名，但 lock 文件里没记录 "content-hash" 或 "packages" 下缺少 "dist" 的 "shasum" 字段，Composer 就会跳过校验。
每次运行 composer update 后，必须人工确认 lock 文件中每个私有包的 dist.shasum 存在且非空；CI 构建时用 composer install --dry-run 预检，比等到部署失败再排查快十倍。
