osmiling/sentinel-dashboard

阿里Sentinel Dashboard Docker镜像文档

快速参考

• 开源代码地址：https://github.com/alibaba/Sentinel
• 官方文档地址：官网
• Docker镜像维护：https://github.com/loulangogogo/docker-hub
• 提交问题：https://github.com/loulangogogo/docker-hub/issues

注：本Docker镜像基于GitHub开源代码构建，如有侵权请联系作者删除。

镜像概述和主要用途

该镜像为阿里巴巴Sentinel Dashboard的容器化版本，采用Redis作为持久化存储方案，用于实现分布式系统的流量控制、熔断降级、系统负载保护等功能。通过Web控制台可直观配置和管理各类流量规则，支持与Spring Boot等主流框架集成，适用于微服务架构下的流量防卫场景。

核心功能和特性

• 流量控制：支持QPS、线程数等多种限流模式，灵活控制接口访问频率
• 熔断降级：当服务出现异常时自动熔断，避免级联故障
• 系统负载保护：监控系统CPU、内存等指标，防止系统过载
• Redis持久化：规则配置存储于Redis，支持集群、哨兵等多种Redis部署模式
• Web控制台：提供可视化界面，方便配置和监控各类规则
• 环境变量配置：支持通过环境变量灵活配置端口、Redis连接信息等参数

使用场景和适用范围

• 微服务架构下的API接口流量控制
• 分布式系统的熔断降级保护
• 高并发场景下的系统负载管理
• 需要规则持久化的Sentinel部署环境
• Spring Boot应用的流量防卫集成

初始化实例

前置条件

该镜像依赖外部Redis服务进行规则持久化，使用前需确保Redis服务已部署并可访问。

Docker命令启动

bash
docker run --name sentinel-dashboard \
  -e REDIS_HOST=127.0.0.1 \
  -e REDIS_PORT=6379 \
  -p 8080:8080 \
  osmiling/sentinel-dashboard:1.8.9-redis

Docker Compose配置

yaml
version: '3.1'

services:
  sentinel-dashboard:
    image: osmiling/sentinel-dashboard:1.8.9-redis
    container_name: sentinel-dashboard
    logging:
      driver: json-file
      options:
        max-size: "100m"
        max-file: "5"
    restart: always
    ports:
      - "8619:8619"  # 宿主机端口:容器内端口
    environment:
      SERVER_PORT: 8619  # 控制台端口
      REDIS_HOST: 127.0.0.1  # Redis主机地址
      REDIS_PORT: 6379  # Redis端口
      REDIS_PASSWORD: 123456  # Redis密码（如有）
      REDIS_DATABASE: 15  # Redis数据库编号
    volumes:
      - /etc/localtime:/etc/localtime:ro  # 同步系统时间
      - ./logs:/root/logs  # 挂载日志目录

环境变量配置

注意：环境变量对应application.properties配置，若环境变量无法满足需求，可通过挂载自定义application.properties文件进行配置。

客户端应用集成（Spring Boot）

1. 引入依赖

xml
<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-sentinel</artifactId>
</dependency>
<dependency>
    <groupId>com.alibaba.csp</groupId>
    <artifactId>sentinel-datasource-redis</artifactId>
</dependency>

注意：sentinel-core 1.8.5和1.8.6版本存在系统规则无法正常使用的问题，需升级至1.8.7及以上版本。

2. 配置application.yml

yaml
spring:
  cloud:
    sentinel:
      enabled: true
      eager: true  # 取消控制台懒加载，启动即初始化
      transport:
        port: 7890  # 客户端与控制台通信端口
        dashboard: 127.0.0.1:8080  # Sentinel控制台地址
      datasource:
        # 系统规则
        ds1:
          redis:
            host: 127.0.0.1
            database: 15
            port: 6379
            password: dsk806888
            rule-key: 'Sentinel:Config:${spring.application.name}:system'
            channel: 'Sentinel:Channel:${spring.application.name}:system'
            rule-type: system
        # 流控规则
        ds2:
          redis:
            host: 127.0.0.1
            database: 15
            port: 6379
            password: dsk806888
            rule-key: 'Sentinel:Config:${spring.application.name}:flow'
            channel: 'Sentinel:Channel:${spring.application.name}:flow'
            rule-type: flow
        # 降级规则
        ds3:
          redis:
            host: 127.0.0.1
            database: 15
            port: 6379
            password: dsk806888
            rule-key: 'Sentinel:Config:${spring.application.name}:degrade'
            channel: 'Sentinel:Channel:${spring.application.name}:degrade'
            rule-type: degrade
        # 热点参数规则
        ds4:
          redis:
            host: 127.0.0.1
            database: 15
            port: 6379
            password: dsk806888
            rule-key: 'Sentinel:Config:${spring.application.name}:param-flow'
            channel: 'Sentinel:Channel:${spring.application.name}:param-flow'
            rule-type: param-flow
        # 授权规则
        ds5:
          redis:
            host: 127.0.0.1
            database: 15
            port: 6379
            password: dsk806888
            rule-key: 'Sentinel:Config:${spring.application.name}:authority'
            channel: 'Sentinel:Channel:${spring.application.name}:authority'
            rule-type: authority

规则key和通道channel格式说明：
rule-key: "Sentinel:Config:" + 应用名称 + 规则类型（如system、flow）
channel: "Sentinel:Channel:" + 应用名称 + 规则类型
需与控制台配置保持一致，否则规则无法生效。