higress

环境要求

• 已在本机安装并可运行 Docker
• 能够拉取 higress-registry.cn-hangzhou.cr.aliyuncs.com 仓库镜像（网络可达）
• 本机 8001、8080、8443 端口未被其他程序占用

安装与启动步骤

1. 1确认 Docker 可用

   先确认本机已安装 Docker 且守护进程正常运行，否则后面的 docker run 会直接失败。

   docker version

   复制

2. 2启动 Higress 容器

   用官方 all-in-one 镜像一键启动，同时映射控制台和网关端口；配置文件会写到当前工作目录。

   docker run -d --rm --name higress-ai -v ${PWD}:/data 
           -p 8001:8001 -p 8080:8080 -p 8443:8443  
           higress-registry.cn-hangzhou.cr.aliyuncs.com/higress/all-in-one:latest

   复制

3. 3查看容器状态

   确认容器处于运行状态；若已退出，可用 docker logs higress-ai 查看失败原因。

   docker ps --filter name=higress-ai

   复制

4. 4访问控制台

   浏览器打开控制台入口，8001 是 UI 控制台，8080/8443 分别是网关的 HTTP/HTTPS 入口。

5. 5拉取超时换镜像源

   若拉取镜像超时，可换成北美或东南亚区域的镜像仓库地址重新执行启动命令。

   docker run -d --rm --name higress-ai -v ${PWD}:/data 
           -p 8001:8001 -p 8080:8080 -p 8443:8443  
           higress-registry.us-west-1.cr.aliyuncs.com/higress/all-in-one:latest

   复制

关键配置

如何确认成功

浏览器打开 http://localhost:8001 能看到 Higress 控制台界面，且 docker ps 中 higress-ai 容器状态为 Up。

常见问题

注意事项

• 启动命令中的 ${PWD} 是 bash 写法，Windows PowerShell 下需替换为当前目录的实际路径。
• 容器使用 --rm 参数，停止后自动删除，请不要把重要数据只放在容器内。
• 8001/8080/8443 三个端口用途不同，务必分别映射，否则控制台或网关无法访问。
• Kubernetes/Helm 等其它安装方式的详细步骤以官方 Quick Start 文档为准。