如何在本地运行和构建基于 Jelastic nginxphp Docker 镜像

日期：2025-11-25 00:00 / 作者：碧海醫心

Jelastic 的 `nginxphp` Docker 镜像专为 Virtuozzo DevOps 平台优化，其默认 `CMD` 是 `systemd`，导致在本地直接 `docker run` 时无法自动启动 Nginx 或 PHP-FPM。本文将指导您如何通过覆盖默认 `CMD` 来在本地成功运行此镜像，以便进行开发和测试。

理解 Jelastic nginxphp 镜像的特性

Jelastic 提供的 nginxphp Docker 镜像与标准 Docker Hub 上常见的 Nginx 或 PHP 镜像有所不同。它被设计为在 Virtuozzo DevOps 平台上无缝运行，并集成该平台提供的所有功能和自动化特性。这意味着它的启动机制可能与您在本地开发环境中习惯的方式不同。

当您尝试以常规方式运行 jelastic/nginxphp 镜像时，例如：

docker run -p 8080:80 jelastic/nginxphp:1.14.2-php-7.2.9

并尝试访问 http://127.0.0.1:8080 时，您可能会收到“Empty reply from server”的错误。通过检查容器内部进程，您会发现只有 systemd 在运行，而 Nginx 或 PHP-FPM 并没有启动：

docker exec  ps aux

输出类似：

USER       PID %CPU %MEM    VSZ   RSS TTY      STAT START   TIME COMMAND
root         1  0.0  0.0 191276 10172 ?        Ssl  07:58   0:00 /usr/bin/qemu-x86_64 /usr/lib/systemd/systemd

这表明镜像的默认启动命令是 systemd。您可以通过 docker inspect 命令来验证这一点：

docker inspect jelastic/nginxphp:1.14.2-php-7.2.9

在输出中，您会找到类似以下内容：

    "Cmd": [
        "/usr/lib/systemd/systemd"
    ],

这证实了镜像的默认 CMD 是启动 systemd。在 Jelastic 平台环境中，systemd 会负责启动和管理 Nginx、PHP-FPM 等服务，但在本地 Docker 环境中，直接运行 systemd 并不会自动启动这些应用服务。

在本地运行 Jelastic nginxphp 镜像的解决方案

要在本地成功运行 jelastic/nginxphp 镜像并启动 Nginx 服务，您需要覆盖其默认的 CMD，直接指定要运行的命令。

步骤 1：覆盖默认 CMD

在执行 docker run 命令时，在镜像名称后添加您希望执行的命令。对于 Nginx，通常我们会直接运行 Nginx 进程并将其配置为非守护进程模式，以便它在前台运行，保持容器活跃。

docker run -p 8080:80 jelastic/nginxphp:1.14.2-php-7.2.9 /usr/sbin/nginx '-g daemon off;'

命令解析：

docker run -p 8080:80: 标准的 Docker 运行命令，将容器的 80 端口映射到主机的 8080 端口。
jelastic/nginxphp:1.14.2-php-7.2.9: 指定要运行的 Jelastic Nginx/PHP 镜像及其版本。
/usr/sbin/nginx: 这是 Nginx 可执行文件的路径。
-g 'daemon off;': 这是 Nginx 的配置参数，daemon off; 指示 Nginx 在前台运行，而不是作为守护进程在后台运行。这对于 Docker 容器至关重要，因为容器的主进程退出会导致容器停止。

步骤 2：验证 Nginx 运行

运行上述命令后，Nginx 应该会在容器内部启动。您现在可以通过 curl 或浏览器访问：

curl 127.0.0.1:8080

您应该会收到 Nginx 的默认欢迎页面或其他配置的响应，表明 Nginx 已成功运行。

注意事项与进一步考量

PHP-FPM 启动： 上述命令仅启动了 Nginx。如果您的应用程序需要 PHP 处理，您可能还需要同时启动 PHP-FPM。在 Jelastic 镜像中，PHP-FPM 通常也由 systemd 管理。要在本地同时运行 Nginx 和 PHP-FPM，您可能需要：
- 使用自定义启动脚本： 创建一个自定义的启动脚本，在该脚本中同时启动 Nginx 和 PHP-FPM，然后将该脚本作为容器的 CMD。
- 基于 systemd 改造： 尝试在本地容器中模拟 systemd 的部分行为，但这通常比直接启动服务复杂得多，且可能与 Jelastic 平台环境不一致。
- 多进程管理器： 考虑使用 supervisord 或其他进程管理器在容器内管理多个服务。
本地开发与平台部署差异： 这种本地运行方式主要是为了方便开发和测试 Nginx 或 PHP 应用程序本身。它并不能完全复制 Jelastic 平台所提供的所有自动化、监控和管理功能。如果您需要测试 Jelastic 特有的功能，最佳实践仍然是在 Jelastic 平台上进行部署和测试。
构建自定义镜像： 如果您希望在此基础上构建自己的应用程序镜像，可以在 Dockerfile 中使用 jelastic/nginxphp 作为基础镜像，并通过 CMD 或 ENTRYPOINT 指令来定义您的应用程序启动逻辑。例如：
```
FROM jelastic/nginxphp:1.14.2-php-7.2.9

# 复制您的应用程序代码
COPY ./my-app /var/www/webroot/ROOT

# 覆盖 CMD 以启动 Nginx 和 PHP-FPM (如果需要)
# 注意：启动 PHP-FPM 可能需要更复杂的配置，例如确保 Nginx 可以正确连接到 PHP-FPM socket
CMD ["/bin/bash", "-c", "/usr/sbin/php-fpm && /usr/sbin/nginx -g 'daemon off;'"]
```
请注意，上述 CMD 示例中的 PHP-FPM 启动方式可能需要根据 Jelastic 镜像的具体配置进行调整，以确保 Nginx 能够找到并与 PHP-FPM 通信。

总结

Jelastic 的 nginxphp Docker 镜像因其为特定平台优化的设计，在本地运行时需要特别处理。通过覆盖默认的 CMD，直接启动 Nginx 进程，可以有效地在本地环境中运行该镜像进行开发和测试。然而，对于更复杂的场景，例如同时运行 Nginx 和 PHP-FPM，或者需要完全复制 Jelastic 平台行为时，可能需要更深入的配置或考虑在实际平台上进行测试。理解镜像的设计意图是成功在不同环境中部署和管理 Docker 容器的关键。