jitesoft/nginx

Nginx

注意事项

由于x390s和ppc64架构构建存在未解决问题，这两种架构的镜像已暂停提供。

镜像概述和主要用途

本镜像为基于Alpine Linux的Nginx服务器镜像，旨在提供轻量、高效的Web服务部署方案。默认暴露80端口，Nginx进程以www-data用户（UID 82）运行，支持通过环境变量自定义配置模板，适用于快速搭建Web服务器环境。

核心功能和特性

• 轻量基础：基于Alpine Linux构建，镜像体积小，资源占用低
• 多平台镜像：可从Docker Hub、GitLab、GitHub、Quay等多个仓库获取
• 灵活配置：支持通过环境变量替换配置模板变量，快速自定义服务器设置
• 安全运行：Nginx进程默认以www-data用户（UID 82）运行，容器可通过标志切换运行用户
• 健康检查：内置健康检查机制，默认每30秒检查服务状态，支持禁用

镜像标签

镜像通过CI自动构建，基于最新Alpine镜像，可在以下仓库获取：

• https://hub.docker.com/r/jitesoft/nginx%EF%BC%9A%60jitesoft/nginx%60
• https://gitlab.com/jitesoft/dockerfiles/nginx%EF%BC%9A%60registry.gitlab.com/jitesoft/dockerfiles/nginx%60
• https://github.com/orgs/jitesoft/packages/container/package/nginx%EF%BC%9A%60ghcr.io/jitesoft/nginx%60
• https://quay.io/jitesoft/nginx%EF%BC%9A%60quay.io/jitesoft/nginx%60

Dockerfile

Dockerfile可在https://gitlab.com/jitesoft/dockerfiles/nginx%E5%92%8Chttps://github.com/jitesoft/docker-nginx%E8%8E%B7%E5%8F%96%E3%80%82

使用方法

基本用法

最基础用法为直接运行容器，Nginx将启动并提供/usr/local/nginx/html目录中的内容，默认暴露80端口：

bash
docker run -p 80:80 docker.xuanyuan.run/jitesoft/nginx

www-data用户

www-data用户的UID为82，与大多数Alpine镜像中的www-data用户保持一致。2021年7月23日前该用户UID为1000，可能导致与jitesoft/php镜像配合时出现读写权限问题。

容器默认以root用户创建（生产环境可通过适当标志修改），而Nginx进程默认以www-data用户（82）运行。

配置模板

为简化设置流程，启动脚本会在/etc/nginx/conf.d目录生成default.conf文件，该目录下的所有文件默认会被Nginx加载。生成模板时，脚本将运行envsubstr替换模板变量为传入的环境变量。

如需自定义模板，可创建新模板文件并设置CONF_TEMPLATE变量为文件路径，使用${VARIABLE}作为占位符替换为对应的环境变量。

默认模板位于/usr/local/default.template，暴露以下环境变量（默认值）：

• LISTEN_PORT：监听端口（默认80）
• SERVER_NAME：服务器名称（默认localhost）
• SERVER_ROOT：网站根目录（默认/usr/local/nginx/html）

也可通过替换/etc/nginx/nginx.conf文件修改Nginx主配置（建议优先通过/etc/nginx/conf.d目录添加自定义配置文件）。

健康检查

默认情况下，容器每30秒通过healthcheck脚本执行健康检查。健康检查通过wget访问127.0.0.1:3999/__health端点（由/etc/nginx/conf.d/000-healthcheck.conf自动配置）。

可通过设置环境变量SKIP_HEALTHCHECK=true禁用健康检查（脚本仍运行，但始终返回健康状态）。不建议修改健康检查脚本。

Dockerfile获取

Dockerfile可在https://gitlab.com/jitesoft/dockerfiles/nginx%E5%92%8Chttps://github.com/jitesoft/docker-nginx%E8%8E%B7%E5%8F%96%E3%80%82

镜像标签规范

本镜像遵循https://gitlab.com/snippets/***%E3%80%82

许可证

• 本仓库文件采用MIT许可证发布
• Nginx采用https://nginx.org/LICENSE%E5%8F%91%E5%B8%83

赞助方

Jitesoft镜像通过GitLab CI在以下组织提供的运行器上构建：

上述公司与Jitesoft或其项目无直接关联。

赞助对开源项目的进一步开发和维护至关重要。如有问题或赞助意向，请通过邮件联系，也可通过以下平台赞助：

https://opencollective.com/jitesoft-open-source
https://github.com/***/jitesoft
Patreon