工程檔案

Xcode Cloud 出口 IP 變更後,企業防火牆怎麼更新?2026

Xcode Cloud 出口 IP 變更後,企業防火牆怎麼更新?2026

Apple 的 Xcode Cloud 發布說明記錄,出口 IP 範圍於 2026 年 2 月 10 日發生變更(Apple 發布說明)。因此,Xcode Cloud 出口 IP 防火牆更新應以 Apple 現行公布的範圍為依據,逐一核對程式碼託管端與防火牆 allowlist,再用實際工作流程確認存取;不要沿用舊規則,也不要以未經核實的第三方清單代替官方資料。

適合: 維護企業網路規則、程式碼託管存取限制,或負責 iOS CI/CD 安全驗收的團隊。
不適合: 只需要排查一般 Xcode 建置錯誤,且不管理網路或倉庫存取策略的讀者。

企業 IT 網路負責人:盤點防火牆、閘道及網路存取控制規則。
安全工程師:審查變更依據、影響範圍、審批與回復安排。程式碼託管平台管理員:確認倉庫限制與工作流程授權。

最後更新於 2026 年 10 月 26 日;地址範圍及適用說明核對自 Apple Xcode Cloud 發布說明與專案設定文件。這只確認 Apple 文件記載的變更,不代表你的內部規則已更新或已生效;若 Apple 後續更新相關文件,應重新核驗。

先把官方地址範圍和企業規則分開

Apple 的專案設定文件提供 Xcode Cloud 存取程式碼倉庫所需的 IP 範圍資訊。請直接開啟現行文件核對適用範圍及 IPv4、IPv6 項目,不要從舊工單、複製貼上的設定,或未經確認的第三方列表推定應放行的位址。

官方公布的是地址依據;企業實際允許哪些來源、目的地與服務,仍由你的防火牆、閘道、倉庫設定及變更程序決定。兩者必須分開留存,否則即使拿到一份最新地址清單,也無法證明它套用在正確的連線路徑上。

Xcode Cloud 的出口 IP 範圍在哪裡查?
以 Apple 的專案設定文件為準,並查看發布說明是否記載後續變更。保存核對時的文件網址、查閱日期及適用欄位;不要將本文或內部舊清單當成未來的官方地址來源。

先確認受影響的是哪一段流量:若倉庫服務位於企業網路內,防火牆或閘道可能需要檢查該服務接收連線時所用的來源限制;若問題出在其他外部服務,不能只因它與 Xcode Cloud 同時失敗,就直接把原因歸到倉庫 allowlist。Apple 另有源程式碼管理連線說明,可供你對照專案所採用的連線方式。

網路與安全團隊:界定變更範圍

網路負責人應從實際生效的規則物件著手,而非只檢查一份地址表。對自託管 Git 服務而言,需確認面向 Xcode Cloud 的連線是否經過防火牆、雲端網路控制或反向代理,以及這些元件各自使用的來源限制;只有在服務確實以 HTTPS 接收該連線時,才將相關 HTTPS 規則納入本次變更。

Xcode Cloud IP 變更後哪些防火牆規則需要複核?
逐一檢查與倉庫存取路徑有關的來源條目、目的服務、通訊協定、規則物件、變更審批與回復記錄。若你的拓撲不使用某個閘道或規則層,就不必為了套用範本而新增設定。

負責角色 核對項目 可接受的變更依據 不應直接推定
網路負責人 防火牆、閘道及倉庫入口的來源限制 Apple 現行文件與企業核准的規則變更 舊清單仍然有效,或所有流量都走同一入口
安全工程師 來源、目的地、服務範圍及審批記錄 已記錄的風險評估、核准人與回復方法 為求恢復而允許任意來源
倉庫管理員 IP 限制、倉庫授權及身分驗證設定 倉庫實際政策與連線測試 網路放行就等於帳戶已有倉庫權限
CI 平台工程師 工作流程、倉庫連線及執行記錄 代表性工作流程的實際結果 單次失敗必然是 IP 範圍錯誤

企業防火牆 allowlist 是否應包含整份官方清單?
不要只因清單由官方公布,就將所有項目不加判斷地加入每一個規則。先確認 Apple 文件所列範圍與你的服務入口、政策模型及協定設定是否相符;若防火牆支援分層物件,按核准的規則設計管理,並記下每一項來源與目的地的理由。NIST 的安全控制文件可供安全團隊參考存取控制與變更管理的審查方向,但不能取代企業自己的風險評估。

提醒: 不要把「短暫放寬來源限制以確認是否恢復」當成正式驗收。若必須做診斷性調整,應採用已核准的變更程序,限定範圍與時間,並在測試後確認原有控制已恢復。

企業亦可參考管理 IP allowlist 的文件了解程式碼託管端可能有獨立的網路限制;但各組織的功能與設定方式不同,應以你實際使用的倉庫服務及其管理文件為準。

程式碼託管管理員:網路放行不等於倉庫授權

