Optimization Solver：求解器SDK下載和安裝

1. 下載最新版

V0.x版本和V2.x版本的API大部分都不一樣，使用時請注意查看對應版本的API文檔。

當前最新版本：V2.3.0 發布時間：2026.02.02

修改記錄詳情、歷史版本下載，請查看歷史版本下載。

使用上面軟體包的環境依賴是：

下文將描述安裝方式，也可查閱視頻總覽的視頻來學習。

2. 安裝：基礎安裝，能支援C、C++、C#、MATLAB介面APIs

Windows系統：

雙擊安裝檔案，根據指引安裝。

安裝時，如果需要為所有使用者安裝，需要以管理員身份運行安裝包。方式為：先以管理員身份運行“命令提示字元”，然後切換到安裝包所在檔案夾，執行安裝包檔案。

Linux系統：

系統命令列中輸入如下指令，根據指引進行安裝：

bash mindopt-install-linux64x86-2.3.0.sh

或者ARM晶片版本：

bash mindopt-install-linux64aarch-2.3.0.sh

如果是在docker中安裝，dockerfile增加配置如下：

# 以 admin 使用者為例
RUN cd /home/admin/mindopt/ && \
    bash mindopt-install-linux64x86-2.3.0.sh --target /home/admin/mindopt && \
    rm -rf mindopt-install-linux64x86-2.3.0.sh

# 設定 mindopt 環境變數
ENV MINDOPT_HOME /home/admin/mindopt/2.3.0
ENV PATH $MINDOPT_HOME/linux64-x86/bin:$PATH
ENV LD_LIBRARY_PATH $MINDOPT_HOME/linux64-x86/lib:$LD_LIBRARY_PATH

V0.x.x版本的Docker安裝最後還需要加：

# 使用 JAVA SDK 時需要增設 MDO_NATIVE_LIBRARY 環境變數, 1.0.0 及後續版本不再需要
ENV MDO_NATIVE_LIBRARY $MINDOPT_HOME/linux64-x86/lib/libmindopt.so.0.25.1

macOS系統：

同Linux系統，系統命令列中輸入如下指令，根據指引進行安裝：

bash mindopt-install-osx64x86-2.3.0.sh

或者Apple Silicon晶片版本：

bash mindopt-install-osx64aarch-2.3.0.sh

求解器安裝完成後，安裝檔案目錄結構如下圖所示，會包含：

• 2.3.0總檔案夾，代表不同的軟體版本號碼，請以自己實際安裝版本為準。可以支援多版本同時存在，都安裝在mindopt目錄，比如下圖的0.25.1是舊版本。

• osx64-x86子檔案夾，裡面是可執行檔、動態庫等。這個檔案夾名稱有5種，對應不同系統版本：win64-x86、linux64-x86、osx64-x86、linux64-aarch、osx64-aarch，便於查驗是否安裝了正確的系統版本。

• examples檔案夾，推薦關注，裡面是多種程式設計語言、建模工具和樣本輸入資料data，協助您快速掌握。

• docs目錄中儲存了引導使用的Readme.txt檔案和EULA協議等。

• 最後的fl_client.ini是需要使用者去建立的鑒權檔案，後文會講述它。

  

3. 檢查環境變數和試運行

安裝過程中會配置環境變數，請查看檢查。如果安裝多個版本時，可根據自己的情況來修改生效的版本號碼。

Windows系統：

安裝步驟添加環境變數MINDOPT_HOME和Path，無需手動添加。如果安裝多個版本時，可修改MINDOPT_HOME來更改生效版本。如下圖所示：

Linux、macOS系統：

安裝時在~/.bashrc和~/.zshrc檔案中添加了指令source ~/.mdo_profile，安裝完成後重啟終端命令列會生效。安裝多版本時，可執行nano ~/.mdo_profile來修改。

現在您可執行如下指令查看同時立即生效環境變數：

cat ~/.mdo_profile
source ~/.mdo_profile

在Docker中安裝時，可以用export方式查看檢查。

