server-configs-nginx README

The project's README from github.com/h5bp/server-configs-nginx. As one markdown file: README.md.

Nginx Server Configs

Server CI

Nginx Server Configs is a collection of configuration files that can help your server improve the website's performance and security, while also ensuring that resources are served with the correct content-type and are accessible, if needed, even cross-domain.

Getting Started

Using the Nginx server configs repo directly has a few required steps to be able to work.

Check nginx.conf settings

The first thing to check is that the nginx.conf file contains appropriate values for your specific install.

Most specific variables are:

Nginx test and restart

Repository structure

This repository has the following structure:

./
├── conf.d/
│   ├── default.conf
│   └── templates/
├── h5bp/
│   ├── basic.conf
│   ├── location/
│   └── .../
├── custom.d/
│   └── .../
├── mime.types
└── nginx.conf

Usage

As a reference

To use as reference requires no special installation steps, download/checkout the repository to a convenient location and adapt your existing Nginx configuration incorporating the desired functionality from this repository.

Download the latest release archive.

Directly

To use directly, replace the Nginx config directory with this repository. For example:

nginx -s stop
cd /etc
mv nginx nginx-previous
git clone https://github.com/h5bp/server-configs-nginx.git nginx
# install-specific edits
nginx

Manage sites

cd /etc/nginx/conf.d
nginx -s reload

Support

Contributing

Anyone is welcome to contribute, however, if you decide to get involved, please take a moment to review the guidelines:

Acknowledgements

Nginx Server Configs is only possible thanks to all the awesome contributors!

License

The code is available under the MIT license.

server-configs-nginx (h5bp/server-configs-nginx)

Searching Database…

Что это такое?Набор готовых конфигурационных файлов сервера Nginx (от проекта H5BP), которые повышают производительность и безопасность сайта, задают правильные типы содержимого (Content-Type) и настраивают доступ к ресурсам с других доменов.
Это полная замена nginx.conf или только сниппеты, которые я подключаю?И то, и другое: в репозитории есть полная структура (nginx.conf, mime.types, conf.d, templates), которую можно использовать сразу, а также отдельные конфигурационные сниппеты h5bp/ (миксины), которые можно подключать выборочно, например basic.conf, объединяющий рекомендуемые постоянно действующие правила.
Как начать пользоваться этими конфигами?Либо скачайте или склонируйте репозиторий и скопируйте нужные правила в свой существующий nginx.conf, либо используйте его целиком, заменив каталог конфигурации Nginx этим репозиторием.
Какая версия Nginx нужна?Nginx 1.8.0 или новее.
Нужно ли редактировать файлы, прежде чем они заработают на моём сервере?Да: нужно проверить nginx.conf на значения, специфичные для установки (user, errorlog, pid, accesslog), а при использовании готовых шаблонов скопировать их в conf.d и заменить каждое вхождение example.com на ваш реальный домен.
Как устроен репозиторий, чтобы я мог быстро найти нужное?conf.d/ содержит определения серверов, templates/ — готовые к копированию шаблоны для защищённых и незащищённых хостов, h5bp/ — повторно используемые сниппеты конфигурации и директивы location/, custom.d/ предназначен для вашей собственной конфигурации, а в корне лежат файлы mime.types и nginx.conf.
Как проверить, что конфигурация корректна, перед применением?В README описаны команды для проверки конфигурации Nginx, проверки с указанием собственного пути к файлу и перезагрузки Nginx для применения новой конфигурации без перезапуска.
Что basic.conf даёт сразу после подключения?Он подключает небольшой рекомендуемый набор правил репозитория, которые добавляют заголовки expires, разрешают загрузку шрифтов с других доменов и защищают системные файлы от доступа через веб.
Как добавить или убрать сайт?В README описаны шаги по созданию нового сайта, а затем его включению или отключению через управление его конфигурационным файлом в структуре sites.
Creator
h5bp
Size
0.4 MB
Stars
11.6K
Age
13y
Commits · 90 Days