Himarket

🚀 HiMarket AI 開放平臺

HiMarket 是一個開箱即用的 AI 開放平臺解決方案，可用於構建企業級的 AI 能力市場與開發者生態中心，滿足企業不同角色的多樣化需求。

🚀 快速開始

準備工作

1. 安裝 Git：訪問 Git 下載頁面 進行安裝。
2. 安裝 JDK 8 或者更高版本。
3. 安裝 Node.js（建議 v20 及以上）：訪問 Node.js 官網 進行安裝。
4. 安裝 Maven：訪問 Maven 下載頁面 進行安裝。
5. 準備數據庫：後端服務依賴外部數據庫，你需要本地啟動數據庫（如 MySQL/MariaDB 等），並根據 portal-bootstrap 中的 application.yaml 文件配置數據庫連接參數。

克隆項目代碼

git clone https://github.com/higress-group/himarket.git
cd himarket

啟動後端 portal-bootstrap

後端服務依賴外部數據庫，請參考 portal-bootstrap/src/main/resources/application.yaml 配置數據庫相關參數，也可以在啟動時通過命令行參數覆蓋這些配置。

啟動方式

先打包：

mvn clean package

再啟動：

java -Ddb.host=xxxx.mysql.rds.aliyuncs.com \
     -Ddb.port=3306 \
     -Ddb.name=xxx \
     -Ddb.username=xxx \
     -Ddb.password=xxx \
     -jar portal-bootstrap/target/portal-bootstrap-1.0-SNAPSHOT.jar

啟動前端項目

1. portal-web/api-portal-admin

cd portal-web/api-portal-admin
npm install
npm run dev

本地訪問地址參考控制檯輸出，一般為 http://localhost:5174。

2. portal-web/api-portal-frontend

cd portal-web/api-portal-frontend
npm install
npm run dev

本地訪問地址同上，一般為 http://${portal_frontend_domain}:5173。在本地開發過程中，portal_frontend_domain 需要配置域名解析（本地修改 /etc/hosts 文件），在 HiMarket 的設計中，門戶域名是解析到對應門戶 ID 的依據。

HiMarket 後臺管理

註冊管理員

訪問 http://localhost:5174，首次訪問註冊一個管理員賬號。

導入 Higress 實例

選擇【實例管理】-【網關實例】-【導入網關實例】-【Higress 網關】，導入 Higress 網關實例，以 http://demo.higress.io 為例進行導入，用戶名和密碼均是 admin。

創建 Portal 門戶

選擇【Portal】-【創建 Portal】，創建一個名為 himarket-demo 的門戶。 點擊門戶卡片，進入門戶配置，其他配置保留默認選項即可，在 【Setting】-【域名管理】-【綁定域名】中，綁定一個 localhost 域名，用於開發自測。其他菜單在快速入門中可以先不用關注，這裡簡單介紹下他們的功能：

• Published API Products：管理門戶中發佈的 API Product。
• Developers：管理門戶的 Developer，以及 Developer 關聯的 Consumer。
• Settings：
  • 配置門戶的基本信息。
  • 控制門戶中 Developer 的註冊審批是否自動通過、API Product 訂閱是否自動通過。
  • 門戶支持的三方登錄，支持標準的 OIDC 配置，如 Aliyun、Google、Github 等。

創建 API Product

選擇【API Products】-【創建 API Product】，創建一個 demo-api 的 API Product。 API Product 的初始狀態為“待配置”，需要進行 Link API、發佈到門戶等操作。

關聯 API

關聯一個網關的 MCP 服務，數據源來自於 Higress MCP 服務管理。API Config 也會自動同步 Higress 中的配置。

Usage Guide

可以在使用指南中編輯自定義的文檔信息。

發佈到門戶

在 API Product 準備就緒後，可以選擇發佈到指定的門戶。 至此，一個 Higress 的 MCP Server 成功發佈到了門戶。

HiMarket 門戶

HiMarket 門戶是多租戶設計，通過域名來識別不同的門戶實例。門戶會有一個默認分配的域名，但域名解析需要用戶自己完成，例如自動分配了 portal-68ac4564bdb292ee9261ff4a.api.portal.local 域名，需要將其解析到 api-portal-frontend 對應的 IP 上。由於剛剛已經額外配置了 localhost 域名給測試門戶，所以也可以直接通過 localhost:5173 訪問前臺。

註冊 Developer 開發者

由於門戶之前在設置中未打開自動審批，註冊賬號後需要等待管理員後臺審批開發者通過，審批通過後，方可使用註冊的賬號在前臺登錄。 訪問 MCP 門戶可以看到剛剛發佈的 MCP Server

創建 Consumer 消費者

在 AI 開放平臺的設計中，消費者 Developer 代表一般的用戶身份，而用戶需要持有對應的憑證才可以申請訂閱 API Product，而憑證這一概念，在 AI 開放平臺中稱之為 Consumer 消費者，Developer 與 Consumer 是一對多的關聯。 創建消費者之後，即可申請 API Product 的訂閱 門戶的默認配置中，訂閱的審批是默認關閉的，即開發者申請後會自動審批通過。

發起調用

攜帶消費者的憑證，配置門戶中 MCP Server 的連接地址，即可發起對 MCP Server 的調用。

阿里雲開箱即用

阿里雲計算巢支持了該項目開箱即用版本，可以使用下面鏈接一鍵部署社區版：

社區

交流群

技術分享

微信公眾號：

關聯倉庫

• Higress：https://github.com/alibaba/higress
• Higress 控制檯：https://github.com/higress-group/higress-console

貢獻者

查看貢獻者

Star History

↑ 返回頂部 ↑