搭建 Maven 私服：Nexus 3.x 安裝、配置與客戶端接入實戰

搭建 Maven 私服：Nexus 3.x 安裝、配置與客戶端接入實戰

Maven 私服能顯著提升團隊構建速度、節省頻寬、管理內部構件。本文記錄在 Linux/Windows 上部署 Nexus OSS、修改端口、配置 Maven settings.xml 與項目 pom.xml、驗證代理緩存效果的完整步驟。

一、 服務端部署

1. 下載：Nexus Bundle（推薦 3.x 版本）
2. 解壓：unzip nexus-latest-bundle.zip
3. 修改端口（可選）：etc/nexus-default.properties 中 application-port=8081
4. 安裝服務/啟動：
   • Linux: bin/nexus start 或配置 systemd
   • Windows: bin\nexus.exe /install → services.msc 啟動
5. 訪問 https://IP:8081，默認賬號 admin/admin123（首次登錄強制改密）

二、 Maven 客戶端配置 ~/.m2/settings.xml

<servers>
  <server><id>releases</id><username>admin</username><password>admin123</password></server>
  <server><id>snapshots</id><username>admin</username><password>admin123</password></server>
</servers>
<mirrors>
  <mirror>
    <id>nexus</id>
    <mirrorOf>*</mirrorOf>
    <url>https://127.0.0.1:8081/repository/maven-public/</url>
  </mirror>
</mirrors>
<profiles>
  <profile><id>nexus</id>
    <repositories>
      <repository><id>central</id><url>https://central</url></repository>
    </repositories>
    <pluginRepositories>
      <pluginRepository><id>central</id><url>https://central</url></pluginRepository>
    </pluginRepositories>
  </profile>
</profiles>
<activeProfiles><activeProfile>nexus</activeProfile></activeProfiles>

三、 項目級 pom.xml 配置（可選，若 settings 已配鏡像可省略）

<repositories>
  <repository><id>nexus</id><url>https://127.0.0.1:8081/repository/maven-public/</url></repository>
</repositories>
<pluginRepositories>
  <pluginRepository><id>nexus</id><url>https://127.0.0.1:8081/repository/maven-public/</url></pluginRepository>
</pluginRepositories>

四、 驗證與加速效果

1. 項目目錄執行 mvn clean compile
2. Nexus 管理界面 → Repositories → maven-central → 查看緩存的構件（如 plexus-utils-3.0.jar）
3. 局域網其他機器構建同項目，直接從私服下載，速度提升數倍

五、 IDEA 索引更新提示

若 IDEA Maven 索引未更新：View → Tool Windows → Maven → 右鍵 Reimport / Update Indices，確保 Settings → Build Tools → Maven → User settings file 指向正確的 settings.xml。