fflo/nginx-php-fpm
fflo
这是一个集成Nginx和PHP-FPM v8.x的Docker镜像，支持从Git拉取代码、Let's Encrypt SSL配置、自定义Nginx设置等，适用于快速部署PHP web应用。
下载次数: 0状态：社区镜像维护者：fflo仓库类型：镜像最近更新：1 年前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
nginx-php-fpm - https://github.com/richarvey/nginx-php-fpm/actions/workflows/build_images.yml/badge.svg](https://github.com/richarvey/nginx-php-fpm/actions/workflows/build_images.yml) !https://img.shields.io/docker/pulls/richarvey/nginx-php-fpm.svg !https://img.shields.io/docker/stars/richarvey/nginx-php-fpm.svg !https://img.shields.io/github/stars/richarvey/nginx-php-fpm.svg !https://img.shields.io/docker/v/richarvey/nginx-php-fpm?sort=semver
镜像概述
这是一个集成Nginx和PHP-FPM的Docker镜像，支持容器创建时从Git拉取网站代码，也允许容器与Git仓库同步代码变更。镜像还支持通过Docker传递的变量更新模板文件，以调整代码和设置。此外，它提供Let's Encrypt SSL配置支持、自定义Nginx配置、核心Nginx/PHP变量覆盖、X-Forwarded-For头部支持以及本地卷的UID映射功能。
核心功能
- 集成Nginx（1.24-r6）和PHP-FPM（8.2.7）
- 容器启动时从Git仓库拉取代码
- 支持Git代码的推送与拉取同步
- 通过环境变量更新模板文件
- Let's Encrypt SSL证书配置支持
- 自定义Nginx配置文件
- Nginx/PHP核心运行参数覆盖
- X-Forwarded-For头部支持
- 本地卷的UID/GID映射适配
使用场景
- 快速部署PHP web应用
- 开发环境中动态拉取Git代码进行测试
- 生产环境中需要SSL加密的PHP服务
- 需要自定义Nginx配置的Web服务场景
配置说明
环境变量配置
通过环境变量可配置Git相关参数、模板变量等，关键变量包括：
GIT_EMAIL: Git提交***GIT_NAME: Git提交用户名GIT_REPO: Git仓库地址GIT_PERSONAL_TOKEN: Git个人访问令牌
自定义Nginx配置
挂载自定义Nginx配置文件到容器内指定路径（如/etc/nginx/conf.d/），覆盖默认配置。
UID/GID映射
通过设置PUID和PGID环境变量，调整容器内用户的UID/GID，适配本地卷权限。
部署示例
拉取镜像
bashdocker pull richarvey/nginx-php-fpm:latest
简单运行
bashsudo docker run -d richarvey/nginx-php-fpm
从Git拉取代码运行
bashdocker run -d \ -e 'GIT_EMAIL=your_email@example.com' \ -e 'GIT_NAME=Your Full Name' \ -e 'GIT_USERNAME=your_git_username' \ -e 'GIT_REPO=github.com/your/project' \ -e 'GIT_PERSONAL_TOKEN=your_personal_token' \ richarvey/nginx-php-fpm:latest
访问http://<DOCKER_HOST>查看默认页面，DOCKER_HOST可通过docker inspect获取（通常为172.17.0.2）。
详细文档
- https://github.com/richarvey/nginx-php-fpm/blob/main/docs/building.md
- https://github.com/richarvey/nginx-php-fpm/blob/main/docs/versioning.md
- https://github.com/richarvey/nginx-php-fpm/blob/main/docs/config_flags.md
- https://github.com/richarvey/nginx-php-fpm/blob/main/docs/git_auth.md
- https://github.com/richarvey/nginx-php-fpm/blob/main/docs/nginx_configs.md
- https://github.com/richarvey/nginx-php-fpm/blob/main/docs/lets_encrypt.md
- https://github.com/richarvey/nginx-php-fpm/blob/main/docs/php_modules.md
- https://github.com/richarvey/nginx-php-fpm/blob/main/docs/guides/docker_compose.md
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 nginx-php-fpm 镜像标签
docker pull docker.xuanyuan.run/fflo/nginx-php-fpm:<标签>
DockerHub 原生拉取命令
docker pull fflo/nginx-php-fpm:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"