容器管理（Docker compose环境）

在 Docker Compose 部署环境下，SuperMap AgentX Server 此前依赖命令行进行容器管理，不仅操作门槛高，而且多容器场景下效率低下。为此，产品内置了可视化容器管理功能，通过图形化界面，替代传统的命令行操作，轻松完成容器的生命周期管理、资源监控、日志查看及在线调试等操作，降低运维门槛，提升管理效率。

开启功能

此功能默认处于禁用状态。如需启用，请按以下步骤操作：

  1. 打开位于 SuperMap AgentX Server 安装目录下的 .env 配置文件。
  2. 找到 PORTAINER_ENABLED 配置项，将其值从默认的 false 修改为 true。

# 是否开启 Portainer，默认不启用
PORTAINER_ENABLED=true

3. 修改完成后保存文件，执行安装目录下的 startup.sh 脚本，以重启 SuperMap AgentX Server 服务使配置生效。

访问界面

前往SuperMap AgentX Server首页，点击后台管理服务卡片下的访问，在左侧导航栏点击容器管理，即可跳转至可视化容器管理页面，支持一站式管理、动态资源监控、实时日志查看以及在线终端调试等功能。

注意：

该功能权限较高，可直接操作容器、网络及存储卷等资源，存在误操作风险。为保障稳定，建议日常关闭，仅在排查问题时临时启用。

核心功能与使用场景

容器生命周期管理

支持对单个或批量容器进行启动、停止、重启、删除、暂停/恢复等操作；支持快速查看容器详情（环境变量、挂载卷、网络配置、端口映射等）。

  1. 典型场景：
    1. 服务版本升级：无需命令行，一键完成旧容器停止、新镜像拉取与容器重建。
    2. 异常恢复：容器意外退出时一键重启，避免临时查找容器ID执行命令。

实时日志与监控

提供容器标准输出/错误日志的流式查看、关键词过滤及下载；以图表展示CPU、内存、网络I/O等实时资源曲线，支持自定义时间范围。

  1. 典型场景：
    1. 故障定位：直接查看容器实时日志，快速定位错误堆栈，无需登录服务器。
    2. 性能分析：通过资源趋势图直观判断内存泄漏或CPU飙高等问题。

镜像与网络存储管理

支持查看/删除本地镜像、拉取新镜像、上传Dockerfile构建镜像；管理自定义网络与数据卷，支持创建、删除及卷内文件浏览。

  1. 典型场景：
    1. 环境初始化：新节点部署时，直接通过界面拉取指定版本镜像，无需手动执行docker pull。
    2. 网络隔离调整：微服务调试期间，通过可视化界面快速调整容器所属网络。