📦 准备工作
在开始之前,请确认以下内容:
- sentinel-dashboard-1.8.10.jar 下载完成,放置到,路径例如:
C:\javaee\sentinel - JDK 已安装,且知道安装路径(可在 CMD 中用
where java查看) - 以管理员身份运行所有命令(重要!)
第一步:下载 WinSW 工具
- 访问 WinSW 发布页面:
github.com/winsw/winsw… - 下载
WinSW-x64.exe(适用于 64 位 Windows) - 将下载的文件放入 Nacos 的
bin目录:
C:\javaee\sentinel\ - 将
WinSW-x64.exe重命名为:
sentinel-dashboard.exe
第二步:创建配置文件
在同一个 bin 目录下,新建一个文件叫 sentinel-dashboard.xml,用记事本打开,粘贴以下内容:
xml
<service>
<!-- 1. 服务ID,在Windows系统中必须唯一 -->
<id>sentinel-dashboard</id>
<!-- 2. 服务在服务管理器中显示的名称 -->
<name>Sentinel Dashboard</name>
<!-- 3. 服务描述 -->
<description>阿里Sentinel流量控制台服务</description>
<!-- 4. 指定Java执行环境 -->
<!-- 如果Java已配置环境变量,直接写java即可;否则建议使用绝对路径,比如:C:\Program Files\Java\jdk1.8.0_301\bin\java.exe -->
<!-- 关键点:这里直接指向Java,而不是cmd,避免弹窗 -->
<executable>C:\javaee\jdk\jdk-11.0.10\bin\java.exe</executable>
<!-- 5. 启动参数:-jar后跟你的jar包文件名,可以加上端口参数 -->
<arguments>-Dserver.port=8080 -jar sentinel-dashboard-1.8.10.jar</arguments>
<!-- 6. 设置开机自启动模式 -->
<startmode>Automatic</startmode>
<!-- 7. 日志配置(可选,推荐配置以方便排查问题) -->
<logpath>%BASE%\logs</logpath>
<logmode>rotate</logmode>
</service>
⚠️ 重要:将上面所有 C:\javaee\sentinel
替换为你的**实际 sentinel 路径**,并将C:\Program Files\Java\jdk-17\bin\java.exe` 替换为你的实际 JDK 路径。
第三步:安装服务
以管理员身份打开命令提示符(CMD),依次执行:
cmd
cd /d C:\javaee\sentinel
sentinel-dashboard.exe install
看到类似 Service 'sentinel-dashboard' installed successfully 的提示,说明安装成功。
第四步:启动服务并设为开机自启
cmd
net start sentinel-dashboard
然后设置服务为开机自动启动(两种方式任选):
方式一(命令) :
cmd
sc config sentinel-dashboard start= auto
方式二(图形界面) :
- 按
Win + R,输入services.msc回车 - 找到
sentinel-dashboard Service,右键 → 属性 - 启动类型选择 "自动" ,点击确定
第五步:验证是否成功
- 打开浏览器访问:
http://localhost:8080 - 默认账号/密码:
sentinel/sentinel
如果能正常打开控制台页面,说明服务已成功运行!
常用管理命令
| 操作 | 命令 |
|---|---|
| 安装服务 | sentinel-dashboard.exe install |
| 卸载服务 | sentinel-dashboard.exe uninstall |
| 启动服务 | net start sentinel-dashboard |
| 停止服务 | net stop sentinel-dashboard |
| 查看服务状态 | sc query sentinel-dashboard |
❗ 常见问题排查
| 问题 | 解决方法 |
|---|---|
java 路径找不到 | 检查 XML 中 <executable> 路径是否正确 |
| 端口 8848 被占用 | 停止占用该端口的程序,或修改 Nacos 配置 |
| 服务启动后立即停止 | 查看 bin\logs 目录下的日志文件排查错误 |
sentinel-dashboard.exe 不存在 | 确认已下载 WinSW 并正确重命名 |
| 服务安装失败 | 确认 CMD 是以管理员身份运行的 |
✅ 最终文件清单
你的 C:\javaee\sentinel 目录下应该包含这两个关键文件:
text
sentinel-dashboard.exe ← WinSW 工具(必须)
sentinel-dashboard.xml ← 配置文件(必须)
这样就完成了!重启电脑后,sentinel-dashboard 会自动在后台启动,无需手动操作 🎉