MeterSphere+Docker云服务器部署实战：从安装到运维避坑指南

1. 先聊清楚为什么我最后选了MeterSphere Docker这台组合1.1 从测试平台的选型说起如果你所在团队正在为“用什么平台管理接口测试、性能测试、UI 测试”头疼MeterSphere 大概率是被 mention 最多的那个。它是一款开源持续测试平台把接口测试、性能测试、UI 测试和测试跟踪做在一个入口里后端还集成了 JMeter 引擎说白了就是给你一个能开着浏览器就操作的全家桶。我最初尝试的时候用的是官网提供的 Linux 单机安装包确实能装但后患无穷。Python 环境、JDK、MySQL、Redis、Kafka 各自版本对不上升级一次恨不得重新搭一台机器。后来索性在云服务器上全部改成 Docker 部署测试环境从“重装修”变成了“搬箱子”这才意识到为什么 MeterSphere 官方把 Docker 镜像作为首选分发方式。这篇文章不是抄文档而是把我从买服务器到部署成功、再到后续运维踩过的具体坑一条条复盘给你。适合刚接触 MeterSphere 的测试开发、想在公司内网搭一套测试平台的后端同学以及那些和我一样被“单机安装依赖地狱”折磨过的人。1.2 云服务器配置别一开始就买高配很多人在选云服务器时会有一个错觉配置越高越稳妥。但 MeterSphere 那套组件MySQL、Redis、Kafka、MinIO、前端、后端都跑在 Docker 里内存是主要瓶颈。我实测下来最基础的 2 核 4G 服务器是可以跑起来的但如果同时执行较大规模的性能测试内存直接告急。建议你至少选4核8G磁盘给到40G 以上 SSD这基本是“能用”和“用得舒服”的分界线。另外购买时只需要选装 Ubuntu 22.04 或 CentOS 7.9 这种带 systemd 的干净系统不用预装什么宝塔面板后续 Docker 安装反而少一层干扰。安全组里提前放行你要映射的端口比如 8080这是新手最容易忽略的坑——服务明明启动了浏览器就是访问不了十有八九是云控制台的安全组规则没放行。2. Docker 基础安装里的那些坑一次讲透2.1 用官方脚本装 Docker先解决网络问题再说话很多教程第一行就让你执行curl -fsSL https://get.docker.com | bash这个命令在海外服务器上很流畅但在国内云服务器上可能会卡住甚至超时。因为脚本默认拉取的是 Docker 官方源速度看运气。如果你遇到类似问题可以参考我当时的做法# 先安装基础工具 sudo apt update sudo apt install -y curl # 使用阿里云镜像源安装 docker-ce curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg echo deb [archamd64 signed-by/usr/share/keyrings/docker-archive-keyring.gpg] https://mirrors.aliyun.com/docker-ce/linux/ubuntu $(lsb_release -cs) stable | sudo tee /etc/apt/sources.list.d/docker.list /dev/null sudo apt update sudo apt install -y docker-ce docker-ce-cli containerd.io注意$(lsb_release -cs)会获取系统代号Ubuntu 22.04 对应的是 jammyCentOS/RHEL 则用 yum 仓库配置核心思路一样换成可达性更好的镜像源。装完后先别急着跑容器检查一下 Docker 服务是否开机自启sudo systemctl enable docker sudo systemctl start docker sudo systemctl status docker如果你不想每次敲命令都带 sudo可以把当前用户加入 docker 用户组然后重新登录sudo usermod -aG docker $USER这一步做完之后再用docker info确认网络、存储驱动都正常。千万不要直接跳到“装 MeterSphere”这一步Docker 引擎本身有问题的话后面所有报错都会被放大。2.2 docker compose 的独立安装版本坑比想象中多MeterSphere 的安装脚本依赖 docker compose 命令。注意不是老式的docker-compose是新版插件式的docker compose子命令。Ubuntu 上通过 docker-ce 源安装的 Docker 通常自带 compose 插件但如果你使用的是旧版或手动安装的 Docker就得单独装。我建议直接安装独立的 compose 二进制兼容性最好sudo curl -L https://github.com/docker/compose/releases/download/v2.20.3/docker-compose-$(uname -s)-$(uname -m) -o /usr/local/bin/docker-compose sudo chmod x /usr/local/bin/docker-compose docker-compose version有两点必须提醒你如果服务器上同时存在docker-compose和docker composeMeterSphere 安装脚本会优先调用哪个不同版本行为不一样。最稳妥的做法是统一使用docker compose插件这样不会出现“脚本调用了老版本 compose结果不识别新语法”的怪问题。我最初使用的是 compose v1 的 1.29.2 版本执行 MeterSphere 安装脚本时报过 “service configuration must contain either image or build” 之类的错误后来升级到 v2.20.3 就正常了。所以如果你用的是旧版建议直接升级。2.3 验证 Docker 环境不只是 docker version判断 Docker 能不能用很多人就跑一句docker version看个版本号。但更重要的检查项有这些# 检查是否能够正常拉取镜像 docker pull hello-world # 检查容器是否能正常运行并写日志 docker run --rm hello-world # 检查 compose 版本是否高于 2.x docker compose version # 查看磁盘空间Docker 镜像会把 /var/lib/docker 撑起来 df -h /var/lib/docker这其中docker run --rm hello-world是最能说明问题的它能跑通代表 Docker daemon、底层 runC、网络桥接基本都正常。如果这一步卡住先别碰 MeterSphere直接排查 Docker 引擎。别问我为什么这么强调我第三次部署时就是在这里踩了坑——换了个云厂商镜像Docker 装好了但 overlay2 存储驱动异常导致所有容器一启动就挂排查了一天才发现是操作系统的内核模块问题。3. 获取 MeterSphere 安装包与安装前的配置调整3.1 下载安装包选对版本比选对新功能更重要MeterSphere 有 v1.x 和 v2.x 两个大版本社区目前主要维护 v2.x。下载时直接从 GitHub Releases 里找最新的 release 包或者用官网下载链接。我在服务器上的做法是cd /opt wget https://github.com/metersphere/metersphere/releases/download/v2.10.6/metersphere-installer-v2.10.6.tar.gz tar zxvf metersphere-installer-v2.10.6.tar.gz cd metersphere-installer-v2.10.6这里有个很多人没注意的细节一定要下载完整版 installer而不是单独下载镜像或 docker-compose.yml。installer 里不仅包含了 compose 配置还有初始化数据库、健康检查、升级脚本单独去拼 YAML 文件会非常痛苦。另外GitHub 在国内下载可能很慢。如果速度实在不行可以考虑用镜像站点或者把安装包传到服务器。安装包大小约几百 MB包含很多镜像的编排定义但不包含镜像本身所以下载时间还是在可接受范围内的。3.2 解开 docker-compose.yml 的密码箱解压后你会看到一个docker-compose.yml文件里面定义了 mysql、redis、kafka、minio、backend、frontend 等服务。不要直接跑docker compose up -d因为默认配置里含有默认密码和对外端口直接跑虽然也能启动但后面的安全审计会找你麻烦。需要修改的关键项配置项默认值建议修改值原因MS_SERVER_PORT808018080 或 80避免与服务器上其他服务端口冲突初期建议保留 8080 方便排查MYSQL_ROOT_PASSWORDPassword123mysql至少 16 位强密码数据库对公网暴露时容易被扫描爆破MYSQL_MS_PASSWORDPassword123ms独立强密码应用连接库使用的密码别和 root 相同KAFKA_PASSWORD默认值修改为强密码Kafka 也是网络可访问组件MINIO_ACCESS_KEY/MINIO_SECRET_KEY默认值修改MinIO 用来存附件若暴露外网默认密钥等于裸奔修改方式有两种一是直接改docker-compose.yml里的 environment 字段二是通过 installer 目录下的安装配置模板来传递。我强烈建议使用 installer 自带的配置方式比如编辑install.conf或在安装时交互式输入这样升级时配置不容易被覆盖。你可能会问这些密码改了之后应用容器怎么知道实际上 backend 容器启动时是从环境变量读取这些配置而 installer 脚本会把这些变量注入到 compose 的 environment 里。所以只要在安装前改好后续容器创建时就会自动使用新密码。3.3 磁盘路径与日志保留没人提醒你的长期隐患不修改任何默认配置直接启动数据会写入/opt/metersphere/data这个目录。我建议你一定要规划好数据盘。举个例子我最初把系统装在 40G 的数据盘上跑了一个星期数据库和 MinIO 数据加起来不到 10G但 Kafka 和容器日志却占了七八 G差点把磁盘写满。所以在安装之前你可以提前做两件事把/opt/metersphere/data挂载到独立的数据盘。如果你的云服务器有数据盘先在系统里格式化并挂载到/data然后创建软链接sudo mkdir -p /data/metersphere sudo mv /opt/metersphere/data /opt/metersphere/data.bak sudo ln -s /data/metersphere /opt/metersphere/data给 Docker 容器配置日志轮转。编辑/etc/docker/daemon.json{ log-driver: json-file, log-opts: { max-size: 50m, max-file: 3 } }然后重启 Dockersudo systemctl restart docker这样容器日志最多占用 150M不会无限膨胀。这个配置在 MeterSphere 部署文档里不会写但实际运维时非常救命。4. 启动 MeterSphere从在线安装到健康检查4.1 执行安装脚本时的真实输出与判断一切配置就绪后在 installer 目录下执行./install.sh如果你是用 root 用户执行脚本会提示你 Docker 权限问题但一般能继续。整个安装过程大概分三个阶段阶段一拉取镜像。会依次拉取 mysql、redis、kafka、minio、backend、frontend 等镜像耗时取决于带宽。国内服务器建议提前配置 Docker 镜像加速器否则容易超时。阶段二启动基础设施。MySQL、Redis、Kafka、MinIO 容器先起来日志中会看到 “Waiting for MySQL ready” 之类的轮询。这里卡住最多的就是 MySQL 没有足够内存或数据卷权限问题。阶段三初始化数据库并启动应用。执行数据库初始化脚本然后启动 backend 和 frontend。看到类似MeterSphere is started successfully才算结束。有一个需要说明的地方安装脚本不是幂等的。如果你安装中途失败了不要直接重新执行./install.sh而是先执行./uninstall.sh如果有或把容器和数据卷清理干净再重来。我第二次部署就是没清理数据卷导致新旧容器共用同一个 MySQL 数据目录后面一直报权限错误。4.2 验证部署是否成功的三个关键接口部署完成后别急着打开浏览器。建议按下面三步验证第一步检查容器状态docker compose ps正常状态下所有服务的 STATUS 应该为Up或healthy取决于是否配置了 healthcheck。如果某个容器反复重启用下面的命令看日志docker compose logs -f backend第二步检查前端页面用浏览器访问http://服务器IP:8080能出现登录页说明前端容器没问题。如果访问不了回想我在第一节说的云服务器安全组是否放行端口、Ubuntu 自带的 ufw 防火墙是否放行端口。第三步调用健康检查接口MeterSphere 一般会暴露/health或/api/health之类的接口具体要看版本。可以通过 curl 判断curl -I http://127.0.0.1:8080/health返回 HTTP 200 基本就稳了。登录界面的默认账号一般是admin初始密码是metersphere不同版本可能差异第一次登录会强制修改。请注意登录后第一件事是改密码同时去“系统设置-用户”里关掉不必要的默认用户。4.3 首次登录前的初始化配置登录成功后你还需要做几个必须的初始化配置不然后面用起来会非常别扭设置系统邮箱在“系统设置-邮件设置”里配置 SMTP这样测试任务报告、告警通知才能发出去。如果公司没有现成的 SMTP 服务可以先跳过但接口测试用例失败后收不到通知会很被动。配置测试资源池在“测试资源池”里把本机资源池激活或者添加一台专门的执行机节点。如果你的服务器只有 2 核 4G建议把最大并发数调低比如 2避免执行性能测试时直接把服务器打挂。导入测试环境创建项目时设置测试环境的 Base URL、数据库连接等。这一步和部署无关但如果你不提前配置接口测试录制导出后跑到一半会发现请求地址还是 localhost。这些初始化配置虽然不直接影响“能登录”但会影响你能不能顺畅地用起来。花十分钟把邮箱和资源池配好比之后出了问题再回头折腾要省心得多。5. 部署之后日常运维与升级避坑记录5.1 资源占用观察2核4G到底够不够我最初按照最低配置 2 核 4G 部署实际运行时的资源占用大致如下组件内存占用稳定值备注MySQL600MB - 1GB随数据量增长会缓存大量索引Kafka400MB - 700MB日志堆积时内存上升Redis200MB - 300MB缓存占用低但线程多MinIO100MB - 300MB附件和测试报告存储backend800MB - 1.2GBJava 进程是最吃内存的frontend100MB - 150MBNginx 静态页面轻量这么算下来2 核 4G 基本就是压线运行。执行轻量级接口测试或 UI 测试时还能转但如果你要跑 JMeter 脚本压测负载机上会启新的执行进程内存瞬间暴涨容器很容易被系统 OOM Kill。所以如果你计划用 MeterSphere 做正经压测建议至少 4 核 8G并给 Docker 设置 6G 内存上限。另外记得定期清理不用的镜像和构建缓存docker image prune -af我见过很多人服务器磁盘被/var/lib/docker占满就是因为更新版本后旧镜像一直不清理。5.2 升级 MeterSphere 时我踩过的备份/回滚坑MeterSphere 的版本迭代挺快v2.x 基本每个月都有小版本。升级前必须做的是备份数据库和关键配置。我一次偷懒没备份就升级结果升级脚本执行到一半断了整个平台起不来之后折腾了三个小时才恢复。正确做法是在升级前用mysqldump备份业务库docker exec mysql容器名 mysqldump -uroot -proot密码 --all-databases /opt/backup/ms_$(date %F).sql同时把 installer 目录和docker-compose.yml的当前版本存一份副本这样出问题至少能回滚。然后按照官方升级文档操作一般是停服务 - 下载新版本 installer - 执行升级脚本 - 启动服务。注意不要跳过 “stop” 这一步直接覆盖文件我遇到过因为旧容器占用数据卷导致升级脚本初始化表结构失败的情况。如果升级后某个容器一直重启最快的排查方式是看日志docker compose logs --tail 200 backend常见的原因是数据库表结构变更后旧版本后端代码不兼容。此时只能回滚到旧镜像重新启动把备份的数据库恢复回去。5.3 给新人部署者的几条实在建议最后聊几条之前没提的实战建议都是我在后面使用中慢慢总结出来的不要把 MeteSphere 直接暴露公网。如果一定要在公网访问至少配置 HTTPSnginx 反代或云平台的负载均衡做 TLS 终止。默认的 HTTP 登录会明文传密码这是个不大不小的安全隐患。定时备份数据目录。除了数据库MinIO 里存了你的测试报告附件、导入的 Jar 包等这些不备份一次磁盘故障全没了。可以写个定时任务每晚把/opt/metersphere/data打包传到另一台机器或对象存储。用 systemd 管理 Docker 服务不可怕但容器重启策略要配好。MeterSphere 的 compose 文件里已经设置了restart: always所以云服务器重启后Docker 服务起来时容器也会自动拉起。你唯一要确认的是 DOCKER 服务本身是否开机自启。遇到玄学故障先看 Docker 版本。我遇到过 Kafka 容器连不上、前端接口 502最后排查下来是 docker compose 版本太旧导致的容器网络配置异常。把 Docker 和 compose 都升到稳定版能解决一半以上的“奇怪问题”。以上就是我在云服务器上部署 MeterSphere 的完整过程。这套流程我从 v1.20 用到了 v2.10中间踩过的坑比我写出来的还要多。如果你在部署时遇到什么没见过的报错先别急着卸载重装把日志翻出来再对照这篇文章的排查思路走一遍多半能找到方向。