【实战】HiMarket本地化部署指南

第1章 部署概述HiMarket是一套全栈服务完整部署需依赖5大核心基础组件所有组件协同工作支撑服务运行官方提供两种标准化部署方式且均通过交互式install.sh脚本实现一键配置、初始化无需手动繁琐配置极大降低部署门槛。1.1HiMarket 核心架构全景图理解组件协作关系的关键用户/开发者Higress AI 网关HiMarket ServerMySQL 数据库Nacos 配置中心Redis 缓存AI 模型服务HiMarket Admin 管理后台HiMarket Frontend 开发者门户管理操作应用发布/调用原理说明Higress 作为 AI 网关核心枢纽统一处理所有请求路由、鉴权及 AI 模型调用HiMarket 服务Server/Admin/Frontend/Sandbox依赖 Nacos 配置中心动态获取服务地址通过 MySQL 存储业务数据Redis 缓存高频请求。所有组件通过 Docker Compose 或 Helm 自动编排实现一键部署。1.2 完整部署核心组件HiMarket部署必须包含以下组件缺一不可MySQL核心数据库服务负责业务数据的持久化存储Nacos配置中心服务发现组件统一管理服务配置、实现服务注册发现HigressAI网关作为服务流量统一入口Redis缓存服务提升数据读写效率HiMarket核心业务载体包含Server后端服务、Admin管理后台、Frontend开发者门户、Sandbox沙箱四大模块1.3部署方式概览部署类型适用场景核心优势依赖环境Docker Compose本地开发/单机测试0配置启动环境隔离性好Docker, Docker Compose, curl, jqHelmK8s生产环境/集群部署高可用、自动扩缩容、云原生集成kubectl, Helm, python3, curl, jq统一管理逻辑两种方式均使用install.sh脚本交互式引导完成所有配置镜像版本、密码、AI 模型等非交互模式通过~/himarket-install.env复用配置。第2章 环境依赖部署前需提前安装对应依赖两种部署方式依赖略有差异基础通用依赖专属依赖如下基础通用依赖curl网络请求工具、jqJSON解析工具Docker Compose 部署专属依赖Docker、Docker ComposeHelmK8s部署专属依赖kubectl已连接K8s集群、helm、python3第3章 AI 辅助部署推荐如果担心部署过程中遇到环境兼容性、配置错误等问题推荐使用AI编程工具辅助部署AI可自动识别环境问题、解决部署报错零门槛完成部署。操作步骤先克隆项目到本地打开Openclaw、Cursor、Qoder、Claude Code等AI Coding工具输入指令阅读 deploy 目录下的部署文档帮我用 Docker Compose 部署 HiMarketAI会自动完成环境检测、配置修改、部署执行详细官方部署规则可参考部署文档第4章 Docker Compose 部署本地开发/单机部署Docker Compose是最常用的部署方式适合本地调试、个人单机使用通过install.sh脚本完成全栈服务HiMarket、Higress、Nacos、MySQL一键部署。4.1 前置条件已安装Docker、Docker Compose、curl、jqdocker# 容器引擎dockercompose# 容器编排工具curl# 网络请求工具jq# JSON 处理工具4.2 交互式部署官方推荐脚本会逐步引导完成所有配置镜像选择、密码设置、AI模型配置等无需手动修改配置文件新手首选gitclone https://github.com/higress-group/himarket.gitcdhimarket/deploy/docker ./install.sh# 脚本将引导完成镜像选择、密码设置、AI 模型配置等原理脚本通过read命令交互式收集配置自动写入~/himarket-install.env后续升级/卸载无需重复配置。如下图所示4.3 非交互模式适用于CI/CD自动化部署适合自动化流水线部署无需人工交互通过预编辑配置文件实现静默部署# 1. 复制配置模板到用户目录cp.env.example ~/himarket-install.env# 2. 编辑配置文件按需修改参数# 3. 执行非交互部署命令./install.sh-n️管理操作操作命令说明卸载./install.sh --uninstall清理所有容器、网络、卷数据升级重新运行./install.sh自动检测现有部署并提供升级选项查看日志docker compose logs -f实时跟踪容器日志4.4服务访问地址部署后立即可用服务名称主机端口访问地址说明HiMarket Admin5174http://localhost:5174管理后台用户/权限管理HiMarket Frontend5173http://localhost:5173开发者门户应用发布/调用HiMarket Server8081http://localhost:8081后端 API 服务核心业务Nacos8848http://localhost:8848/nacos配置中心动态配置管理Higress Console8001http://localhost:8001Higress 网关控制台Higress Gateway8082http://localhost:8082网关 HTTP 入口所有请求入口MySQL3306-数据库服务存储业务数据Redis6379-缓存服务加速高频请求关键设计Higress Gateway (8082)作为统一入口将请求路由到 HiMarket Server8081、AI 模型服务等实现服务解耦。如下图所示第5章 HelmKubernetes部署生产环境/集群部署适合企业生产环境、多节点集群部署兼容Kubernetes生态同样通过install.sh脚本实现自动化部署。5.1✅前置条件kubectl# Kubernetes 命令行工具需已连接集群helm# Helm 包管理器python3# 用于配置脚本curl, jq# 与 Docker 部署相同5.2部署步骤1️⃣交互式部署推荐gitclone https://github.com/higress-group/himarket.gitcdhimarket/deploy/helm ./install.sh# 脚本引导配置同 Docker 方式2️⃣非交互模式cp.env.example ~/himarket-install.envnano~/himarket-install.env# 修改配置./install.sh-n⚙️关键配置说明默认命名空间himarketHelm 部署时自动创建服务类型Admin/Frontend 默认使用LoadBalancerK8s 服务类型暴露公网 IP配置复用~/himarket-install.env同 Docker 部署升级时自动加载原理Helm 通过values.yaml模板化管理 Kubernetes 资源install.sh生成最终配置文件实现声明式部署。5.3️AI 辅助部署解决环境兼容性问题推荐场景本地环境配置复杂如 Docker 版本冲突、依赖缺失操作流程Clone 项目git clone https://github.com/higress-group/himarket.git在Cursor/Qoder/Claude Code等 AI 工具中输入阅读 deploy 目录下的部署文档帮我用 Docker Compose 部署 HiMarketAI 自动执行识别本地环境Docker 版本、依赖缺失生成修复脚本如apt install curl jq生成配置文件~/himarket-install.env执行install.sh无阻塞部署优势自动解决环境兼容性问题避免手动排查 80% 的部署失败原因。第6章 服务卸载与升级6.1 服务卸载两种部署方式通用卸载命令执行后会自动清理所有服务、数据、配置# 进入对应部署目录docker/helm后执行./install.sh--uninstall6.2 服务升级无需额外操作重新运行install.sh脚本即可脚本会自动检测已有部署环境直接提供升级选项一键完成版本升级。第7章 配置说明install.sh脚本的配置逻辑标准化所有配置可复用、可追溯交互模式脚本会逐步引导配置所有项镜像、数据库密码、服务凭证、默认用户、AI模型等配置持久化所有配置自动保存到~/himarket-install.env后续升级时自动复用无需重复配置配置模板.env.example是官方标准配置模板包含所有可配置项及默认值专门用于非交互模式日志记录部署日志自动保存到~/himarket-install.log方便排查问题❓常见问题排查指南问题类型解决方案部署失败cat ~/himarket-install.log查看详细日志需跳过部分初始化- 交互模式脚本提供“跳过”选项- 非交互模式设置环境变量SKIP_AI_MODEL_INITtrue重试初始化钩子执行钩子脚本bash hooks/post_ready.d/your_hook.sh位于部署目录查看容器日志docker compose logs -fDockerkubectl logs -n himarket pod-nameHelm✅总结部署决策树本地开发/测试生产环境/集群开始部署目标环境?Docker ComposeHelm运行 ./install.sh 交互式部署运行 ./install.sh 交互式部署AI 辅助部署推荐自动解决环境问题成功访问 http://localhost:5174核心原则优先用交互式脚本→ 自动化配置降低出错率AI 辅助解决环境问题→ 无需手动排查依赖配置复用机制→~/himarket-install.env确保升级一致性端口设计清晰→ 服务隔离避免冲突核心组件HiMarket依赖MySQL、Nacos、Higress、Redis四大基础服务自身包含4大业务模块部署核心两种方式均用install.sh脚本支持交互/非交互模式配置自动保存复用快速上手本地部署首选Docker Compose交互式脚本AI工具可解决环境兼容问题运维便捷一键卸载、一键升级日志钩子脚本让问题排查更简单。