MacOS 微服务网关双雄：Nacos + Higress 安装与 Dubbo 配置实战

文章目录

[MacOS 微服务网关双雄：Nacos + Higress 安装与 Dubbo 配置实战](#MacOS 微服务网关双雄：Nacos + Higress 安装与 Dubbo 配置实战)
[一、Docker Higress命令](#一、Docker Higress命令)
二、Higress控制台
三、Nacos下载
四、Nacos控制台
[五、Application.yml Dubbo 核心配置 - 对接 Nacos 注册中心](#五、Application.yml Dubbo 核心配置 - 对接 Nacos 注册中心)

一、Docker Higress命令

/Library/DockerResource/higress

bash 复制代码

docker run -d --rm --name higress-ai \
  -v /Library/DockerResource/higress:/data \
  -e O11Y=on \
  -p 8001:8001 -p 8081:8080 -p 8443:8443 \
  higress-registry.cn-hangzhou.cr.aliyuncs.com/higress/all-in-one:latest

指令作用

参数	作用
`-d`	后台运行容器
`--rm`	容器停止后自动删除，避免残留
`--name higress-ai`	自定义容器名称，方便管理
`-v /Library/DockerResource/higress:/data`	挂载宿主机目录到容器，实现文件共享
`-e O11Y=on`	开启可观测性（监控、日志、追踪）
`-p 8001:8001`	映射 UI 控制台端口
`-p 8081:8080`	映射 HTTP 网关端口（解决 8080 冲突）
`-p 8443:8443`	映射 HTTPS 网关端口

二、Higress控制台

映射 UI 控制台端口8001：http://localhost:8001/init

三、Nacos下载

Nacos下载地址、版本我选了3.x ：https://nacos.io/download/nacos-server

本地路径：/Applications/nacos

配置文件路径：/Applications/nacos/conf/application.properties

在**/Applications/nacos/bin**启动或关闭Nacos

bash 复制代码

# ===================== Nacos 启动/关闭指令（基于 /Applications/nacos/bin 目录）=====================
# 前提：需先进入 Nacos 的 bin 目录，执行命令：cd /Applications/nacos/bin
# 说明：-m standalone 表示以「单机模式」启动（非集群），适合开发/测试环境

# Windows 系统 - 启动 Nacos（单机模式）
startup.cmd -m standalone

# Linux / Mac 系统 - 启动 Nacos（单机模式）
sh startup.sh -m standalone

# ===================== 补充：Nacos 关闭指令 =====================
# Windows 系统 - 关闭 Nacos
# shutdown.cmd

# Linux / Mac 系统 - 关闭 Nacos
# sh shutdown.sh

启动Nacos

四、Nacos控制台

网页控制台地址：http://127.0.0.1:8080/

默认账号：nacos 密码：nacos

五、Application.yml Dubbo 核心配置 - 对接 Nacos 注册中心

yaml 复制代码

# ===================== Dubbo 核心配置 - 对接 Nacos 注册中心 =====================
dubbo:
  # 注册中心配置（核心）
  registry:
    # Nacos 服务端地址配置
    # 说明1：nacos:// 固定协议头，指定注册中心类型为 Nacos
    # 说明2：127.0.0.1:8848 是 Nacos 服务端默认端口（非控制台 8080 端口）
    # 关键：8848 端口规则：Nacos 有默认端口偏移机制，8848+1000=9848（客户端gRPC请求端口）
    # 补充：8848+1001=9849（服务端gRPC请求端口），这两个端口是 Nacos 2.x 通信必需的
    # 说明3：username/password 是 Nacos 认证信息（默认均为 nacos）
    address: nacos://127.0.0.1:8848?username=nacos&password=nacos
    # 注册模式：instance 表示以实例维度注册（Dubbo 3.x 推荐模式）
    # 可选值：instance（实例级）/ interface（接口级，Dubbo 2.x 传统模式）
    register-mode: instance
  # 通信协议配置
  protocol:
    # 协议名称：tri 表示使用 Dubbo3 主推的 Triple 协议（基于 gRPC，兼容 HTTP/2）
    # 可选值：tri / dubbo（原生 Dubbo 协议）/ rest（REST 协议）等
    name: tri
    # 服务暴露端口：50051 是 Triple 协议默认推荐端口
    port: 50051
  # 消费者配置
  consumer:
    # 消费端调用超时时间：60000 毫秒（60秒），避免短时间内触发超时异常
    timeout: 60000
  # 提供者配置
  provider:
    # 提供端处理超时时间：60000 毫秒（60秒），适配复杂业务逻辑的处理耗时
    timeout: 60000

基础端口（默认8848）	偏移量	实际端口	用途
8848	+0	8848	Nacos核心服务端口（HTTP API、注册发现核心通信）
8848	+1000	9848	客户端向服务端发起gRPC请求的端口（最常用的端口）
8848	+1001	9849	服务端向客户端发起gRPC请求的端口