Nginx是一款高性能的反向代理和Web服务器,以高并发处理能力、低资源消耗及出色的稳定性著称,广泛应用于各类网站架构中,承担请求转发、负载均衡、静态资源服务等关键任务,其长期跟踪版本由Canonical公司负责维护,为用户提供持续可靠的技术支持与版本更新。
ubuntu/nginx is a rock for Nginx maintained by https://canonical.com/.
Nginx is a high-performance web and reverse proxy server created by Igor Sysoev. It can be used both as a standalone web server and as a proxy to reduce the load on back-end HTTP or mail servers. Read more on the nginx website.
[Learn more about Nginx]
Tags and Architectures
NOTE: These tags follow a specific naming convention that respects the concept of channels.
| Tags | Supported until | Version | Base | Architectures | |
|---|---|---|---|---|---|
1.28-26.04_beta | aliasesedge, latest | 09/2026 | 1.28 | 26.04 | ppc64le, s390x, amd64, arm64 |
1.24-24.04_beta | aliases1.24-24.04_beta | 05/2029 | 1.24 | 24.04 | amd64, s390x, ppc64le, arm64 |
1.18-22.04_beta | aliases1.18-22.04_beta | 06/2027 | 1.18 | 22.04 | amd64, s390x, ppc64le, arm64 |
1.28-26.04_edge | aliases1-26.04_edge | 09/2026 | 1.28 | 26.04 | ppc64le, s390x, amd64, arm64 |
1.24-24.04_edge | aliases1.24-24.04_edge | 05/2029 | 1.24 | 24.04 | amd64, s390x, ppc64le, arm64 |
1.18-22.04_edge | aliases1.18-22.04_edge | 06/2027 | 1.18 | 22.04 | amd64, s390x, ppc64le, arm64 |
View deprecated tags
| Tags | Support ended on | Upgrade Path |
|---|---|---|
1.26-25.04_beta | 01/2026 | - |
1.26-24.10_beta | 07/2025 | - |
1.24-23.10_beta | 07/2024 | - |
1.22-23.04_beta | 01/2024 | - |
1.22-22.10_beta | 07/2023 | - |
1.18-21.10_beta | 07/2022 | - |
1.18-21.04_beta | 01/2022 | - |
1.18-20.04_beta | 05/2025 | - |
Get started
This rock's entrypoint is Pebble, a container-optimized init process that enables the orchestration of a collection of local service processes as an organized set.
\https://documentation.ubuntu.com/pebble/\]
Inspect
To view the https://documentation.ubuntu.com/rockcraft/en/latest/reference/rockcraft-yaml/#services and https://documentation.ubuntu.com/rockcraft/latest/reference/rockcraft-yaml/#checks defined in this rock:
shdocker run --rm ubuntu/nginx:1.26-25.04_beta plan
Run
To run this rock, use any of the usual container runtimes, for example, docker:
shdocker run --name nginx-container \ -p 8080:80 \ ubuntu/nginx:1.26-25.04_beta
Nginx starts and serves content on port 80. Access your Nginx server at http://localhost:8080.
Get logs
To view the logs of the running container, run:
shdocker exec nginx-container pebble logs
Or, for a specific service:
shdocker exec nginx-container pebble logs <service>
Monitor health checks
Rocks may have predefined health checks that you can list by running:
shdocker exec nginx-container pebble checks
The overall health of your container can be inspected via:
shdocker exec nginx-container pebble health
Deploy with Kubernetes
Works with any Kubernetes; if you don't have one, we recommend you https://microk8s.io/. Then, run microk8s.enable dns storage and snap alias microk8s.kubectl kubectl.
Download
https://git.launchpad.net/~canonical-server/ubuntu-docker-images/+git/nginx/plain/examples/config/nginx.conf?h=1.18-22.04, https://git.launchpad.net/~canonical-server/ubuntu-docker-images/+git/nginx/plain/examples/config/html/index.html?h=1.18-22.04 and
https://git.launchpad.net/~canonical-server/ubuntu-docker-images/+git/nginx/plain/examples/nginx-deployment.yml?h=1.18-22.04 and set containers.nginx.image in nginx-deployment.yml to your chosen channel tag (e.g. ubuntu/nginx:1.26-25.04_beta), then:
shkubectl create configmap nginx-config --from-file=nginx=nginx.conf --from-file=nginx-site=index.html kubectl apply -f nginx-deployment.yml
You will now be able to connect to the nginx server on http://localhost:31080.
Configuration
Environment variables
| Option | Description | Default |
|---|---|---|
| TZ | Timezone setting for the container. | UTC |
Volumes
| Option | Description | Default |
|---|---|---|
-v <path>:/var/www/html:ro | Mount and serve a local website. | None |
-v <path>:/etc/nginx/templates/conf.template | Mount template files inside /etc/nginx/templates. They are processed and the results are placed at /etc/nginx/conf.d (for example, listen ${NGINX_PORT}; generates listen 80;). | None |
-v <path>:/etc/nginx/nginx.conf:ro | Local https://nginx.org/en/docs/ (try https://git.launchpad.net/~canonical-server/ubuntu-docker-images/+git/nginx/plain/examples/config/nginx.conf?h=1.18-22.04). | None |
Ports
| Option | Description | Default |
|---|---|---|
-p <port>:80 | Expose port 80 on the host. | None |
\https://github.com/canonical/nginx-rock/issues\] \https://github.com/canonical/nginx-rock\]
Canonical is the provider of this container image. It is the user's responsibility to ensure that any use of this image complies with any relevant licenses for all software contained within, as well as with https://canonical.com/legal/intellectual-property-policy.
ubuntu 命名空间的其他可用镜像:
更多相关 Docker 镜像与资源
以下是 ubuntu/nginx 相关的常用 Docker 镜像,适用于 反向代理、负载均衡、静态资源服务 等不同场景:
ubuntu/nginx Related Documentation
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
DockerHub 原生拉取命令
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务
