imagotipo

Ngix

Supported tags and respective Dockerfile links

For more information about this image and its history, please see the relevant manifest file (library/nginx). This image is updated via pull requests to the docker-library/official-images GitHub repo.

For detailed information about the virtual/transfer sizes and individual layers of each of the above supported tags, please see the nginx/tag-details.md file in the docker-library/docs GitHub repo.

What is Nginx?

Nginx (pronounced “engine-x”) is an open source reverse proxy server for HTTP, HTTPS, SMTP, POP3, and IMAP protocols, as well as a load balancer, HTTP cache, and a web server (origin server). The nginx project started with a strong focus on high concurrency, high performance and low memory usage. It is licensed under the 2-clause BSD-like license and it runs on Linux, BSD variants, Mac OS X, Solaris, AIX, HP-UX, as well as on other *nix flavors. It also has a proof of concept port for Microsoft Window..

wikipedia.org/wiki/Nginx

How to use this image

hosting some simple static content

$ docker run --name some-nginx -v /some/content:/usr/share/nginx/html:ro -d nginx

Alternatively, a simple Dockerfile can be used to generate a new image that includes the necessary content (which is a much cleaner solution than the bind mount above):

FROM nginx
COPY static-html-directory /usr/share/nginx/html

Place this file in the same directory as your directory of content (“static-html-directory”), run docker build -t some-content-nginx ., then start your container:

$ docker run --name some-nginx -d some-content-nginx

exposing the port

$ docker run --name some-nginx -d -p 8080:80 some-content-nginx

Then you can hit http://localhost:8080 or http://host-ip:8080 in your browser.

complex configuration

$ docker run --name some-nginx -v /some/nginx.conf:/etc/nginx/nginx.conf:ro -d nginx

For information on the syntax of the Nginx configuration files, see the official documentation (specifically the Beginner’s Guide).

Be sure to include daemon off; in your custom configuration to ensure that Nginx stays in the foreground so that Docker can track the process properly (otherwise your container will stop immediately after starting)!

If you wish to adapt the default configuration, use something like the following to copy it from a running Nginx container:

$ docker cp some-nginx:/etc/nginx/nginx.conf /some/nginx.conf

As above, this can also be accomplished more cleanly using a simple Dockerfile:

FROM nginx
COPY nginx.conf /etc/nginx/nginx.conf

Then, build with docker build -t some-custom-nginx . and run:

$ docker run --name some-nginx -d some-custom-nginx

using environment variables in nginx configuration

Out-of-the-box, Nginx doesn’t support using environment variables inside most configuration blocks. But envsubst may be used as a workaround if you need to generate your nginx configuration dynamically before nginx starts.

Here is an example using docker-compose.yml:

  image: nginx
  volumes:
   - ./mysite.template:/etc/nginx/conf.d/mysite.template
  ports:
   - "8080:80"
  environment:
   - NGINX_HOST=foobar.com
   - NGINX_PORT=80
  command: /bin/bash -c "envsubst < /etc/nginx/conf.d/mysite.template > /etc/nginx/conf.d/default.conf && nginx -g 'daemon off;'"

The mysite.template file may then contain variable references like this :

listen ${NGINX_PORT};

Image Variants

The nginx images come in many flavors, each designed for a specific use case.

nginx:<version>

This is the defacto image. If you are unsure about what your needs are, you probably want to use this one. It is designed to be used both as a throw away container (mount your source code and start the container to start your app), as well as the base to build other images off of.

nginx:alpine

This image is based on the popular Alpine Linux project, available in the alpine official image. Alpine Linux is much smaller than most distribution base images (~5MB), and thus leads to much slimmer images in general.

This variant is highly recommended when final image size being as small as possible is desired. The main caveat to note is that it does use musl libc instead of glibc and friends, so certain software might run into issues depending on the depth of their libc requirements. However, most software doesn’t have an issue with this, so this variant is usually a very safe choice. See this Hacker News comment thread for more discussion of the issues that might arise and some pro/con comparisons of using Alpine-based images.

To minimize image size, it’s uncommon for additional related tools (such as git or bash) to be included in Alpine-based images. Using this image as a base, add the things you need in your own Dockerfile (see the alpine image description for examples of how to install packages if you are unfamiliar).

Supported Docker versions

This image is officially supported on Docker version 1.11.0.

Support for older versions (down to 1.6) is provided on a best-effort basis.

Please see the Docker installation documentation for details on how to upgrade your Docker daemon.

User Feedback

Documentation

Documentation for this image is stored in the nginx/ directory of the docker-library/docs GitHub repo. Be sure to familiarize yourself with the repository’s README.md file before attempting a pull request.

Issues

If you have any problems with or questions about this image, please contact us through a GitHub issue. If the issue is related to a CVE, please check for a cve-tracker issue on the official-images repository first.

You can also reach many of the official image maintainers via the #docker-library IRC channel on Freenode.

