本文中含有需要您注意的重要提示信息，忽略該信息可能對您的業務造成影響，請務必仔細閱讀。
當您需要使用自定義插件或系統默認插件中不包含的開源插件時，可通過阿里云Elasticsearch的自定義插件上傳與安裝功能，在實例中上傳并安裝對應插件。本文介紹具體的操作方法。
安裝自定義插件功能內部升級中，暫停使用。如果您急需使用該功能，請通過工單聯系我們。
前提條件
準備待上傳的插件，并確保插件的可用性和安全性。
插件文件格式要求：文件名只能包含大寫字母、小寫字母、數字、連接線（-）或點（.），長度為8~128位。文件后綴名必須是.zip。
重要建議在上傳插件前，先在本地自建Elasticsearch集群（與阿里云Elasticsearch相同版本）上進行測試，成功后再進行上傳，具體操作步驟請參見Installing Plugins。
如果您需要上傳自定義的SQL插件，請確保已經將阿里云Elasticsearch實例的YML文件中的xpack.sql.enabled參數設置為false。
具體配置方法請參見配置YML參數。
使用限制
阿里云Elasticsearch不支持上傳帶任意權限類的插件，例如elasticsearch-analysis-hanlp插件。
注意事項
在上傳與安裝自定義插件時，如果出現控制臺報錯、變更卡住、無法驗證通過或其他異常問題，可參見自定義插件安裝錯誤的排查與解決方法進行排查解決。
阿里云Elasticsearch升級時插件不會自動升級更新，需要重新上傳。
默認情況下自定義插件無法訪問公網環境。在新網絡架構下，可通過PrivateLink實現私網訪問，詳細信息請參見配置實例私網連接。舊網絡架構下，只可訪問同一VPC下的網絡環境。
插件本身可能影響實例的穩定性，請務必保證自定義插件的可用性和安全性。
操作步驟
安裝自定義插件操作會觸發實例重啟，并且插件本身可能影響實例的穩定性，請務必保證自定義插件的可用性和安全性，建議在業務低峰期進行操作。
- 登錄阿里云Elasticsearch控制臺。
- 在左側導航欄，單擊Elasticsearch實例。
- 進入目標實例。
- 在頂部菜單欄處，選擇資源組和地域。
- 在Elasticsearch實例中單擊目標實例ID。
在左側導航欄，選擇。
在插件配置頁面，單擊自定義插件列表頁簽，再單擊上傳。
上傳并安裝自定義插件。
云原生架構版實例（以kibana 443訪問端口區分，例如7.16、8.5、8.9等版本）對自定義插件上傳功能進行了優化，區分上傳和安裝，并支持安裝中進行取消。在上傳與安裝自定義插件時，云原生和非云原生實例操作步驟以及對插件的校驗項不同，具體如下：
云原生實例
在上傳插件面板，單擊添加多個文件或將多個文件拖放到此區域，選擇待上傳的插件，單擊打開。
您也可以將自定義的插件文件直接拖放到指定區域，完成添加。如下圖成功添加了文件名為analysis-xxx-v7.16.0.zip的自定義插件。
您上傳的插件文件需要滿足以下條件，否則校驗不通過：
文件名稱
只能包含大寫字母、小寫字母、數字、連接線（-）或點（.），長度為8~128位，后綴名必須是.zip。
重要包含以下特征的插件無法上傳安裝：與系統默認插件同名插件、單次重復上傳的同名同版本插件、與已安裝的自定義插件同名同版本的插件以及其他非兼容文件。
單文件大小：不能超過100 MB。
上傳的文件總數量：單實例不能超過50個。
選中頁面底部的提示信息，單擊確定。
在自定義插件列表頁面，單擊對應插件名稱前的
圖標，展開自定義插件，查看插件是否上傳成功。如果您可以在展開的列表中看到已上傳的插件，且插件的狀態顯示為未安裝，表示插件上傳成功。
如果您不再需要已上傳但未安裝的插件，可單擊插件右側的刪除，刪除對應插件。
在插件列表中，單擊對應插件右側操作列下的安裝，安裝已上傳的插件。
安裝時，系統會校驗插件依賴的Elasticsearch版本是否正確，如果不正確則安裝不成功。
您也可以選中多個插件，單擊底部的批量安裝，一次性安裝多個插件。
在彈出的對話框中，單擊繼續，完成插件安裝。
安裝插件會觸發集群重啟，建議業務低峰期進行。重啟成功后，如果在自定義插件列表中看到插件狀態顯示為已安裝，表示插件安裝成功。插件安裝成功后，您還可以更新或卸載插件：
更新插件
如果您需要更新已上傳至阿里云Elasticsearch中的自定義插件，可先上傳最新版本的同名插件，然后手動安裝即可。
卸載插件
如果您不再使用已安裝的插件，可單擊插件右側的卸載，卸載對應插件。詳細操作方法及注意事項請參見安裝或卸載系統默認插件。
說明安裝過程中支持單擊操作列的取消安裝取消插件安裝。 如果自定義插件安裝過程中無法適配elasticsearch集群，可以通過取消安裝功能卸載插件的影響。
非云原生實例
在上傳插件對話框中，單擊添加多個文件或將多個文件拖放到此區域，選擇待上傳的插件，單擊打開。
您也可以將自定義的插件文件直接拖放到指定區域，完成添加。如下圖成功添加了文件名為elasticsearch-sql-6.7.0.0.zip的自定義插件。
您上傳的插件文件需要滿足以下條件，否則校驗不通過：
文件名稱
只能包含大寫字母、小寫字母、數字、連接線（-）或點（.），長度為8~128位，后綴名必須是.zip。
重要包含以下特征的插件無法上傳安裝：與系統默認插件同名、單次重復上傳的同名同版本插件、依賴Elasticsearch版本不正確的插件以及其他非兼容文件。
單文件大小：不能超過100 MB。
上傳的文件總數量：單實例不能超過50個。
閱讀并選中對話框中的注意事項，單擊上傳安裝。
重啟成功后，如果在自定義插件列表中看到您上傳的插件，且狀態顯示為已安裝，表示插件上傳并安裝成功。
如果您不再使用此插件，可單擊插件右側的卸載，卸載此插件。詳細操作方法及注意事項請參見安裝或卸載系統默認插件。