EasyClick 云控系统部署全流程：从宝塔安装到设备上线

云控把管理端搬上了云。设备分散在各地也能收拢到一个网页里，下发脚本、回收数据都在浏览器里完成。很多人看完云控的功能介绍后，下一步就是“怎么装”，这篇把从零到跑通的完整流程走一遍：环境准备、程序安装、数据库配置、进程守护、防火墙放行、设备接入，每一步都不省略。

部署前准备和七步安装

一台 Linux 服务器（Ubuntu 18.04 / CentOS 均可），Windows 也能装但推荐 Linux，配置看设备量：几十台手机 2 核 4G 足够，上百台建议 4 核 8G 以上。

必备软件有四个：MySQL 5.7 存储设备、任务、脚本、数据；Redis 4 做缓存层，设备心跳和实时状态走 Redis；Supervisor 做进程守护，保证云控程序挂了自动重启；Nginx（可选）做反向代理，用于域名配置和 HTTPS。推荐用宝塔面板一键安装以上套件，省去手动编译的麻烦。

EasyClick 云控程序是一个 Go 编译的二进制文件（ecloudgo），从官方群文件或网盘下载 zip 包即可。云控 5.5.0 以上版本支持安卓、iOS 脱机版、iOS USB 版、鸿蒙 Next USB 版四端统一接入。

东西备齐，剩下的就是照着装，坑基本都藏在版本和配置上。第 1 步，宝塔安装 MySQL + Redis + Supervisor。 进入宝塔面板，软件商店搜索并安装 MySQL 5.7（注意版本，MySQL 8.0 有字符集兼容问题，需要额外处理）、Redis、Supervisor 进程守护、phpMyAdmin（管理 MySQL 用），安装完成后在宝塔首页确认这几个服务状态都是运行中。

第 2 步，上传云控程序。 在宝塔文件管理中新建文件夹 /www/wwwroot/ecloudgo，将下载的云控 zip 包上传到这个目录并解压。解压后你会看到 ecloudgo 二进制文件和 config 配置目录。

第 3 步，新建数据库。 在宝塔中新建数据库：数据库名 ecloudgo、用户名 ecloudgo、密码 ecloudgo（生产环境建议改成强密码）。然后进入 phpMyAdmin，给 ecloudgo 用户分配全局权限（编辑权限 → 全选 → 执行）。

第 4 步，编辑数据库配置。 进入文件管理，找到 config/config.toml，编辑数据库连接信息：

[database]
link = "mysql:ecloudgo:ecloudgo@tcp(localhost:3306)/ecloudgo?loc=Local&parseTime=true"

注意：?loc=Local&parseTime=true 这个后缀不能少，否则数据入库的时间会不对，少了时间全乱，这是从老版本升级到 5.7.0 以上时最容易踩的坑。

第 5 步，配置进程守护。 进入宝塔首页 → Supervisor → 添加进程守护：名称 ecloud、运行目录 /www/wwwroot/ecloudgo、启动命令 ./ecloudgo。启动后查看日志，如果看到正常监听端口的输出，说明启动成功。

第 6 步，放行端口。 云控默认端口是 8098，需要放行两个地方：宝塔安全里放行 8098，云服务商安全组（阿里云/腾讯云控制台）放行 8098。如果需要 MCP 功能，还要放行 8187 端口（MCP 服务端口）。

第 7 步，访问云控。 浏览器打开 http://你的服务器 IP:8098，默认账号 admin，密码 admin123，登录后第一时间改密码。

设备接入、排障与升级

云控装好后，下一步是把手机接进来。不同设备类型接入方式不同，但都指向同一个云控地址。安卓设备：打开 EasyClick APP，进入菜单 → 企业云配置，填写云控地址（IP:8098 或域名）和设备编号（和云控后台设备列表的编号保持一致），点击测试通道，成功后重启 APP；如果是正式发布版，在打包时填写云控地址并打企业版本的包，安装后自动连接。iOS 脱机版：打开脱机版 APP，进入设置 → 云控设置，输入云控地址和编号，测试成功后重启。iOS USB 版：打开中控，进入中控设置 → 云控地址，填写地址后保存重启，编号默认使用设备 ECID，也可以设置为别名（建议用纯英文+数字）。鸿蒙 Next USB 版与 iOS USB 版类似，在中控设置中填写云控地址，编号默认使用设备序列号。

设备连不上时依次排查：设备网络能否访问服务器 8098 端口；设备编号是否和后台一致；云控程序是否正常运行（Supervisor 状态）；调试版出现数字签名错误时，连接 IDE 运行一次脚本即可。任务不下发则按顺序查：设备是否在线（监控列表能看到设备状态）；任务是否配置为“单次”且已执行过；脚本是否正确下载（看设备任务日志）；多租户场景下是否给租户分配了设备量和过期时间。如果 MySQL 版本是 8.0，可能遇到 Illegal mix of collations 错误，解决方案是统一数据库和表的字符集排序规则为 utf8mb4_general_ci。

设备量超过 100 台时建议做几项优化：运行云控目录下的 ./opt.sh 系统优化脚本；Supervisor 配置中增加 minfds=65535（主配置和子配置都加）后重启云控；MySQL 适当调大 max_connections（默认 151，建议 500+）；Redis 配置 maxmemory 限制并设置淘汰策略。

升级新版本时，先备份数据库和文件，再上传新的 ecloudgo 二进制文件和 config 目录内容，编辑数据库信息（config.toml），在 Supervisor 中修改为新的二进制文件路径，点击重启。升级到 5.7.0 以上版本时，记得在 config.toml 的 database link 后面加 ?loc=Local&parseTime=true。整个部署流程拆开来看就是：装环境 → 放程序 → 配数据库 → 起进程 → 开端口 → 接设备，最关键的坑有两个，MySQL 字符集问题和 ?loc=Local&parseTime=true 时间配置。中过招吗？多半都有，这两个踩过一次就记住了。云控系统支持私有化部署，所有数据都在你自己的服务器上，不经过任何第三方，对数据安全敏感的团队是比 SaaS 方案更放心的选择。