檢查完環境變數後，可在命令列中執行mindopt來驗證是否安裝成功。截圖示意如下：

運行失敗的常見異常處理方式：

如果執行失敗，很可能是許可權問題，可通過以下方式更改可執行檔的許可權：

Linux：

chmod u+x $MINDOPT_HOME/linux64-x86/bin/mindopt

macOS：

chmod u+x $MINDOPT_HOME/osx64-x86/bin/mindopt

有些系統可能會由於開發人員安全校正不能順利運行mindopt，如macOS可在安全性與隱私中點擊仍然允許。如下圖所示。更多異常可查詢常見問題FAQ中安裝問題。

4. 配置鑒權檔案

使用求解功能的時候，需要配置授權檔案。MindOpt支援兩種鑒權方式：

• 1. 雲鑒權：阿里雲使用者請根據3. 配置阿里雲鑒權帳號來擷取授權LicenseKey和配置授權檔案fl_client.ini，然後把此檔案放置在下文建議的位置。

  • 此License與阿里雲帳號綁定，求解時使用者本地求解，連網僅鑒權，不上傳其他資訊。

  • 此鑒權方式的好處：

    • 使用者可自助申請，立即發放LicenseKey；

    • 一次申請多個電腦可以使用；

    • 快到期的時候會收到簡訊提醒，屆時在控制台網頁上點擊續期就行，無需更換License檔案。

• 2. 不連網：線下不連網版本採用的是mindopt.lic檔案，是本地鑒權作用，與機器ID綁定。

  • 2024年起，支援在控制台採購“不連網單機不限並發”的本地鑒權License，參考不連網固定機器授權版的機器指紋碼的擷取方式。

說明：

• 鑒權時，軟體會根據環境變數設定，自動先找檔案mindopt.lic再找檔案fl_client.ini，然後驗證該檔案的有效性。

• 授權檔案的名稱是固定的，不能改變。

鑒權檔案置放位置：

• （推薦）可以設定環境變數MINDOPT_LICENSE_PATH 來定義授權檔案放置的位置。

Linux和macOS系統的環境變數新增內容樣本如下（環境變數檔案修改方式同上文）：

export MINDOPT_LICENSE_PATH=$HOME/mindopt

下圖是Windows添加的樣本，更多可參考許可證配置

• 在不設定環境變數時，MindOpt預設在 {使用者根目錄}\mindopt 下尋找該檔案。

  • 例如Windows當前登入使用者為Administrator ，則設定檔路徑應為C:\Users\Administrator\mindopt\fl_client.ini。

  • 例如Linux，設定檔路徑應為~/mindopt/fl_client.ini。

5.（可選）安裝Java支援

<dependency>
  <groupId>com.alibaba.damo</groupId>
  <artifactId>mindoptj</artifactId>
  <version>2.1.0-SNAPSHOT</version>
  <classifier>osx-x64</classifier>
  <!-- macOS arm64  : osx-aarch -->
  <!-- linux arm64  : linux-aarch -->
  <!-- linux x86    : linux-x64 -->
  <!-- windows      : win-x64 -->
  <!-- all platforms: portable -->
  <type>jar</type>
</dependency>

<dependency>
  <groupId>com.alibaba.damo</groupId>
  <artifactId>mindoptj</artifactId>
  <version>2.0.0</version>
  <scope>system</scope>
  <systemPath>${env.MINDOPT_HOME}/osx64-x86/lib/mindoptj.jar</systemPath>
</dependency>

<dependency>
  <groupId>com.alibaba.damo</groupId>
  <artifactId>mindoptj</artifactId>
  <version>[0.24.0, 1.0.0)</version>
</dependency>

6.（可選）安裝Python支援

安裝了單機版安裝包後，進入以下路徑下執行指定命令安裝 Python SDK：

cd <MDOHOME>/<VERSION>/<PLATFORM>/lib/python
pip install .

7. 卸載和重裝

8. 求解器使用

新手建議根據快速入門文檔的一個快速求解的例子來快速上手，更多的使用說明見求解器使用者手冊。