linux中用systemd托管docker容器有三类方式：一是直接start已有容器并设on-failure重启；二是启动时用run重建容器，禁用docker自启以避免冲突；三是仅依赖docker原生--restart=unless-stopped策略并确保docker服务自启。

Linux 中用 systemd 为 Docker 容器配置自动托管，核心是让容器随系统启动而运行、异常退出时能恢复、停止时能干净清理。这不是简单“开机拉起一次”，而是实现可控、可观察、可维护的长期托管。下面分三类典型场景说明关键做法。

直接托管已有容器（轻量可靠）

适用于已手动创建好、配置稳定的容器，只需确保它开机就运行。

• 创建服务文件：sudo nano /etc/systemd/system/myapp.service
• 内容写成：

  [Unit]
  Description=My Web App Container
  After=docker.service
  Requires=docker.service
  
  [Service]
  Type=oneshot
  ExecStart=/usr/bin/docker start -a my-web-app
  ExecStop=/usr/bin/docker stop my-web-app
  Restart=on-failure
  RestartSec=5
  
  [Install]
  WantedBy=multi-user.target

• 注意：不要用 ExecStart=/usr/bin/docker run——这会导致重复创建同名容器失败；start -a 是复用已有容器的标准方式
• 启用并测试：sudo systemctl daemon-reload && sudo systemctl enable --now myapp.service

启动时新建并托管容器（推荐用于生产）

适合需要每次启动都重建容器（比如挂载最新配置、避免残留状态）的场景。

minimax-mcp-docker版（适配极空间）

MiniMax 图片理解 + 网络搜索 MCP 工具。适配 Docker 环境（极空间等），支持图片 OCR 识别、图像内容理解、网络搜索。API Key 安全存储在本地 credentials 文件，不暴露在代码中。

下载

• 服务文件中加入清理逻辑：

  ExecStartPre=-/usr/bin/docker rm -f my-web-app
  ExecStart=/usr/bin/docker run \
    --name my-web-app \
    -p 8080:80 \
    --restart=no \
    nginx:alpine

• 关键点：显式设 --restart=no，避免 Docker 守护进程和 systemd 对重启行为产生冲突；所有生命周期控制交给 systemd
• 设置 Type=simple 或 Type=exec，并加 TimeoutStartSec=120 防止大镜像拉取超时被 kill

与 Docker 自身重启策略协同（最简方案）

不额外建 systemd 服务，靠 Docker 原生能力完成基础托管，适合多数无特殊依赖的容器。

• 启动容器时指定策略：docker run -d --name api --restart=unless-stopped -p 3000:3000 my-api:latest
• 确认 Docker 引擎本身已自启：sudo systemctl enable docker
• 该策略含义：只要容器没被手动 docker stop 过，系统重启后就会自动起来；手动停掉后不会自启，符合运维直觉
• 后续想调整策略？用 docker update --restart=always api 即可，无需改任何配置文件

三种方式没有绝对优劣，选哪个取决于你是否需要 systemd 提供的日志聚合、依赖声明、资源限制或启动顺序控制。多数情况下，--restart=unless-stopped + systemctl enable docker 已足够健壮。