簡介Nexus Repository Manager 3.50.0-01 是面向 Windows 64 位系統(tǒng)的倉庫管理軟件主要服務(wù)于需要搭建 Maven 私服的開發(fā)團隊與運維人員用于統(tǒng)一存儲、發(fā)布和管理 Maven、npm、Docker 等構(gòu)建工具產(chǎn)出的軟件包。該版本在安全性與性能上做了強化提供細粒度權(quán)限控制以保障倉庫內(nèi)容完整并優(yōu)化了存儲與檢索速度從而提升構(gòu)建和部署效率。壓縮包共 690 個文件約 240.15MB以 419 個 jar 核心庫、82 個 dll 動態(tài)鏈接庫、22 個 exe 可執(zhí)行程序為主輔以 xml、properties、cfg 等配置文件和少量 png、gif 圖標資源整體結(jié)構(gòu)完整開箱即可部署。目前已有 494 人學習下載。借助該安裝包讀者可快速搭建本地 Maven 私服掌握倉庫權(quán)限配置、構(gòu)件上傳與依賴代理等實用技能為團隊協(xié)作與持續(xù)集成提供穩(wěn)定支撐。1. 從一次內(nèi)網(wǎng)構(gòu)建翻車說起nexus-3.50.0-01-win64.zip 到底是什么上周幫一個做跨平臺系統(tǒng)的團隊排查構(gòu)建問題現(xiàn)象很典型開發(fā)機npm install秒過CI 流水線卻卡在拉包上轉(zhuǎn)圈日志里全是超時。一查他們的私服 Nexus 還是三年前的老版本倉庫格式對不上新版的元數(shù)據(jù)協(xié)議緩存里一堆半截包。換上新版 Nexus 之后同樣的流水線一次跑通。這件事讓我重新翻出nexus-3.50.0-01-win64.zip這個包——它是 Sonatype Nexus Repository 3 的 Windows 64 位發(fā)行版版本號 3.50.0-01解壓即用自帶 JVM 依賴不需要你單獨裝 Java 環(huán)境。它能解決的核心問題就一個在內(nèi)網(wǎng)里當 Maven、npm、Docker、PyPI 等格式的制品倉庫把外網(wǎng)依賴緩存到本地讓構(gòu)建不再看公網(wǎng)臉色。適合誰做私有化部署的后端、DevOps、需要離線構(gòu)建的嵌入式團隊以及被依賴下載速度折磨過的任何人。下面我按「裝起來 → 配明白 → 避坑 → 進階」的順序把這份資源拆開講透。2. 解壓與啟動把 Nexus 跑成 Windows 服務(wù)2.1 目錄結(jié)構(gòu)與啟動腳本怎么選把 zip 解壓到任意目錄比如D:\nexus你會看到兩個頂層文件夾nexus-3.50.0-01是程序本體sonatype-work是數(shù)據(jù)目錄首次啟動后生成。程序目錄里bin下有兩個關(guān)鍵腳本nexus.exe和nexus.bat。很多人第一次直接雙擊nexus.exe窗口一閃而過以為裝失敗了——其實它默認是前臺運行模式關(guān)掉窗口服務(wù)就停。正確做法是用命令行帶參數(shù)跑。# 進入 bin 目錄 cd D:\nexus\nexus-3.50.0-01\bin # 前臺啟動用于首次驗證配置是否正確 nexus.exe /run # 安裝為 Windows 服務(wù)開機自啟 nexus.exe /install nexus-repo # 啟動服務(wù) nexus.exe /start nexus-repo/run是前臺調(diào)試模式日志直接打在控制臺適合第一次確認端口和路徑?jīng)]問題。/install后面跟的是服務(wù)名可以自定義不寫默認叫nexus。服務(wù)方式啟動后日志會落到sonatype-work\nexus3\log\nexus.log排查問題看這個文件比看控制臺靠譜。提示W(wǎng)indows 服務(wù)方式啟動時默認以 LocalSystem 賬戶運行如果sonatype-work放在網(wǎng)絡(luò)盤或權(quán)限受限目錄會啟動失敗。建議數(shù)據(jù)目錄放在本地 NTFS 盤并確保服務(wù)賬戶有讀寫權(quán)限。2.2 端口、JVM 內(nèi)存與數(shù)據(jù)目錄的改法Nexus 3.50 默認監(jiān)聽 8081 端口JVM 堆內(nèi)存默認給得比較保守。生產(chǎn)環(huán)境如果倉庫里包多、并發(fā)拉取頻繁不改內(nèi)存很容易 OOM。配置文件在nexus-3.50.0-01\etc\nexus-default.properties改完重啟服務(wù)生效。# 應(yīng)用上下文默認根路徑反代到子路徑時才改 nexus-context-path/ # 監(jiān)聽端口被占用時改成 8082 等 application-port8081 application-host0.0.0.0 # 數(shù)據(jù)目錄默認相對路徑建議改成絕對路徑 nexus-data-blobstore-pathD:/nexus-data/blobsJVM 參數(shù)不在這個文件里而在bin\nexus.vmoptions。把-Xms和-Xmx調(diào)大比如 4G 內(nèi)存的機器給 2G 堆-Xms2048m -Xmx2048m -XX:MaxDirectMemorySize2048mMaxDirectMemorySize容易被忽略Nexus 處理大文件上傳下載時會用堆外內(nèi)存這個值太小會報OutOfMemoryError: Direct buffer memory。改完參數(shù)后用nexus.exe /stop再/start重啟別直接殺進程否則可能損壞 Lucene 索引。2.3 首次登錄與初始密碼在哪服務(wù)起來后瀏覽器訪問http://localhost:8081會提示初始密碼在sonatype-work\nexus3\admin.password文件里。復制出來登錄用戶名admin。登錄后第一件事是改密碼并禁用匿名訪問如果倉庫只對內(nèi)網(wǎng)特定團隊開放。匿名訪問在Security → Anonymous里關(guān)關(guān)之前確認所有客戶端都配了認證否則 CI 會突然 401。3. 倉庫類型與代理配置讓構(gòu)建真正提速3.1 三種倉庫類型的選型邏輯Nexus 的倉庫分三類理解它們才能配得對類型作用典型場景proxy代理遠程倉庫緩存到本地代理 Maven Central、npm registryhosted存放自己發(fā)布的制品內(nèi)部 jar 包、私有 npm 包group把多個倉庫聚合成一個入口統(tǒng)一對外暴露一個 URL選型上有個常見誤區(qū)很多人只建 proxy 倉庫然后讓開發(fā)直接指向 proxy 的 URL。正確做法是建一個 group把 proxy 和 hosted 都加進去開發(fā)只配 group 的地址。這樣內(nèi)部包和外部包走同一個入口將來加倉庫不用改客戶端配置。3.2 配一個 Maven 代理倉庫的完整步驟以代理 Maven Central 為例。登錄后進Settings → Repositories → Create repository選maven2 (proxy)。關(guān)鍵參數(shù)Namemaven-central-proxyRemote storagehttps://repo1.maven.org/maven2/Version policyRelease快照另建一個Storage → Blob store默認 default量大時單獨建 blob storeHTTP → Connection settings超時設(shè) 30 秒以上內(nèi)網(wǎng)出口慢的話設(shè) 60建完再建一個maven2 (group)把剛建的 proxy 和一個 hosted 加進去順序上 hosted 放前面這樣同名包優(yōu)先走內(nèi)部。客戶端settings.xml里配 mirrormirror idnexus-group/id mirrorOf*/mirrorOf urlhttp://內(nèi)網(wǎng)IP:8081/repository/maven-group//url /mirrormirrorOf寫*表示所有倉庫請求都走 Nexus包括插件倉庫。這一步配完mvn clean package第一次會慢走公網(wǎng)回源之后命中緩存就是內(nèi)網(wǎng)速度。3.3 npm 與 Docker 倉庫的差異化配置npm 代理倉庫選npm (proxy)Remote storage 填https://registry.npmjs.org/?？蛻舳伺鋘pm config set registry http://內(nèi)網(wǎng)IP:8081/repository/npm-group/。注意 npm 的 group 倉庫要把 proxy 和 hosted 都加進去否則npm publish私有包會失敗。Docker 倉庫稍微特殊需要建三種docker (hosted)存內(nèi)部鏡像docker (proxy)代理 Docker Hubdocker (group)聚合。hosted 倉庫要勾選 HTTP 連接器并指定一個端口比如 8082因為 Docker 客戶端不認 8081 上的路徑前綴。配完daemon.json里加insecure-registries然后docker pull才會走 Nexus。注意Docker proxy 首次拉取大鏡像時Nexus 會先完整下載再轉(zhuǎn)發(fā)客戶端可能卡在Pulling很久。這是正?；卦葱袨椴皇强ㄋ揽?Nexus 日志能看到下載進度。4. 避坑與排查那些讓我加班到凌晨的坑4.1 啟動報端口占用但 netstat 查不到現(xiàn)象nexus.exe /run報Address already in use但netstat -ano | findstr 8081什么都沒有。原因通常是 Windows 的http.sys或某個服務(wù)預留了端口范圍Nexus 綁不上。解決換端口或者用netsh int ipv4 show excludedportrange protocoltcp查預留段避開它。我一般直接把端口改成 8082 以上省得糾纏。4.2 上傳大包時 413 或超時現(xiàn)象mvn deploy傳一個 200MB 的 fat jar報 413 或連接重置。原因是 Nexus 前面的反向代理如果有限制了 body 大小或者 Nexus 自身的nexus-default.properties里沒調(diào)上傳限制。解決反代層調(diào)client_max_body_sizeNexus 層確認nexus-data-blobstore-path所在磁盤有足夠空間并且nexus.vmoptions里MaxDirectMemorySize夠大。內(nèi)網(wǎng)直連的話檢查是不是走了 group 倉庫的 hosted 子倉庫路徑別配錯。4.3 清理策略誤刪了還在用的包現(xiàn)象配了 Cleanup Policy 定時清理未使用的快照結(jié)果某個老項目的構(gòu)建突然拉不到包。原因是清理策略按「最后下載時間」判斷老項目半年沒構(gòu)建包被判定為未使用刪掉了。解決清理策略只對 snapshot 倉庫啟用release 倉庫別開自動清理或者把保留天數(shù)設(shè)長比如 180 天。血淚經(jīng)驗是清理任務(wù)第一次跑之前先手動跑一次 dry-runNexus 3.50 支持預覽確認要刪的列表里沒有關(guān)鍵包。4.4 服務(wù)重啟后索引損壞現(xiàn)象直接taskkill殺 Nexus 進程后重啟倉庫列表空白或搜索報錯。原因是 Lucene 索引在寫入時被強殺文件損壞。解決永遠用nexus.exe /stop停服務(wù)等進程完全退出再操作。已經(jīng)損壞的話停服務(wù)后刪掉sonatype-work\nexus3\db\下的索引目錄重啟會重建但歷史搜索記錄會丟包本身還在 blob store 里不影響拉取。4.5 匿名訪問關(guān)閉后 CI 全線 401現(xiàn)象為了安全關(guān)了匿名訪問結(jié)果 Jenkins 流水線全掛。原因是 CI 的settings.xml或.npmrc里沒配認證。解決在 Nexus 里建一個專用只讀賬號給 CI 用密碼寫進 CI 的憑據(jù)管理別硬編碼在腳本里。改配置前先在測試流水線驗證別直接動生產(chǎn)。5. 進階用腳本批量初始化倉庫與驗證緩存命中手動點界面建倉庫建到第五個就想砸鍵盤。Nexus 3.50 提供了 REST API可以用腳本批量創(chuàng)建。下面這段 Python 用requests調(diào) API先建 blob store再建 proxy 和 group適合新環(huán)境初始化。import requests from requests.auth import HTTPBasicAuth BASE http://localhost:8081/service/rest/v1 AUTH HTTPBasicAuth(admin, 你的新密碼) # 建 blob store量大時單獨隔離 blob { name: maven-blob, path: D:/nexus-data/blobs/maven, softQuota: {type: spaceRemainingQuota, limit: 10737418240} } r requests.post(f{BASE}/blobstores/file, jsonblob, authAUTH) print(blobstore:, r.status_code) # 建 maven proxy proxy { name: maven-central-proxy, online: True, storage: {blobStoreName: maven-blob, strictContentTypeValidation: True}, proxy: { remoteUrl: https://repo1.maven.org/maven2/, contentMaxAge: 1440, metadataMaxAge: 1440 }, negativeCache: {enabled: True, timeToLive: 1440}, httpClient: {connection: {retries: 3, timeout: 60}} } r requests.post(f{BASE}/repositories/maven/proxy, jsonproxy, authAUTH) print(proxy:, r.status_code) # 建 group把 proxy 加進去 group { name: maven-group, online: True, storage: {blobStoreName: maven-blob, strictContentTypeValidation: True}, group: {memberNames: [maven-central-proxy]} } r requests.post(f{BASE}/repositories/maven/group, jsongroup, authAUTH) print(group:, r.status_code)contentMaxAge是緩存元數(shù)據(jù)的有效期分鐘設(shè) 1440 表示一天內(nèi)不再回源檢查更新內(nèi)網(wǎng)穩(wěn)定后可以調(diào)大。negativeCache是拉不到的包也緩存一段時間防止反復回源拖慢構(gòu)建。retries和timeout按出口網(wǎng)絡(luò)質(zhì)量調(diào)出口差就加大。建完怎么驗證緩存真的生效第一次mvn dependency:resolve后看 Nexus 的Browse里對應(yīng)路徑下有沒有文件或者直接看sonatype-work\nexus3\blobs\maven-blob\目錄大小在漲。更直接的辦法是斷掉外網(wǎng)再跑一次構(gòu)建能過就說明緩存命中。我習慣在初始化腳本最后加一個curl檢查 group 倉庫的maven-metadata.xml是否返回 200作為冒煙測試。從那以后我每次部署新 Nexus都強制走一遍「前臺啟動驗證 → 改 JVM 參數(shù) → 腳本建倉庫 → 斷網(wǎng)構(gòu)建驗證」這四步再也沒在半夜被 CI 報警叫醒過。希望幫到你。本文還有配套的精品資源點擊獲取