单机版安装

北极星支持单机版的安装架构，适用于用户在开发测试阶段，通过本机快速拉起北极星服务进行验证。

单机版包含以下4个组件：

  • polaris-console：可视化控制台，提供服务治理管控页面
  • polaris-server：控制面，提供数据面组件及控制台所需的后台接口
  • polaris-limiter: 分布式限流服务端，提供全局配额统计的功能
  • prometheus：服务治理监控所需的指标汇聚统计组件

单机版默认占用以下端口：

服务端监听端口信息

进程名 端口号 协议类型 用途
polaris-console 8080 http 北极星控制台页面端口
polaris-limiter 8100 http 限流可用配额下发客户端数据通信
polaris-limiter 8101 grpc 限流可用配额下发客户端数据通信
polaris-server 8090 http OpenAPI，可以调用注册、配置、治理规则的接口
polaris-server 8761 http eureka 协议通信
polaris-server 8848 http nacos1.x 协议通信
polaris-server 9848 grpc nacos2.x 协议通信
polaris-server 8091 grpc 注册发现/服务治理规则下发客户端数据通信
polaris-server 8093 grpc 配置中心客户端数据通信
polaris-server 15010 grpc xds 数据通信端口

下载软件包

单机版的安装需要依赖单机版软件包，单机版软件包的命名格式为polaris-standalone-release_*.zip：

单机版

执行所有安装之前，需要下载软件包，可以从以下2个地址下载单机版软件包，请选择最新的release版本：

下载后需要进行解压，如果有需要自定义单机版相关组件的监听端口，需修改压缩包内的port.properties文件。

port.properties 文件概览

polaris_eureka_port=8761
polaris_open_api_port=8090
polaris_service_grpc_port=8091
polaris_config_grpc_port=8093
polaris_prometheus_sd_port=9000
polaris_xdsv3_port=15010
polaris_console_port=8080
prometheus_port=9090
pushgateway_port=9091
nacos_http_port=8848

使用 Linux 安装

下载Linux单机版软件包（polaris-standalone-release_$version.linux.$arch.zip），执行安装命令：

unzip polaris-standalone-release_$version.linux.$arch.zip

cd polaris-standalone-release_$version.linux.$arch

bash install.sh

使用 Window 安装

注意事项：

  • 依赖powershell 5.0及以上版本（Windows 10及以上版本默认安装）
  • 需要以管理员身份运行安装脚本，执行powershell需要进行授权操作
  • 安装脚本可能遭到系统安全软件的误杀，请在安全软件中执行信任操作

下载Windows单机版软件包（polaris-standalone-release_$version.windows.$arch.zip），执行安装命令：

执行解压：polaris-standalone-release_$version.windows.$arch.zip

进入目录：polaris-standalone-release_$version.windows.$arch

执行脚本：install.bat

使用 Mac 安装

注意事项：

  • 请在【关于本机】设置中查看Mac机器的芯片类型（Intel/Apple）
  • Intel芯片请使用amd64的软件包，Apple芯片请使用arm64的软件包

下载Mac单机版软件包（polaris-standalone-release_$version.darwin.$arch.zip），执行安装命令：

unzip polaris-standalone-release_$version.darwin.$arch.zip

cd polaris-standalone-release_$version.darwin.$arch

bash install.sh

使用 Docker 安装

查看当前镜像需要暴露的端口信息

docker image ls -a | grep "polarismesh/polaris-standalone" | awk '{print $3}' | xargs docker inspect --format='{{range $key, $value := .Config.ExposedPorts}}{{ $key }}{{end}}'| awk '{ gsub(/\/tcp/, " "); print $0 }'

执行以下命令启动

# Publish a container's port(s) to the host
docker run -d --privileged=true \
-p 15010:15010 \
-p 8101:8101 \
-p 8100:8100 \
-p 8080:8080 \
-p 8090:8090 \
-p 8091:8091 \
-p 8093:8093 \
-p 8761:8761 \
-p 8848:8848 \
-p 9848:9848 \
-p 9090:9090 \
-p 9091:9091 polarismesh/polaris-standalone:latest

使用 Docker Compose 安装

下载 Docker Compose 安装包: polaris-standalone-release_$version.docker-compose.zip

创建mysql、redis 存储卷，方便数据持久化

docker volume create --name=vlm_data_mysql
docker volume create --name=vlm_data_redis

启动服务

执行解压：polaris-standalone-release_$version.docker-compose.zip

进入目录：polaris-standalone-release_$version.docker-compose

执行命令：docker-compose up

安装验证

打开控制台

在浏览器里输入北极星控制台地址（127.0.0.1:8080），非容器化场景127.0.0.1可替换成安装北极星的机器host。

  • 登录控制台的默认登录账户信息
用户：polaris
密码：polaris

控制台

新建服务

进入服务列表页面，点击【新建】按钮，确认是否可以新建服务。新建服务成功表示安装成功

新建服务