自託管 Git 服務如何允許 Xcode Cloud 存取?
先核實服務入口實際收到的來源限制,再按 Apple 現行 IP 範圍更新適用的 allowlist;之後另行檢查專案連線設定、倉庫授權與所需憑證。Apple 的源程式碼管理設定說明可協助核對連線設定,而安全說明則提供 Xcode Cloud 安全相關資訊。兩者都不能代替你對企業倉庫權限的實際驗證。

檢查層 確認內容 通過條件
網路路徑 服務入口及相關防火牆規則 官方範圍已依核准規則套用,且連線到達正確服務
倉庫限制 企業或自託管服務上的 IP allowlist 倉庫端規則與網路端政策均已核對
身分與權限 專案連線、帳戶及倉庫存取權 工作流程使用的連線身分具備所需存取權
CI 工作流程 倉庫連線、程式碼拉取及建置結果 代表性工作流程完成,且執行記錄可供審查

若你的程式碼取得流程還涉及外部相依項目,不要將該路徑與倉庫存取混為一談;Apple 的相依項目提供指南說明了相關設定方向。這類連線失敗需按實際目的地和設定分別核對,不能單憑 IP 更新的時間點作結論。

CI 團隊:按步驟完成變更與驗收

更新 allowlist 後,怎樣確認工作流程能拉取倉庫?
使用包含代表性倉庫連線與建置工作的 Xcode Cloud 工作流程進行驗收,檢查執行記錄中倉庫取得與後續建置是否按預期完成。Apple 的首次工作流程設定說明及工作流程動作文件可供你對照流程設定;實際連線是否成功,仍以團隊測試記錄為準。

  1. 保存基準狀態。 匯出或記錄目前防火牆、閘道、倉庫 allowlist 與相關授權設定,標示設定擁有人及回復責任人。
  2. 核對 Apple 現行文件。 由負責人重新查看發布說明及專案設定文件,確認出口 IP 範圍與 IPv4、IPv6 項目;將核對時間與來源連結寫入變更單。
  3. 追出實際路徑。 由網路及倉庫管理員共同確認連線經過哪些控制點、各點限制的是哪一段流量。不要假設所有規則都由同一團隊維護。
  4. 分層提出變更。 在防火牆、閘道或倉庫限制中,只更新已確認受影響的規則,並在審批資料中記錄來源範圍、目的服務、協定依據與回復方式。
  5. 檢查身分與倉庫權限。 倉庫管理員獨立確認專案連線及倉庫授權,避免把網路連通誤判為權限已滿足。
  6. 執行代表性工作流程。 由 CI 工程師觸發實際工作流程,核對倉庫連線、程式碼拉取與建置結果,保存可審查的執行記錄。
  7. 處理失敗並完成關閉。 若測試未通過,分別核對規則是否生效、倉庫授權及工作流程設定;記錄回復決定、責任人和後續監察安排。

變更單可用下列欄位保存證據,方括號內容應以團隊實際資料填寫,不是可直接套用的 IP 清單:

依據:[Apple 現行文件連結及核對日期]
受影響規則:[防火牆/閘道/倉庫規則]
來源與目的:[依核准內容填寫]
審批與回復責任人:[負責人]
驗收工作流程:[實際工作流程識別資料]
結果:[團隊測試結果及執行記錄]

經驗提醒: 若防火牆規則已變更但工作流程仍失敗,先確認規則是否已套用至正確入口,再檢查倉庫授權與工作流程設定。只有實際的企業規則檢視及工作流程測試,才能證明變更有效;Apple 文件本身不會證明你的環境已完成更新。

用條件分支決定是否放行或回復

  • 若 Apple 現行文件涵蓋的範圍與企業服務入口、倉庫限制一致,且變更已獲審批,則更新對應 allowlist,再以代表性工作流程驗收。
  • 若無法確認哪個入口承接 Xcode Cloud 的倉庫存取,則先暫停擴大規則範圍,由網路與倉庫管理員共同追查路徑。
  • 若網路規則已核實,但倉庫拉取仍失敗,則轉查倉庫授權、專案連線與工作流程設定,不要直接擴大來源範圍。
  • 若測試後仍無法證明新規則符合預期,則按變更單執行回復,保存測試記錄並重新確認故障所在層級。

完成閉環時,請確保官方資料、內部修改記錄、審批依據、工作流程驗收結果及回復責任人能互相對照;同時指定負責監察 Apple 公告並重新核驗規則的人員。你也可參考遠端 Mac 方案比較,評估其他 macOS 專屬建置任務的執行環境,但它不能代替 Xcode Cloud 的網路規則驗收。

如果驗收後仍有需要在 macOS 上執行的建置、測試或短期擴容任務,可再評估 OakVM 的遠端 Mac 租用是否符合團隊的存取與工作負載要求;若任務長期固定、持續高負載,或必須直接連接實體設備,自購硬體可能更合適。開始評估前,可透過聯絡 OakVM確認服務安排,再按你們的網路政策自行審查是否適用。

OAKVM BUILD NODE

讓 macOS 建置網路規則更易管理,接入 OakVM 獨享節點

OakVM 提供獨享 Apple Silicon 實體 Mac,可將需要 macOS 的 CI 工作接入現有流水線,無須重寫整套流程。

選擇設定並租用