Docker-Magento项目：修改Nginx服务端口号的完整指南

在使用Docker部署Magento电商系统时，经常需要修改默认的80端口以适应不同的部署环境。本文将详细介绍如何在Docker-Magento项目中正确修改Nginx服务的端口配置。

端口映射基础配置

在docker-compose.yaml文件中，Nginx服务的端口映射配置位于app服务下。默认配置是将主机的80端口映射到容器的8000端口：

services:
  app:
    image: markoshust/magento-nginx:1.24-0
    ports:
      - "80:8000"
      - "443:8443"

要修改为使用7888端口，只需调整第一个映射项：

ports:
  - "7888:8000"
  - "443:8443"

常见问题与解决方案

404错误处理

修改端口后出现404错误通常是因为Magento系统配置中仍使用旧端口。需要更新数据库中的基础URL设置：

1. 连接到Magento数据库
2. 执行以下SQL更新语句：

UPDATE core_config_data 
SET value = 'http://magento.test:7888/' 
WHERE path IN ('web/unsecure/base_url', 'web/secure/base_url');

SSL协议错误处理

当使用非标准HTTPS端口(如7888)时，可能会遇到SSL协议错误。这是因为浏览器默认将HTTPS请求发送到443端口。解决方案是：

1. 修改docker-compose.yaml中的SSL端口映射：

ports:
  - "7888:8000"
  - "7889:8443"

2. 更新数据库中的安全基础URL：

UPDATE core_config_data 
SET value = 'https://magento.test:7889/' 
WHERE path = 'web/secure/base_url';

完整配置示例

以下是修改为使用8080和8443端口的完整配置示例：

services:
  app:
    image: markoshust/magento-nginx:1.24-0
    ports:
      - "8080:8000"
      - "8443:8443"
    volumes:
      - ~/.composer:/var/www/.composer:cached
      - ~/.ssh/id_rsa:/var/www/.ssh/id_rsa:cached
      - ~/.ssh/known_hosts:/var/www/.ssh/known_hosts:cached
      - appdata:/var/www/html
      - sockdata:/sock
      - ssldata:/etc/nginx/certs

最佳实践建议

1. 端口选择：建议使用8000以上的端口，避免与系统服务冲突
2. 配置同步：修改端口后，务必同步更新数据库中的URL配置
3. 缓存清理：每次修改配置后，执行bin/magento cache:flush清理缓存
4. 环境测试：修改后先在开发环境测试，再部署到生产环境

通过以上步骤，您可以灵活地调整Docker-Magento项目的服务端口，满足不同部署环境的需求。