UgreenHome 共享库 CI:依赖安全扫描与内网构建复盘

背景 UgreenHome 的 iOS / Android 两端共用一个 Kotlin Multiplatform(KMP)共享库 ugreenhome-shared。随着库里引入的开源与第三方 SDK 越来越多,安全与合规团队希望能定期知道「到底用了哪些包、什么版本、有没有已知漏洞」,而不是每次发版手工对账。这就是 SCA(软件成分分析)的诉求。 SCA 的流程本身不复杂:先用 Gradle 导出依赖清单(SBOM),再用 Grype 之类的扫描器比对漏洞库,最后把结果写进内部 Wiki 并通知相关人。真正麻烦的是前面那一步——导出 SBOM 需要先完整编译,而编译机在公司内网,连不上 Google Maven、Gradle Plugin Portal 这些外网源,公共镜像又经常抽风。于是这次工作的本质,就是打通「在内网里把依赖完整解析出来」这条链路。 说明:文中提到的 MR 编号(如 !87)、Pipeline 编号(如 7190)都是内网 GitLab 的内部标识,只当作叙事锚点,外部无法访问,也不附链接。 名词解释 SBOM(Software Bill of Materials,软件物料清单):一次构建实际用到的全部依赖(含传递依赖)的清单,通常带版本与坐标,是安全扫描的比对基线。 SCA(Software Composition Analysis,软件成分分析):对 SBOM 做漏洞 / 许可证扫描的过程。 GAV:Maven 坐标 group:artifact:version,例如 androidx.fragment:fragment-ktx:1.8.0,用来唯一定位一个依赖。 Nexus:公司内网的私有仓库(Maven 代理 + 托管)。本次用到 maven-ugreenhome-release(正式包)、maven-ugreenhome-snapshot(内部 SNAPSHOT)、ugreenhome-group(聚合多个源)。 Grype:一款开源漏洞扫描 CLI,被放进 Nexus 的 raw 仓,CI 从内网下载。 seed(镜像上传):在能连外网的机器上,把 Plugin Portal / Google Maven 上的包下载并上传到 Nexus,CI 再从内网拉。 init.gradle:Gradle 启动时执行的脚本,用来统一改写「去哪个仓库找包」的优先级。 为什么 CI 里会「下包失败」 可以把 Gradle 在 CI 里的依赖来源想成三道独立的采购渠道,缺任何一道,构建都会在不同阶段挂掉: ...

November 4, 2026

UDC 镜像仓库迁移踩坑记录

背景 一次把 UDC 相关仓库从外部 GitLab 源迁到内网 GitLab + Nexus 的迁移,踩了十来个坑。本文把每个坑的「现象 → 根因 → 修复」记下来,方便后续再做类似镜像同步时直接对照。迁移目标是:把外部源(记为 gitlab-cloud)的仓库改写成指向内网 GitLab 的 podspec,并同步 Maven 产物到内网 Nexus。 名词解释 Pull Mirror(GitLab 原生镜像):GitLab 自带的仓库镜像功能,让镜像仓库与上游完全一致。 Nexus:内网私有仓库(Maven / raw 等),用来托管同步过来的二进制与 Maven 产物。 Protected 变量:GitLab CI 变量标记为 Protected 后,只在保护分支 / 标签上注入。 members/all:GitLab 查组成员接口,带 /all 才会包含从父组继承的成员。 一、GitLab 原生镜像根本没法用 一开始想直接用 GitLab 自带的 Repository Mirroring(pull mirror),结果它和「改写 podspec URL」的需求天然冲突:原生 pull mirror 会让镜像仓库与上游完全一致,等于把我们在内网侧做的 podspec URL 改写每次同步都覆盖回去。而且源仓库里的 podspec 仍带外部域名,我们用的同步 bot 是源项目的只读成员,push 回源会 403 “not allowed to upload code”——源仓库修不了。 ...

October 21, 2026