Docker Compose 是用于定义和运行多容器 Docker 应用程序的工具。通过它,我们可以使用 YAML 文件来脱离 K8s 集群来实现 Higress 网关的独立部署。

注意

Standalone 模式没有大规模生产使用过,目前主要用于本地部署测试的场景,如果生产部署更建议云原生模式部署

安装 Higress

基于 Docker Compose 部署时,Higress 网关由如下几个服务组成:

  • apiserver:基础设施服务。负责模拟 K8s 的 API Server;
  • controller:控制面服务一号。负责配置收集整合所有的配置数据和服务列表;
  • pilot:控制面服务一号。负责下发网关路由数据;
  • gateway:数据面服务。负责承载实际的网关请求;
  • console:Higress 网关控制台

安装命令

  1. curl -fsSL https://higress.io/standalone/get-higress.sh | bash -s — [DESTINATION] [OPTIONS…]

安装参数

参数名参数说明默认值
DESTINATION目标安装目录./higress
-a
—auto-run
配置完成后自动启动 Higress 网关
-c CONFIG_URL
—config-url CONFIG_URL
配置服务的 URL。
- 若使用独立部署的 Nacos 服务(版本不低于 2.0.0),URL 格式为:nacos://192.168.0.1:8848
- 若在本地磁盘上保存配置,URL 格式为:file://opt/higress/conf
—use-builtin-nacos使用内置的 Nacos 服务。不建议用于生产环境。如果设置本参数,则无需设置-c参数
—nacos-ns=NACOS_NAMESPACE用于保存 Higress 配置的 Nacos 命名空间 IDhigress-system
—nacos-username=NACOS_USERNAME用于访问 Nacos 的用户名。仅用于 Nacos 启动了认证的情况下
—nacos-password=NACOS_PASSWORD用于访问 Nacos 的用户密码。仅用于 Nacos 启动了认证的情况下
-k KEY
—data-enc-key=KEY
用于加密敏感配置数据的密钥。长度必须为 32 个字符。若未设置,Higress 将自动生成一个随机的密钥。若需集群部署,此项必须设置随机字符串
—nacos-port=NACOS_PORT内置 NACOS 服务在服务器本地监听的端口8848
—gateway-http-port=GATEWAY_HTTP_PORTHigress Gateway 在服务器本地监听的 HTTP 端口80
—gateway-https-port=GATEWAY_HTTPS_PORTHigress Gateway 在服务器本地监听的 HTTPS 端口443
—gateway-metrics-port=GATEWAY_METRIC_PORTHigress Gateway 在服务器本地监听的用于暴露运行指标端口15020
—console-port=CONSOLE_PORTHigress Console 在服务器本地监听的端口8080
-r
—rerun
在 Higress 已配置完成后重新执行配置流程
-h
—help
显示帮助信息