HiMarket 部署指南

一、本地搭建

环境依赖： JDK 17、Node.js 18+、Maven 3.6+、MySQL 8.0+

启动后端：

# 构建项目
mvn clean package -DskipTests

# 启动后端服务
java --add-opens java.base/java.util=ALL-UNNAMED \
     --add-opens java.base/java.lang=ALL-UNNAMED \
     --add-opens java.base/java.lang.reflect=ALL-UNNAMED \
     -Ddb.host=${DB_HOST} \
     -Ddb.port=${DB_PORT} \
     -Ddb.name=${DB_NAME} \
     -Ddb.username=${DB_USERNAME} \
     -Ddb.password=${DB_PASSWORD} \
     -jar himarket-bootstrap/target/himarket-bootstrap-1.0-SNAPSHOT.jar

# 后端 API 地址：http://localhost:8080

启动前端：

# 启动管理后台
cd himarket-web/himarket-admin
npm install
npm run dev
# 管理后台地址：http://localhost:5174

# 启动开发者门户
cd himarket-web/himarket-frontend
npm install
npm run dev
# 开发者门户地址：http://localhost:5173

二、基于 Docker Compose 部署

包含七个服务组件：

• mysql： 数据库服务，为后端服务提供数据存储；
• himarket-server： 后端服务，运行在 8081 端口；
• himarket-admin： 管理后台界面，运行在 5174 端口，供管理员配置 Portal；
• himarket-frontend： 前台用户界面，运行在 5173 端口，供用户浏览和使用 API Product；
• Higress： Higress all-in-one 网关服务，运行在 8443、8082、8001 端口，其中控制台运行在 8001 端口，供用户浏览和使用；
• Redis： Higress 缓存服务；
• Nacos： Nacos 服务，运行在 8080、8848、9848 端口，其中控制台运行在 8080 端口，供用户浏览和使用。

安装命令

环境依赖： docker、docker compose、curl、jq

一键拉起： 使用 deploy.sh 脚本完成 HiMarket、Higress、Nacos 全栈部署和数据初始化。

# 克隆项目
git clone https://github.com/higress-group/himarket.git
cd himarket/deploy/docker/scripts

# 部署全栈服务并初始化
./deploy.sh install

# 或仅部署 Himarket 服务（不含 Nacos/Higress）
./deploy.sh himarket-only

# 卸载所有服务
./deploy.sh uninstall

# 服务地址
# 管理后台地址：http://localhost:5174
# 开发者门户地址：http://localhost:5173
# 后端 API 地址：http://localhost:8081

该脚本在部署完后会执行数据初始化钩子：执行登录数据初始化、示例 MCP 数据初始化、API 产品数据初始化。注意脚本包含部署和数据初始化两部分，数据初始化执行不阻塞部署，如若数据初始化钩子失败，可在 /scripts/hooks/post_ready.d 下重试。如：

cd docker/scripts/hooks/post_ready.d

# 重试失败脚本
./10-init-nacos-admin.sh

安装配置

所有配置集中在 scripts/data/.env 文件中：

cd docker/scripts/data
vi .env

三、使用 Helm 进行云原生部署

Helm 是一个用于自动化管理和发布 Kubernetes 软件的包管理系统。通过 Helm 一键部署脚本您可以在 Kubernetes 集群上快速部署安装 HiMarkt+Higress+Nacos，包含十个服务组件：

• HiMarket：
  • himarket-server：Himarket AI 开放平台的后端服务；
  • himarket-admin：Himarket AI 开放平台管理后台，管理员通过此界面配置 Portal；
  • himarket-frontend：Himarket AI 开放平台的前台服务，用户通过此界面浏览和使用 API；
  • mysql：可选内置数据库。
• Higress：
  • higress-console：控制台，用户通过此界面浏览和使用 Higress 服务；
  • higress-controller：控制面组件，负责管理配置下发；
  • higress-gateway：数据面组件，负责承载数据流量；
  • redis-stack-server：缓存组件。
• Nacos：
  • nacos：Nacos 应用；
  • nacos-mysql：Nacos 数据库。

服务类型说明：

默认为 LoadBalancer 类型服务，适用于云环境（阿里云 ACK、AWS EKS 等）。如果您的环境不支持 LoadBalancer（如本地 minikube、自建集群），可以使用 NodePort 或端口转发方式访问。后台配置好 Himarket 后，将域名解析到 himarket-frontend 服务的访问地址，用户就可以通过域名访问前台站点。

安装命令

环境依赖： kubectl、python3/python、curl、jq

一键拉起： 使用 deploy.sh 脚本将 HiMarket 部署到 Kubernetes 集群。

# 克隆项目
git clone https://github.com/higress-group/himarket.git
cd himarket/deploy/helm/scripts

# 部署全栈服务并初始化
./deploy.sh install

# 或仅部署 Himarket 服务（不含 Nacos/Higress）
./deploy.sh himarket-only

# 卸载
./deploy.sh uninstall

该脚本在部署完后会执行数据初始化钩子：执行登录数据初始化、示例 MCP 数据初始化、API 产品数据初始化。注意脚本包含部署和数据初始化两部分，数据初始化执行不阻塞部署，如若数据初始化钩子失败，可在 /scripts/hooks/post_ready.d 下重试。如：

cd helm/scripts/hooks/post_ready.d

# 重试失败脚本
./10-init-nacos-admin.sh

安装配置

相关配置集中在 scripts/data/.env 文件中：

cd helm/scripts/data
vi .env

注：Himarket 的 Helm 包适配阿里云 ACK 集群使用，/helm/values.yaml 文件下存储类 persistence.storageClass: “alicloud-disk-essd” 值需根据实际环境调整。

四、云平台部署（阿里云）

阿里云计算巢支持该项目的开箱即用版本，可一键部署社区版：