Docker Server Manager Go MCP

注意：此项目尚处于早期开发阶段，可能无法完全正常工作。请自行承担风险使用。

Docker Server Manager Go MCP（DSM）是一个基于Go语言的全面REST API，提供了一个强大且灵活的接口来管理Docker容器、镜像、卷、网络以及Docker Compose部署。

概述

该项目通过Web API提供了完整的Docker管理解决方案，包括JWT认证、强大的CRUD操作以及对所有主要Docker功能的支持。API支持PostgreSQL和SQLite数据库进行持久化存储，并自动使用GORM进行管理。

主要特性

• 完整的Docker管理：

  • 容器生命周期管理（创建、启动、停止、删除）
  • 镜像操作（拉取、构建、标记、删除）
  • 卷管理（创建、列出、删除）
  • 网络操作（创建、连接容器、删除）
  • 文件操作（复制到/从容器）
  • 在容器内执行命令

• Docker Compose支持：

  • 解析和验证Docker Compose YAML文件
  • 部署多容器应用
  • 跟踪部署状态
  • 扩缩服务
  • 管理由Compose部署创建的资源

• 安全性：

  • JWT认证和授权
  • 基于角色的访问控制
  • 令牌黑名单和刷新
  • 密码哈希和安全存储

• API：

  • 使用Gin框架设计的RESTful API
  • 全面的API文档
  • 适用于Go应用程序的客户端SDK
  • Swagger/OpenAPI规范

• 数据库支持：

  • 生产环境下的PostgreSQL
  • 开发和测试环境下的SQLite
  • 自动模式迁移
  • 基于GORM的数据访问层

快速开始

预备条件

• Go 1.24.1或更高版本
• Docker 24.0.0或更高版本
• PostgreSQL（用于生产环境）或SQLite（用于开发）

安装

1. 克隆仓库：

   git clone https://github.com/threatflux/dockerServerMangerGoMCP.git
   cd dockerServerMangerGoMCP
   

2. 安装依赖：

   go mod download
   

3. 构建应用：

   make build
   

4. 运行服务器：

   ./bin/ghactions-updater
   

Docker部署

要在Docker中运行应用：

docker-compose up -d

API文档

完整的API文档位于/docs目录下：

• API参考
• 认证指南
• Docker管理
• Docker Compose

开发

详细的开发指南见：

• 开发指南

构建和测试

# 运行测试
make test

# 运行代码检查
make lint

# 检查安全问题
make security

许可证

版权所有 © 2025 ThreatFlux。保留所有权利。

作者

Wyatt Roersma