私服

本章承接"远程仓库与镜像"，讲解企业级仓库解决方案——私服。理解私服在仓库体系中的位置、三重核心作用，是设计企业 Maven 架构、保障依赖供应链安全、实现跨项目构件共享的前提。

核心机制

组织通常希望使用由 IT 部门控制的内部远程仓库。这个内部仓库可以用来托管私有构件，也可以缓存外部仓库的构件。—宿主私有构件和代理外部仓库。

业界主流的私服产品包括：

Sonatype Nexus Repository：开源/商业版，Java 生态最广泛使用的私服
JFrog Artifactory：功能丰富，支持多种包管理器（Maven、npm、Docker 等）
Apache Archiva：Apache 基金会项目，轻量级

企业为什么需要私服

飞翔科技这样的企业，如果所有开发者都直接访问中央仓库和阿里云镜像，会遇到以下问题：

问题	风险	私服解决方案
私有构件无法发布	公司核心算法 JAR 不能上传到公共互联网	私服提供内部宿主仓库，仅供内网访问
外部依赖不可控	中央仓库的某个 JAR 被篡改或下架，导致构建失败	私服缓存外部依赖，企业自主控制可用版本
构建速度不稳定	公网下载受带宽、DNS、国际链路影响	内网私服提供千兆级下载，速度稳定
版本混乱	不同项目引用同一依赖的不同版本，难以统一	私服可配置"版本策略"，强制使用指定版本
安全审计缺失	不知道项目用了哪些开源组件，无法排查漏洞	私服记录所有依赖的使用情况，生成物料清单

私服的三重作用

以 Nexus 为例，私服通过三种类型的仓库实现完整的企业级依赖管理：

代理仓库（Proxy Repository）
- 作用：代理外部公共仓库（中央仓库、Spring 仓库等）
- 机制：第一次请求某个构件时，私服去外部仓库拉取并缓存；后续请求直接返回缓存
- 价值：加速下载、隔离公网、控制外部依赖的"准入名单"
宿主仓库（Hosted Repository）
- 作用：存储企业私有构件
- 机制：开发者通过 mvn deploy 将项目 JAR 发布到宿主仓库；其他项目通过 GAV 坐标引用
- 价值：实现跨项目复用、保护知识产权、统一版本管理
仓库组（Group Repository）
- 作用：将多个代理仓库和宿主仓库聚合为一个统一入口
- 机制：对外暴露一个 URL，内部按优先级在多个仓库中查找
- 价值：简化客户端配置（只需配一个地址）、灵活调整内部仓库组合

生活类比：企业食堂与供应链

想象飞翔科技有一栋办公楼（企业内网），楼里有员工食堂（私服）：

代理仓库 = 食堂的食材采购部：食堂每天早上去市里的批发市场（中央仓库）采购蔬菜肉类，存放在食堂冷库。员工中午来吃饭，直接从冷库取，不用自己去市场。如果市场某天断货，食堂冷库还有存货，员工照样能吃上饭
宿主仓库 = 食堂的私房菜窗口：公司自己的厨师（开发团队）研发了独家秘方菜（私有 JAR），只在公司内部食堂供应，外人吃不到。其他部门（其他项目）想吃这道菜，来食堂就行
仓库组 = 食堂的综合取餐台：员工不用分别去采购部冷库、私房菜窗口、水果区找吃的，只需到综合取餐台，服务员自动从各个区域把你要的东西凑齐

这个类比的关键在于：私服是企业内部的"依赖供应链中心"，它既连接外部市场（代理），也管理内部产出（宿主），还为消费者提供统一入口（仓库组）。没有它，每个员工（开发者）都要自己跑市场（公网下载），既低效又不安全。

图示

上图展示了私服在仓库体系中的核心位置。它位于公网与开发者之间，形成一道"企业级缓冲层"：

对外：通过代理仓库连接多个公共仓库，缓存热门依赖
对内：通过宿主仓库管理私有构件，保护知识产权
对开发者：通过仓库组提供单一 URL，简化配置

完整示例

场景

飞翔科技的 employee-system 和 payroll-service 两个项目都需要使用公司自研的统一认证 SDK auth-sdk。CTO 大翔要求：

auth-sdk 不能上传到公共互联网
所有项目必须使用同一版本的 auth-sdk
外部依赖（如 Spring Boot）的下载必须走公司内网，禁止直连公网

架构师白歌在公司内网部署了 Nexus 私服，并配置了仓库组 public。

操作前：没有私服时的混乱

在没有私服之前：

auth-sdk 的 JAR 通过邮件/网盘在团队间传递，版本混乱
小崔的电脑上 auth-sdk-1.0.0.jar 和黄俪的电脑上 auth-sdk-1.1.0.jar 不同
李眉部署时发现生产环境缺少 auth-sdk，紧急手动上传，容易出错
外部依赖下载走公网，速度不稳定，且无法审计用了哪些开源组件

操作步骤

步骤 1：Nexus 私服端配置

白歌在 Nexus 管理后台创建了以下仓库：

仓库类型	仓库 ID	用途
Proxy	`maven-central`	代理中央仓库
Proxy	`spring-milestones`	代理 Spring 里程碑仓库
Hosted	`company-releases`	存储公司正式发布版构件
Hosted	`company-snapshots`	存储公司快照版构件
Group	`public`	聚合以上所有仓库，对外暴露统一 URL

仓库组 public 的聚合顺序（优先级从高到低）：

company-releases
company-snapshots
maven-central
spring-milestones

步骤 2：开发者 settings.xml 配置

