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

网络 / 代理 / Gradle 问题修复记录

环境 Clash Verge Rev(混合端口 7897),全局代理在 ~/.zshenv; 两个机场订阅; 涉及内网域名 ugreeniot.com、ugreensmart.com,以及一台内网 Gradle 私服(形如 192.168.75.x)。 问题与修复 1. Android Studio Gradle 同步失败 现象:拉 kotlin-compiler-embeddable-2.4.0.jar(57 MB)失败,走代理 3m19s 只下 5.79 MB(29 kB/s),直连仍 3m48s 失败。 根因:AS 的 HTTP Proxy 设置不影响 Gradle daemon(Gradle 只看 gradle.properties / init script)。repo.maven.apache.org 走 Cloudflare CDN,Gradle 并发 HTTP/2 在国内频繁 RESET。curl 单连接 4.4 MB/s 正常,但 Gradle 不行。阿里云镜像 17.5 MB/s。 修复:新增 init.d 脚本把 3 个仓库换阿里云镜像(只影响本机,不污染团队项目)。验证 BUILD SUCCESSFUL。 坑:换源后报 Could not find xxx.klib——镜像文件其实是全的(md5 一致),真因是之前超时留下的半截缓存(pom / module 下了,klib 没下)。解决:删 metadata + 坏 artifact 目录,保留 1.1 GB 有效文件,不要用 --refresh-dependencies 或整个删 caches。 ...

September 7, 2026