Peppermint项目Docker端口映射配置指南

在部署Peppermint项目时，正确配置Docker端口映射是确保服务可访问的关键步骤。本文将详细介绍如何正确修改Peppermint项目的端口配置，以及相关的技术原理。

Docker端口映射基础

Docker端口映射采用"主机端口:容器端口"的格式。主机端口是外部访问服务时使用的端口，而容器端口是服务在Docker容器内部实际监听的端口。这种设计实现了容器内外网络的隔离与连通。

Peppermint项目端口配置

Peppermint项目默认使用3000端口提供服务。在docker-compose.yml配置文件中，默认设置为：

3000:3000

这表示将主机的3000端口映射到容器的3000端口。

修改主机端口

如果希望将外部访问端口改为3001，同时保持容器内部端口不变，应修改为：

3001:3000

这种配置下：

• 外部通过http://localhost:3001访问服务
• 容器内部服务仍监听3000端口

修改容器端口

如果需要同时修改容器内部监听端口，可以通过设置环境变量PORT来实现。Peppermint项目使用PM2进程管理器，在ecosystem.config.js配置文件中定义了端口环境变量。

要修改容器内部端口，需要在docker-compose.yml中添加环境变量配置：

environment:
  - PORT=3001

然后端口映射应设置为：

3001:3001

常见问题排查

如果遇到"connection reset by peer"错误，通常是由于端口映射配置不当导致的。请检查：

1. 确认容器内部服务实际监听的端口
2. 确保docker-compose.yml中的端口映射配置正确
3. 检查是否有其他服务占用了目标端口
4. 确认防火墙设置允许该端口的通信

正确理解Docker端口映射机制，可以帮助开发者灵活配置Peppermint项目的网络访问方式，满足不同部署环境的需求。