白歌将统一配置分发给全员。注意：这里配置的是仓库（profile 中的 repository），而非镜像，因为私服是一个新的数据源：

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
                              http://maven.apache.org/xsd/settings-1.0.0.xsd">
    <profiles>
        <profile>
            <id>company-nexus</id>
            <repositories>
                <repository>
                    <id>nexus-public</id>
                    <name>飞翔科技私服</name>
                    <url>http://nexus.feixiang.tech/repository/public/</url>
                    <releases>
                        <enabled>true</enabled>
                    </releases>
                    <snapshots>
                        <enabled>true</enabled>
                    </snapshots>
                </repository>
            </repositories>
        </profile>
    </profiles>
    <activeProfiles>
        <activeProfile>company-nexus</activeProfile>
    </activeProfiles>

    <servers>
        <server>
            <id>company-releases</id>
            <username>deployer</username>
            <password>{加密密码}</password>
        </server>
        <server>
            <id>company-snapshots</id>
            <username>deployer</username>
            <password>{加密密码}</password>
        </server>
    </servers>
</settings>

步骤 3：项目 pom.xml 配置发布目标

auth-sdk 项目的 pom.xml 中声明发布地址：

<project>
    ...
    <groupId>com.feixiang</groupId>
    <artifactId>auth-sdk</artifactId>
    <version>1.0.0</version>

    <distributionManagement>
        <repository>
            <id>company-releases</id>
            <name>公司正式发布仓库</name>
            <url>http://nexus.feixiang.tech/repository/company-releases/</url>
        </repository>
        <snapshotRepository>
            <id>company-snapshots</id>
            <name>公司快照仓库</name>
            <url>http://nexus.feixiang.tech/repository/company-snapshots/</url>
        </snapshotRepository>
    </distributionManagement>
</project>

步骤 4：发布私有构件到私服

白歌在 auth-sdk 项目目录下执行：

mvn deploy

步骤 5：其他项目引用私有构件

employee-system 的 pom.xml 中正常声明依赖：

<dependencies>
    <dependency>
        <groupId>com.feixiang</groupId>
        <artifactId>auth-sdk</artifactId>
        <version>1.0.0</version>
    </dependency>
</dependencies>

小崔执行 mvn compile，Maven 自动从私服下载 auth-sdk-1.0.0.jar。

操作结果

私有构件统一管理：auth-sdk 的所有版本都存储在 company-releases 仓库，不再通过邮件/网盘传递
版本一致性保障：employee-system 和 payroll-service 都从同一个仓库获取 auth-sdk，版本完全一致
外部依赖加速且可控：Spring Boot 等外部依赖通过 maven-central 代理缓存，内网下载速度提升 10 倍以上；白歌可以在 Nexus 后台查看"哪些项目用了哪些开源组件"
部署自动化：李眉的 Jenkins 流水线直接连接私服，无需手动上传 JAR，部署错误率降为零

易错点与常见问题

误区一：私服只是"内部的中央仓库"

错误认知："我们公司搭了私服，就是把中央仓库复制了一份到内网，别的没什么特别的。"

纠正：私服远不止"中央仓库的本地副本"。它的核心价值在于宿主私有构件和统一管理。如果只是复制中央仓库，阿里云镜像已经做得很好了。私服不可替代的功能是：

托管公司自研的、不能公开的 JAR
强制所有项目使用经过安全审核的依赖版本
记录完整的依赖使用审计日志
在断网环境下保证构建不中断（因为外部依赖已缓存）

误区二：有了私服就不需要本地仓库

错误认知："我们公司有 Nexus 私服了，所有依赖都从私服下载，本地仓库可以关掉了。"

纠正：私服和本地仓库是不同层级的缓存。私服解决的是"企业级共享缓存"（一台服务器缓存，全公司受益）；本地仓库解决的是"开发者个人缓存"（一台电脑缓存，该开发者所有项目受益）。即使有了私服，Maven 仍然会把从私服下载的 JAR 保存到本地仓库，这样：

同一开发者构建多个项目时，公共依赖无需重复从私服下载
开发者出差或断网时，只要本地仓库完整，仍能离线构建
减少私服服务器的网络压力

误区三：`distributionManagement` 和 `repositories` 可以互相替代

错误认知："我在 pom.xml 里写了 <repositories> 指向私服，就不需要 <distributionManagement> 了。"

纠正：两者的作用完全相反：

配置	方向	作用
`<repositories>`	下载（Read）	告诉 Maven"从这个地址下载依赖"
`<distributionManagement>`	上传（Write）	告诉 Maven"把构建产物发布到这个地址"

如果你只配了 <repositories>，项目可以从私服下载依赖，但执行 mvn deploy 时会失败，因为 Maven 不知道往哪上传。两者必须分别配置，且 <distributionManagement> 中的 <id> 需要与 settings.xml 中 <servers> 的 <id> 匹配，用于认证。

小结

私服是企业 Maven 架构的"中枢神经"，通过代理仓库缓存外部依赖、宿主仓库管理私有构件、仓库组提供统一入口，实现了依赖供应链的安全、高效、可控。主流产品 Nexus 和 Artifactory 不仅解决了"私有 JAR 往哪放"的问题，更提供了版本策略、漏洞扫描、使用审计等企业级能力。

本章与全局的关系：本章完成了"仓库"主题的闭环——从仓库体系全景，到本地仓库的物理结构，到远程仓库与镜像的加速机制，再到私服的企业级部署。下一章将进入"构建生命周期"主题，讲解 Maven 如何按阶段编排编译、测试、打包等构建动作。