BT宝塔面板Docker商店部署MCP服务图文教程

对于需要部署特定网络服务或应用的站长来说，Docker提供了一种便捷、隔离的容器化方案。而在BT宝塔面板9.6.0及以上版本中，新增了对基于MCP（Micro-Container Platform）服务的部署支持，这为我们提供了一种更简单的方式来部署预配置好的Docker应用。主题铺今天就以部署一个示例的MCP服务（如高德地图相关的Supergateway）为例，带你了解如何在BT宝塔面板中完成这一过程。

还没安装免费BT宝塔面板，赶快下载安装吧>>>

重要提示： 请确保你的BT宝塔面板版本在9.6.0或以上，否则可能无法找到并正确部署MCP服务。

什么是MCP服务？

MCP，即微容器平台，可以理解为BT宝塔面板为Docker应用提供的一种标准化的配置和部署方式。通过MCP服务，开发者可以预先定义好一个应用所需的镜像、环境变量、端口等信息，用户只需要在宝塔面板中找到该服务配置，就能一键部署到自己的Docker环境中。

部署流程

整个部署过程主要分为三个步骤：找到MCP服务配置、在BT宝塔面板Docker商店中安装、以及访问验证。

步骤一：找到并复制你需要的MCP服务配置

1. 访问MCP服务列表：首先，你需要找到提供MCP服务配置的平台。文章中提到了 https://mcp.so/ 这个地址，你可以在这里寻找你需要的服务。例如，如果你需要部署一个与高德地图相关的服务（如Supergateway），可以在这里找到对应的配置。
2. 定位并复制配置：在MCP服务列表中找到你想要部署的服务。通常会有一个详细的说明页面或配置展示。找到其中的“配置”部分。
3. 点击复制：在配置区域，找到复制按钮并点击。这将把该服务的部署配置信息复制到你的剪贴板中。

主题铺提示： 每个MCP服务的配置都是针对特定应用的，部署前请确保你选择的服务符合你的需求。

步骤二：在BT宝塔面板Docker商店中安装服务

BT宝塔面板9.6.0+版本在Docker管理器中集成了Docker商店功能，可以直接通过MCP配置部署应用。

1. 登录宝塔面板：使用你的浏览器访问宝塔面板，并输入用户名密码登录。
2. 进入Docker管理器：在左侧菜单栏中，找到并点击“Docker”选项，进入Docker管理器页面。
3. 访问Docker商店：在Docker管理器页面中，找到并点击“商店”或类似的入口。
4. 部署MCP服务：在Docker商店页面，你应该能看到一个可以粘贴MCP配置的区域。将你在步骤一复制的MCP服务配置粘贴到此处。
5. 调整配置（重要！）：粘贴配置后，面板会解析配置并展示部署选项。在这里，你需要进行一些重要的调整：
   • 修改环境变量：检查配置中的环境变量。例如，如果部署的是高德地图相关的服务，可能会有一个名为 AMAP_MAPS_API_KEY 的环境变量。你需要将其修改为你自己申请的高德地图API Key。务必根据你的实际情况修改所有必要的环境变量！
   • 检查端口：查看服务需要映射的端口。确保这些端口在你的服务器上没有被其他应用占用，避免端口冲突。 [2] 如果冲突，可以修改宿主机端口映射。
   • 允许外部访问：根据你的需求决定是否勾选“允许外部访问”选项。主题铺特别提醒： 如果你的应用不经过系统防火墙，勾选此项后该应用将直接允许外部访问；如果你是云服务器，勾选此项后，请务必到云服务商的安全组中放行该应用的端口，否则外部将无法访问。
6. 确认并安装：检查所有配置无误后，点击安装或部署按钮。BT宝塔面板会自动从Docker仓库拉取镜像，并按照配置启动容器。

主题铺提示： 如果在安装或拉取镜像过程中遇到网络问题，可以尝试设置Docker加速站来提高下载速度。BT宝塔论坛提供了相关的教程。

步骤三：访问和验证服务

安装完成后，你需要验证服务是否正常运行并可以访问。

1. 查看服务详情：在BT宝塔面板的Docker管理器中，找到你刚刚部署的服务，点击“详情”或类似按钮。
2. 获取服务URL：在服务详情页面，你会看到该服务的相关信息，包括容器状态、映射端口等。其中应该会显示服务的访问URL。
3. 在你的AI应用或客户端中使用URL：复制这个服务URL，将其配置到你的AI应用、客户端或其他需要调用该服务的程序中。
4. 进行访问测试：尝试通过配置好的URL访问你的服务，检查是否能正常工作。

安装后无法访问？排查指南

如果在安装完成后无法正常访问部署的服务，主题铺为你整理了几个常见的排查方向：

1. 检查云服务器安全组：这是最常见且关键的一步！如果你使用的是云服务器（如阿里云、腾讯云），即使你在BT宝塔面板中勾选了“允许外部访问”，也必须登录到你的云服务商控制台，在对应的服务器实例的安全组规则中，手动放行该Docker应用使用的端口。
   • 如何查看Docker应用端口？ 在BT宝塔面板Docker管理器中，查看该应用的详情，找到端口映射信息，确认宿主机映射的端口号。
   • 开放安全组示例：宝塔官网提供了阿里云和腾讯云等云服务商开放安全组的示例，可以参考这些示例进行配置。
2. 检查系统防火墙：除了云服务商的安全组，服务器内部的系统防火墙（如firewalld、ufw）也可能阻止访问。确保该应用的端口在系统防火墙中也已放行。
3. 检查Docker服务状态：在宝塔面板Docker管理器中，检查该容器的状态是否为“运行中”。如果状态异常，可以尝试重启容器或查看容器日志排查原因。
4. 检查环境变量配置：回过头检查你在步骤二中修改的环境变量是否正确无误，特别是像API Key等关键信息。
5. 检查端口冲突：确认该应用使用的端口没有被服务器上的其他进程占用。
6. 查看容器日志：在Docker管理器中，查看该容器的日志输出，通常能找到服务启动失败或运行异常的具体原因。

总结

BT宝塔面板9.6.0+版本通过引入MCP服务部署，为用户提供了一种快速、便捷的方式来部署Docker应用。主题铺认为，这种方式简化了Docker部署的流程，让更多用户能够轻松利用容器化技术。按照本教程的步骤，找到你需要的MCP服务配置，在BT宝塔面板中进行简单的配置调整，就能快速部署你的应用。如果在部署或访问过程中遇到问题，别忘了参考我们的排查指南，特别是检查云服务器安全组！希望这篇教程对你有所帮助！