装云控最容易卡的地方不是程序本身。是 MySQL 版本。
上周有个客户现场,MySQL 装的 8.0,起来就报 Illegal mix of collations。查了半天才发现跟云控没关系,是字符集排序规则不统一。装 MySQL 5.7 就没这事。
装之前先把环境和程序备齐
服务器用一台 Linux 机器,Ubuntu 18.04 或 CentOS 都行。Windows 也能装,推荐 Linux。配置看设备量:几十台手机 2 核 4G 足够,上百台建议 4 核 8G 以上。
必备软件四个:
- MySQL 5.7 , 存设备、任务、脚本、数据
- Redis 4 , 缓存层,设备心跳和实时状态走它
- Supervisor , 进程守护,云控挂了自动拉起来
- Nginx(可选), 反向代理,用于域名配置和 HTTPS
推荐用宝塔面板一键装这套,省去手动编译的麻烦。熟悉命令行的团队手动装同等组件也行。
云控程序是一个 Go 编译的二进制文件,叫 ecloudgo,从官方群文件或网盘下 zip 包。5.5.0 以上版本支持安卓、iOS 脱机版、iOS USB 版、鸿蒙 Next USB 版四端统一接入。
上图是装好之后的中控界面,多设备管理和任务调度都在这一页。
七步装到能登录
安装就七步,一步一步走。
一,宝塔装依赖。 软件商店搜并安装 MySQL 5.7、Redis、Supervisor、phpMyAdmin。装完在宝塔首页确认这几个服务都是运行中。版本盯紧点,8.0 有字符集问题要额外处理。
二,上传程序。 文件管理里新建 /www/wwwroot/ecloudgo,把 zip 传上去解压。解压后能看到 ecloudgo 二进制和 config 配置目录。
三,新建数据库。 库名、用户名、密码都用 ecloudgo,生产环境记得改成强密码。然后进 phpMyAdmin 给这个用户分配全局权限:编辑权限 → 全选 → 执行。
四,编辑数据库配置。 打开 config/config.toml,填连接信息:
[database]
link = "mysql:ecloudgo:ecloudgo@tcp(localhost:3306)/ecloudgo?loc=Local&parseTime=true"
?loc=Local&parseTime=true 这个后缀不能少。少了数据入库的时间会不对,这是老版本升到 5.7.0 以上时最容易漏的一条。
五,配进程守护。 宝塔首页 → Supervisor → 添加守护进程。名称填 ecloud,运行目录 /www/wwwroot/ecloudgo,启动命令 ./ecloudgo。启动后看日志,出现正常监听端口的输出就成了。
六,放行端口。 默认端口 8098,宝塔安全和云服务商安全组(阿里云/腾讯云控制台)两处都要放。要用 MCP 功能还得放 8187。
七,登录。 浏览器开 http://你的服务器IP:8098,默认账号 admin、密码 admin123。进去第一件事是改密码。默认密码不改,等于把门敞着。
四端设备怎么接进来
地址都是同一个云控地址,接法按类型分。
安卓:打开 EasyClick APP,菜单 → 企业云配置,填云控地址(IP:8098 或域名)和设备编号,编号要和后台设备列表一致。点测试通道,成功后重启 APP。正式发布版不用这么填,打包时把地址写进去、打企业版本的包,装上自动连。
iOS 脱机版:打开脱机版 APP,设置 → 云控设置,填地址和编号,测试通过后重启。
iOS USB 版:打开 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 以上记得补 ?loc=Local&parseTime=true。
关于 iEasyClick:手机自动化 AI 智能体平台,覆盖安卓免 root、iOS 免越狱(代理/蓝牙 HID/OTG HID)、鸿蒙 Next 三大生态,提供脚本开发、苹果群控、本地中控投屏与云控系统。→ 了解全部产品
想要真实跑起来?
本文介绍的方案均可基于 EasyClick 能力在 iEasyClick 落地。官网提供完整文档、开发工具与自动化产品,免费体验。