Contributing

You are invited to contribute new features, fixes, or updates, large or small; we are always thrilled to receive pull requests, and do our best to process them as fast as we can.

Before you start to code, we recommend discussing your plans through a GitHub issue, especially for more ambitious contributions. This gives other contributors a chance to point you in the right direction, give you feedback on your design, and help you find out if someone else is working on the same thing.

 

Instalación del certificado SSL en Nginx Server

Después de la emisión de su certificado, debe haber recibido el archivo su_dominio_com.pem de DigiCert en un mensaje de correo electrónico. Si tiene ese archivo, puede pasar a la etapa 3. De lo contrario, comience con la etapa 1.

  1. Copie los archivos del certificado en su servidor.Inicie sesión para descargar los certificados intermedio (DigiCertCA.crt) y principal (su_dominio_com.crt) desde su cuenta de cliente DigiCert. Cópielos junto con el archivo .key que generó al crear la CSR en el directorio del servidor en donde guardará los archivos de certificado y clave. Haga que los archivos solo se puedan leer desde la raíz para aumentar la seguridad.
  2. Concatene el certificado principal y el certificado intermedio.Debe concatenar el archivo de certificado principal (su_dominio_com.crt) y el archivo de certificado intermedio (DigiCertCA.crt) en un archivo pem único mediante la ejecución del siguiente comando: cat su_dominio.crt DigiCertCA.crt >> bundle.crt
  3. Edite el archivo de hosts virtuales de Nginx.Ahora abra el archivo de host virtual de Nginx para el sitio web que desea proteger. Si desea que el sitio esté disponible a través de conexiones seguras (https) y no seguras (http), necesitará un módulo del servidor para cada tipo de conexión. Cree una copia del módulo del servidor no seguro existente y péguela debajo del original. Después, agregue las siguientes líneas en negrita:

    server {

    listen   443;

    ssl    on;
    ssl_certificate    /etc/ssl/su_dominio_com.crt; (o su_dominio_com.crt.pem)
    ssl_certificate_key    /etc/ssl/su_dominio_com.key;

    server_name su.dominio.com;
    access_log /var/log/nginx/nginx.vhost.access.log;
    error_log /var/log/nginx/nginx.vhost.error.log;
    location / {
    root   /home/www/public_html/su.dominio.com/public/;
    index  index.html;
    }

    }

    Ajuste los nombres de archivo para que coincidan con los archivos de certificado:

    • ssl_certificate debe constituir la combinación del certificado principal con el certificado intermedio realizada en la etapa anterior (pj, su_dominio_com.crt).
    • ssl_certificate_key debe constituir el archivo de clave que se generó al crear la CSR.
  4. Reinicie Nginx.Ejecute el siguiente comando para reiniciar Nginx:

Dejan hombre asesinado y calcinado en la rúa a Ciudad Juárez

Dejan hombre asesinado y calcinado en la rúa a Ciudad Juárez

Aparentemente llevaba varias horas en el lugar

Ricardo Holguín

local

Elementos de Chihuahua recorren daños en Morelos y México

Elementos de Chihuahua recorren daños en Morelos y México

Prestan ayuda en el lugar a los afectados

Presentan programación para el Festival Internacional de la Manzana

Presentan programación para el Festival Internacional de la Manzana

Contará con Colombia como pais invitado

Inicia colecta del Teletón en las calles del centro de la ciudad

Inicia colecta del Teletón en las calles del centro de la ciudad

Sera donado el 100% del dinero a afectados por el sismo

Trabajan mexicanos 107 minutos para poder comprar un litro de leche

Trabajan mexicanos 107 minutos para poder comprar un litro de leche

A un norteamericano le toma sólo 7 minutos para adquirirla

Abrirán al público el Criadero Militar de Santa Gertrudis

Abrirán al público el Criadero Militar de Santa Gertrudis

Las instalaciones estarán abiertas a partir del 29 de septiembre

destacados

Frida Sofía podría ser la señora Reyna Dávila de 43 años

Familiares que reclaman su presencia y exigen de la autoridad información

Cambian a Roberto Borge de penal en Panamá por riesgo de fuga

Cambian a Roberto Borge de penal en Panamá por riesgo de fuga

El exgobernador fue trasladado a la sede principal de la Policía Nacional

Trump ofrece su ayuda a Puerto Rico e Islas Vírgenes tras paso de huracán María

Trump ofrece su ayuda a Puerto Rico e Islas Vírgenes tras paso de huracán María

El presidente también recibió una evaluación de los daños causados por el fenómeno

Suman 293 muertes en México tras terremoto

Suman 293 muertes en México tras terremoto

En la Ciudad de México han muerto 155 personas

Imputan a adolescente por atentado en metro de Londres

Imputan a adolescente por atentado en metro de Londres

Fue acusado formalmente en relación con el ataque que dejó 30 heridos