1 环境要求

部署服务器要求

• 操作系统: Ubuntu 22 / CentOS 7 64 位系统
• CPU/内存: 2C4G
• 磁盘空间: 200 G
• 网络要求：可稳定访问互联网
• Docker：一键安装基于 Docker 环境，安装 Docker 可参考官方的安装文档 进行操作。

2 一键安装

通过 docker run 命令一键安装 metersphere：

docker run -d -p 8081:8081 --name=metersphere -v ~/.metersphere/data:/opt/metersphere/data metersphere/metersphere-ce-allinone

安装成功后，通过浏览器访问如下页面登录 MeterSphere。

地址: http://目标服务器IP地址:8081
用户名: admin
密码: metersphere

安装脚本默认将主机的 ~/.metersphere/data 目录作为挂载目录，MeterSphere 的配置文件、数据及日志等均存放在该安装目录。

3 在线升级

升级步骤

下载最新镜像：

docker pull cr2.fit2cloud.com/metersphere/metersphere-ce-allinone

查看并确认安装时的数据持久化目录，复制保存，以便后续使用

docker inspect metersphere

删除正在运行的 metersphere 容器

docker rm -f metersphere

注意：

务必确认数据持久化目录，否则启动后数据为空。

创建并启动 metersphere 容器

docker run -d -p 8081:8081 --name=metersphere -v ~/.metersphere/data:/opt/metersphere/data cr2.fit2cloud.com/metersphere/metersphere-ce-allinone

查看服务状态

docker ps -a|grep metersphere-ce-allinone

4 配置反向代理

如果使用了 Nginx、HAProxy 进行反向代理配置，需要增加对 websocket 的支持。以 Nginx 为例，参考配置如下:

server {
    listen 80;
    server_name demo.metersphere.com;
    server_tokens off;
    return 301 https://$host$request_uri;
}
server {
    listen 443 ssl;
    # RSA certificate
    ssl_certificate /etc/nginx/ssl/metersphere.com/fullchain.cer; # managed by Certbot
    ssl_certificate_key /etc/nginx/ssl/metersphere.com/metersphere.com.key; # managed by Certbot
    server_name demo.metersphere.com;
    proxy_connect_timeout 300;
    proxy_send_timeout 300;
    proxy_read_timeout 300;
    send_timeout 300;
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $remote_addr;
    proxy_set_header X-Forwarded-Host $server_name;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_redirect http:// $scheme://;
    location / {
        proxy_pass http://ip:8081;
        client_max_body_size 1000m;
        #access_log off;
        #配置 websocket 支持
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}