ThingsPanel 本地部署教程（Windows）

ThingsPanel 本地部署教程（Windows）

本教程基于 ThingsPanel All-in-One Installer 在 Windows 本地完成一键部署。

一、环境准备

部署前请确保已安装以下工具：

环境全部就绪后再继续下一步。

二、部署 ThingsPanel

方式一：一键命令安装（推荐）

1. 打开 Windows 开始菜单，搜索 PowerShell，右键选择以管理员身份运行。

2. 在 PowerShell 中执行以下命令：

   irm https://install.thingspanel.io/install.ps1 | iex
   

3. 安装脚本会自动完成环境检查、镜像拉取、服务启动等步骤。首次运行可能需要 3~5 分钟。

4. 当看到类似下图的提示时，说明安装成功：

   

   图：PowerShell 安装成功输出

   关键信息如下：

   • Web UI：http://localhost:8080
   • MQTT：localhost:1883
   • 安装目录：C:\ThingsPanel

   常用命令：

   # 查看服务状态
   docker compose -f "C:\ThingsPanel\docker-compose.yml" ps
   
   # 查看后端日志
   docker compose -f "C:\ThingsPanel\docker-compose.yml" logs -f backend
   
   # 停止服务
   docker compose -f "C:\ThingsPanel\docker-compose.yml" down
   
   # 升级
   powershell -File "C:\ThingsPanel\upgrade.ps1"
   

方式二：Windows 图形安装包

如果不喜欢命令行，也可以直接下载官方提供的 Windows 图形化安装包：

1. 访问 https://install.thingspanel.io/
2. 点击 Download Windows 下载安装包。
3. 按向导完成安装。

图：ThingsPanel 官方安装页面

安装完成后，桌面上会出现 ThingsPanel 图标：

图：桌面上的 ThingsPanel 快捷方式

三、访问系统

1. 双击桌面上的 ThingsPanel 图标，或直接在浏览器中打开：

   http://localhost:8080
   

2. 首次打开会看到登录/初始化页面：

   

   图：ThingsPanel 登录页面

3. 输入初始账号密码，符合格式要求即可，点击确认：

   • 账号：admin@thingpanel.io
   • 密码：ThingSpan@123

   

   图：填写账号密码

4. 登录成功后进入首页，看到设备统计、资源监控等面板，即表示部署完成。

   

   图：ThingsPanel 首页

四、完成

到这里，ThingsPanel 已在本地 Windows 环境部署完成。后续可以通过 http://localhost:8080 访问 Web 控制台，使用 MQTT 端口 1883 接入设备进行测试。