ArchLinux:Nginx: Difference between revisions

From Wiki³
Line 103: Line 103:
{{Console|1=sudoedit /nginx/conf.d/nginx.conf}}
{{Console|1=sudoedit /nginx/conf.d/nginx.conf}}
{{margin}}
{{margin}}
{{Console|title=/nginx/conf.d/nginx.conf|prompt=false|1={{blackBold|# $KYAULabs: nginx.conf,v 1.1.7 2021/05/03 18:14:27 kyau Exp $}}<br/><br/>{{blackBold|# Help / Additional Info &#123;&#123;&#123;}}<br/>{{blackBold|# always test configuration before reload!}}<br/>{{blackBold|# $ sudo nginx -t}}<br/>{{blackBold|# reload the configuration by using reload not restart!}}<br/>{{blackBold|# $ sudo systemctl reload nginx}}<br/>{{blackBold|# <nowiki>https://www.nginx.com/resources/wiki/start/topics/tutorials/config_pitfalls/</nowiki>}}<br/>{{blackBold|# &#125;&#125;&#125;}}<br/><br/>{{blackBold|# enables the use of “just-in-time compilation” for the regular expressions}}<br/>{{blackBold|# known by the time of configuration parsing}}<br/>pcre_jit on;<br/>{{blackBold|# user and group credentials used by worker processes}}<br/>user http http;<br/>{{blackBold|# number of worker processes (auto will autodetect number of CPU cores)}}<br/>worker_processes auto;<br/>{{blackBold|# binds worker processes automatically to available CPUs}}<br/>worker_cpu_affinity auto;<br/>{{blackBold|# number of file descriptors used for nginx}}<br/>worker_rlimit_nofile 65535;<br/><br/>events &#123;<br/> {{blackBold|# worker process will accept one/all (off/on) connection(s) at a time}}<br/> multi_accept on;<br/> {{blackBold|# maximum number of simultaneous connections that can be opened by a worker}}<br/> worker_connections 65535;<br/>&#125;<br/><br/>http &#123;<br/> {{blackBold|# mime types}}<br/> include /nginx/conf.d/mime.types;<br/> {{blackBold|# to boost I/O on HDD we can disable access logs}}<br/> access_log off;<br/> {{blackBold|# read and send using multi-threading, without blocking a worker process}}<br/> aio threads;<br/> {{blackBold|# hide index pages}}<br/> autoindex off;<br/> {{blackBold|# add to 'Content-Type' response header}}<br/> charset utf-8;<br/> {{blackBold|# request timed out -- default 60}}<br/> client_body_timeout 10;<br/> {{blackBold|# sets the maximum allowed size of the client request body}}<br/> client_max_body_size 16M;<br/> {{blackBold|# default mime type}}<br/> default_type text/plain;<br/> {{blackBold|# enable gzipping of responses}}<br/> gzip on;<br/> {{blackBold|# disables gzipping of responses for msie6 and below}}<br/> gzip_disable "msie6";<br/> gzip_min_length 10240;<br/> gzip_comp_level 1;<br/> gzip_vary on;<br/> gzip_proxied expired no-cache no-store private auth;<br/> {{blackBold|# text/html is always compressed}}<br/> gzip_types<br/> text/css<br/> text/javascript<br/> text/xml<br/> text/x-component<br/> application/javascript<br/> application/x-javascript<br/> application/json<br/> application/xml<br/> application/rss+xml<br/> application/atom+xml<br/> font/truetype<br/> font/opentype<br/> application/vnd.ms-fontobject<br/> image/svg+xml;<br/> {{blackBold|# files that will be used as an index, checked in the specified order}}<br/> index index.php index.html index.htm index.txt;<br/> {{blackBold|# enables keep-alive connections with all browsers}}<br/> keepalive_disable none;<br/> {{blackBold|# keep-alive client connections stay active for -- default 75}}<br/> keepalive_timeout 30s;<br/> {{blackBold|# specifies log format}}<br/> log_format main<br/> '$remote_addr - $remote_user [$time_local] '<br/> '"$request" $status $body_bytes_sent '<br/> '"$http_referer" "$http_user_agent"';<br/> {{blackBold|# disables logging of errors about not found files into error_log}}<br/> log_not_found off;<br/> {{blackBold|# allow the server to close connection on non responding client, this will}}<br/> {{blackBold|# free up memory}}<br/> reset_timedout_connection on;<br/> {{blackBold|# if client stops responding, free up memory -- default 60}}<br/> send_timeout 10;<br/> {{blackBold|# copies data between one FD and other from within the kernel faster than}}<br/> {{blackBold|# read() + write()}}<br/> sendfile on;<br/> {{blackBold|# bucket size for the server names hash tables}}<br/> server_names_hash_bucket_size 128;<br/> {{blackBold|# disables emitting nginx version on error pages and in the "server"}}<br/> {{blackBold|# response header field}}<br/> server_tokens off;<br/> {{blackBold|# send headers in one piece, it is better than sending them one by one}}<br/> tcp_nopush on;<br/> {{blackBold|# don't buffer data sent, good for small data bursts in real time}}<br/> tcp_nodelay on;<br/> {{blackBold|# hash table maximum size}}<br/> types_hash_max_size 4096;<br/><br/> {{blackBold|# redirect all non-encrypted (http) traffic to encrypted (https)}}<br/> server &#123;<br/> server_name _;<br/> listen *:80 default_server;<br/> listen [::]:80 default_server;<br/> return 301 <nowiki>https://$host$request_uri;</nowiki><br/> &#125;<br/><br/> {{blackBold|# include domain configuration files}}<br/> include /nginx/vhosts.d/*.conf;<br/>&#125;<br/><br/>{{blackBold|# vim: ft{{=}}nginx ts{{=}}4 sw{{=}}4 noet :}}}}
{{Console|title=/nginx/conf.d/nginx.conf|prompt=false|1=
{{blackBold|# $KYAULabs: nginx.conf,v 1.1.7 2021/05/03 18:14:27 kyau Exp $}}
 
{{blackBold|# Help / Additional Info &#123;&#123;&#123;}}
{{blackBold|# always test configuration before reload!}}
{{blackBold|# $ sudo nginx -t}}
{{blackBold|# reload the configuration by using reload not restart!}}
{{blackBold|# $ sudo systemctl reload nginx}}
{{blackBold|# <nowiki>https://www.nginx.com/resources/wiki/start/topics/tutorials/config_pitfalls/</nowiki>}}
{{blackBold|# &#125;&#125;&#125;}}
 
{{blackBold|# enables the use of “just-in-time compilation” for the regular expressions}}
{{blackBold|# known by the time of configuration parsing}}
pcre_jit on;
{{blackBold|# user and group credentials used by worker processes}}
user http http;
{{blackBold|# number of worker processes (auto will autodetect number of CPU cores)}}
worker_processes auto;
{{blackBold|# binds worker processes automatically to available CPUs}}
worker_cpu_affinity auto;
{{blackBold|# number of file descriptors used for nginx}}
worker_rlimit_nofile 65535;
 
events &#123;
{{blackBold|# worker process will accept one/all (off/on) connection(s) at a time}}
multi_accept on;
{{blackBold|# maximum number of simultaneous connections that can be opened by a worker}}
worker_connections 65535;
&#125;
 
http &#123;
{{blackBold|# mime types}}
include /nginx/conf.d/mime.types;
{{blackBold|# to boost I/O on HDD we can disable access logs}}
access_log off;
{{blackBold|# read and send using multi-threading, without blocking a worker process}}
aio threads;
{{blackBold|# hide index pages}}
autoindex off;
{{blackBold|# add to 'Content-Type' response header}}
charset utf-8;
{{blackBold|# request timed out -- default 60}}
client_body_timeout 10;
{{blackBold|# sets the maximum allowed size of the client request body -- default 1}}
client_max_body_size 16m;
{{blackBold|# default mime type}}
default_type text/plain;
{{blackBold|# enable gzipping of responses}}
gzip on;
{{blackBold|# disables gzipping of responses for msie6 and below}}
gzip_disable "msie6";
{{blackBold|# minimum length of a response that will be gzipped -- default 20}}
gzip_min_length 1024;
{{blackBold|# gzip compression level -- default 1}}
gzip_comp_level 6;
gzip_vary on;
gzip_proxied expired no-cache no-store private auth;
{{blackBold|# text/html is always compressed}}
gzip_types
text/css
text/javascript
text/xml
text/x-component
application/javascript
application/x-javascript
application/json
application/xml
application/rss+xml
application/atom+xml
font/truetype
font/opentype
application/vnd.ms-fontobject
image/svg+xml;
{{blackBold|# files that will be used as an index, checked in the specified order}}
index index.php index.html index.htm index.txt;
{{blackBold|# enables keep-alive connections with all browsers}}
keepalive_disable none;
{{blackBold|# keep-alive client connections stay active for -- default 75}}
keepalive_timeout 30s;
{{blackBold|# specifies log format}}
log_format main
'$remote_addr - $remote_user [$time_local] '
'"$request" $status $body_bytes_sent '
'"$http_referer" "$http_user_agent"';
{{blackBold|# disables logging of errors about not found files into error_log}}
log_not_found off;
{{blackBold|# allow the server to close connection on non responding client, this will}}
{{blackBold|# free up memory}}
reset_timedout_connection on;
{{blackBold|# if client stops responding, free up memory -- default 60}}
send_timeout 10;
{{blackBold|# copies data between one FD and other from within the kernel faster than}}
{{blackBold|# read() + write()}}
sendfile on;
{{blackBold|# bucket size for the server names hash tables}}
server_names_hash_bucket_size 128;
{{blackBold|# disables emitting nginx version on error pages and in the "server"}}
{{blackBold|# response header field}}
server_tokens off;
{{blackBold|# send headers in one piece, it is better than sending them one by one}}
tcp_nopush on;
{{blackBold|# don't buffer data sent, good for small data bursts in real time}}
tcp_nodelay on;
{{blackBold|# hash table maximum size -- default 1024}}
types_hash_max_size 4096;
 
{{blackBold|# redirect all non-encrypted (http) traffic to encrypted (https)}}
server &#123;
server_name _;
listen *:80 default_server;
listen [::]:80 default_server;
return 301 <nowiki>https://$host$request_uri;</nowiki>
&#125;
 
{{blackBold|# include domain configuration files}}
include /nginx/vhosts.d/*.conf;
&#125;
 
{{blackBold|# vim: ft{{=}}nginx ts{{=}}4 sw{{=}}4 noet :}}}}
=== FastCGI ===
=== FastCGI ===
Create a {{mono|fastcgi_params}} config file (PHP environmental variable defaults).
Create a {{mono|fastcgi_params}} config file (PHP environmental variable defaults).

Revision as of 21:03, 3 May 2021

Icon  Back to Category:Arch Linux

Icon Introduction

Icon NGINX

Beforehand be sure to determine weather the web server will be using MySQL (ie. MariaDB) or PostgreSQL.

Begin by installing NGINX, PHP and other required utilities.

# pikaur -S apache-tools composer curl minify nginx php-fpm sassc wget

Install all of the required PHP extensions.

# pikaur -S php-gd php-geoip php-imagick php-intl php-memcache php-odbc php-sqlite php-sodium xdebug

Next create the environment for the web server.

# sudo mkdir -p /nginx/conf.d /nginx/https /nginx/logs /nginx/sql /nginx/ssl /nginx/vhosts.d
 
# sudo chown -R http:http /nginx
 
# sudo chmod -R 770 /nginx
 
# sudo chmod 750 /nginx/sql
 
# sudo gpasswd -a username http

Set the default shell for http to Bash.

# sudo chsh http
New shell [/usr/bin/nologin]: /bin/bash

Icon Database

PostgreSQL

Using postgresql as a back-end will require the following setup and configuration.

# pikaur -S postgresql php-pgsql
 
# sudo chown postgres:postgres /nginx/sql
 
# sudo gpasswd -a username postgres

Swap over to the postgresql user account.

# sudo -iu postgres

Run the database initialization.

# initdb --locale en_US.UTF-8 -E UTF8 -D '/nginx/sql/data'

Return to the normal user account.

# exit

Modify the systemd service file to reflect the new data directory.

# sudo systemctl edit postgresql.service
 
filename: postgresql.service
Environment=PGROOT=/nginx/sql
PIDFile=/nginx/sql/postmaster.pid

Start and enable the systemd service.

# sudo systemctl enable --now postgresql.service

Swap back over to the postgresql user account.

# sudo -iu postgres

Create a new postgres user account.

# createuser -P --interactive
Enter name of role to add: username
Enter password for new role: ********
Enter it again: ********
Shall the new role be a superuser? (y/n) n
Shall the new role be allowed to create databases? (y/n) y
Shall the new role be allowed to create more new roles? (y/n) n

MariaDB

Using mariadb as a back-end will require the following setup and configuration.

# pikaur -S mariadb
 
# sudo chown mysql:mysql /nginx/sql

Give the current logged in user access.

# sudo gpasswd -a username mysql

Create and initialize the data directory.

# mariadb-install-db --user=mysql --basedir=/usr --datadir=/nginx/sql
 
# sudoedit /etc/my.cnf.d/server.cnf
 
filename: /etc/my.cnf.d/server.cnf
[mysqld]
datadir=/nginx/sql

Start and enable the MySQL service.

# sudo systemctl enable --now mariadb.service

Secure the installation and set the root password.

# sudo mysql_secure_installation
IconThe default mysql root password is none

Connect to mysql using the root account and the password you previously set.

# sudo mysql -u root -p

Add a new mysql user account.

# MariaDB [(none)]> GRANT ALL PRIVILEGES ON *.* TO 'kyau'@'localhost' \
  IDENTIFIED BY 'user_password' WITH GRANT OPTION;

Icon PHP Configuration

First remove the default pool.

# sudo rm /etc/php/php-fpm.d/www.conf

Create the defaults for all pools.

# sudoedit /etc/php/php-fpm.d/defaults.inc
 
filename: /etc/php/php-fpm.d/defaults.inc
user = http
group = http
listen = /run/php-fpm/php-fpm-$pool.sock
listen.owner = http
listen.group = http
; process configuration
pm = dynamic
pm.max_children = 5
pm.start_servers = 2
pm.min_spare_servers = 1
pm.max_spare_servers = 3
; php.ini changes
php_admin_flag[expose_php] = off
php_admin_flag[log_errors] = on
php_admin_flag[short_open_tag] = on
php_admin_value[date.timezone] = America/Los_Angeles
php_admin_value[error_log] = /nginx/logs/$pool/php.log
php_admin_value[memory_limit] = 256M
php_admin_value[post_max_size] = 2048M
php_admin_value[session.save_path] = /tmp
php_admin_value[upload_max_filesize] = 2048M

Enable all third party PHP extensions that were installed.

# sudo find . -type f -name '*.ini' -exec sed -i -e 's/^;extension/extension/g' \
  -e 's/^;zend_extension/zend_extension/g' -e 's/^;xdebug/xdebug/g' {} +

Enable global PHP extensions.

# sudoedit /etc/php/conf.d/defaults.ini
 
filename: /etc/php/conf.d/defaults.ini
extension=bz2
extension=exif
extension=gd
extension=gettext
extension=gmp
extension=iconv
extension=intl
extension=sodium
extension=mysqli
extension=odbc
extension=pdo_mysql
extension=pdo_odbc
extension=pdo_sqlite
extension=sockets
extension=sqlite3
; opcache
zend_extension=opcache
opcache.enable = 1
opcache.interned_strings_buffer = 8
opcache.max_accelerated_files = 10000
opcache.memory_consumption = 128
opcache.save_comments = 1
opcache.revalidate_freq = 1

Create a php-fpm pool for the domain being setup (use a different pool for each site/domain).

# sudoedit /etc/php/php-fpm.d/domain_com.conf
 
filename: /etc/php/php-fpm.d/domain_com.conf
; $KYAULabs: domain_com.conf,v 1.0.0 2021/05/01 12:36:14 kyau Exp $

[domain_com]
include = /etc/php/php-fpm.d/defaults.inc
env[HOSTNAME] = domain.com
env[PATH] = /usr/local/bin:/usr/bin:/bin
env[TMP] = /tmp
env[TMPDIR] = /tmp
env[TEMP] = /tmp

; vim: ft=dosini sw=4 ts=4 noet:

Be sure to set the file permissions properly.

# sudo chmod 644 /etc/php/conf.d/defaults.ini /etc/php/php-fpm.d/*

Start and enable the php-fpm service.

# sudo systemctl enable --now php-fpm.service

Icon NGINX Configuration

Create a blank configuration file.

# sudo install -g http -m 660 -o http /dev/null /nginx/conf.d/nginx.conf

Copy the MIME types file.

# sudo install -g http -m 660 -o http /etc/nginx/mime.types /nginx/conf.d/mime.types

Remove the default config in nginx.conf and replace it with an include (to the new config location).

# sudoedit /etc/nginx/nginx.conf
 
filename: /etc/nginx/nginx.conf
include /nginx/conf.d/nginx.conf;

Create the nginx config file.

# sudoedit /nginx/conf.d/nginx.conf
 
filename: /nginx/conf.d/nginx.conf
# $KYAULabs: nginx.conf,v 1.1.7 2021/05/03 18:14:27 kyau Exp $

# Help / Additional Info {{{ # always test configuration before reload! # $ sudo nginx -t # reload the configuration by using reload not restart! # $ sudo systemctl reload nginx # https://www.nginx.com/resources/wiki/start/topics/tutorials/config_pitfalls/ # }}}

# enables the use of “just-in-time compilation” for the regular expressions # known by the time of configuration parsing pcre_jit on; # user and group credentials used by worker processes user http http; # number of worker processes (auto will autodetect number of CPU cores) worker_processes auto; # binds worker processes automatically to available CPUs worker_cpu_affinity auto; # number of file descriptors used for nginx worker_rlimit_nofile 65535;

events { # worker process will accept one/all (off/on) connection(s) at a time multi_accept on; # maximum number of simultaneous connections that can be opened by a worker worker_connections 65535; }

http { # mime types include /nginx/conf.d/mime.types; # to boost I/O on HDD we can disable access logs access_log off; # read and send using multi-threading, without blocking a worker process aio threads; # hide index pages autoindex off; # add to 'Content-Type' response header charset utf-8; # request timed out -- default 60 client_body_timeout 10; # sets the maximum allowed size of the client request body -- default 1 client_max_body_size 16m; # default mime type default_type text/plain; # enable gzipping of responses gzip on; # disables gzipping of responses for msie6 and below gzip_disable "msie6"; # minimum length of a response that will be gzipped -- default 20 gzip_min_length 1024; # gzip compression level -- default 1 gzip_comp_level 6; gzip_vary on; gzip_proxied expired no-cache no-store private auth; # text/html is always compressed gzip_types text/css text/javascript text/xml text/x-component application/javascript application/x-javascript application/json application/xml application/rss+xml application/atom+xml font/truetype font/opentype application/vnd.ms-fontobject image/svg+xml; # files that will be used as an index, checked in the specified order index index.php index.html index.htm index.txt; # enables keep-alive connections with all browsers keepalive_disable none; # keep-alive client connections stay active for -- default 75 keepalive_timeout 30s; # specifies log format log_format main '$remote_addr - $remote_user [$time_local] ' '"$request" $status $body_bytes_sent ' '"$http_referer" "$http_user_agent"'; # disables logging of errors about not found files into error_log log_not_found off; # allow the server to close connection on non responding client, this will # free up memory reset_timedout_connection on; # if client stops responding, free up memory -- default 60 send_timeout 10; # copies data between one FD and other from within the kernel faster than # read() + write() sendfile on; # bucket size for the server names hash tables server_names_hash_bucket_size 128; # disables emitting nginx version on error pages and in the "server" # response header field server_tokens off; # send headers in one piece, it is better than sending them one by one tcp_nopush on; # don't buffer data sent, good for small data bursts in real time tcp_nodelay on; # hash table maximum size -- default 1024 types_hash_max_size 4096;

# redirect all non-encrypted (http) traffic to encrypted (https) server { server_name _; listen *:80 default_server; listen [::]:80 default_server; return 301 https://$host$request_uri; }

# include domain configuration files include /nginx/vhosts.d/*.conf; }

# vim: ft=nginx ts=4 sw=4 noet :

FastCGI

Create a fastcgi_params config file (PHP environmental variable defaults).

# sudoedit /nginx/conf.d/fastcgi_params
 
filename: /nginx/conf.d/fastcgi_params
# $KYAULabs: fastcgi_params,v 1.0.5 2021/05/03 17:31:37 kyau Exp $

fastcgi_param QUERY_STRING $query_string;
fastcgi_param REQUEST_METHOD $request_method;
fastcgi_param CONTENT_TYPE $content_type;
fastcgi_param CONTENT_LENGTH $content_length;

fastcgi_param SCRIPT_FILENAME $request_filename;
fastcgi_param SCRIPT_NAME $fastcgi_script_name;
fastcgi_param REQUEST_URI $request_uri;
fastcgi_param DOCUMENT_URI $document_uri;
fastcgi_param DOCUMENT_ROOT $document_root;
fastcgi_param SERVER_PROTOCOL $server_protocol;
fastcgi_param REQUEST_SCHEME $scheme;
fastcgi_param HTTPS $https if_not_empty;

fastcgi_param GATEWAY_INTERFACE CGI/1.1;
#fastcgi_param SERVER_SOFTWARE nginx/$nginx_version;
fastcgi_param SERVER_SOFTWARE nginx;

fastcgi_param REMOTE_ADDR $remote_addr;
fastcgi_param REMOTE_PORT $remote_port;
fastcgi_param SERVER_ADDR $server_addr;
fastcgi_param SERVER_PORT $server_port;
fastcgi_param SERVER_NAME $server_name;

# PHP only, required if PHP was built with --enable-force-cgi-redirect
fastcgi_param REDIRECT_STATUS 200;

# Mitigate https://httpoxy.org/ vulnerabilities
fastcgi_param HTTP_PROXY "";

# vim: ft=nginx ts=4 sw=4 noet :

SSL/TLS

Create an SSL config file (SSL/TLS hardening/defaults).

# sudoedit /nginx/conf.d/ssl.conf
 
filename: /nginx/conf.d/ssl.conf
# $KYAULabs: ssl.conf,v 1.0.3 2021/05/03 18:00:56 kyau Exp $

## SSL/TLS (https://cipherlist.dev/)
#ssl_certificate /etc/letsencrypt/live/${server_name}/fullchain.pem;
#ssl_certificate_key /etc/letsencrypt/live/${server_name}/privkey.pem;
ssl_dhparam /nginx/ssl/dhparam4096.pem; # openssl dhparam -out dhparam4096.pem 4096
ssl_protocols TLSv1.3; # Requires nginx >= 1.13.0
ssl_ciphers EECDH+AESGCM:EDH+AESGCM;
ssl_ecdh_curve secp384r1; # Requires nginx >= 1.1.0
ssl_session_cache shared:SSL:10m;
ssl_session_tickets off; # Requires nginx >= 1.5.9
ssl_session_timeout 10m;
ssl_stapling on; # Requires nginx >= 1.3.7
ssl_stapling_verify on; # Requires nginx >= 1.3.7
ssl_prefer_server_ciphers on;
resolver 1.1.1.1 1.0.0.1 valid=300s; # Change if you run your own DNS servers
resolver_timeout 5s;
add_header Strict-Transport-Security "max-age=63072000; includeSubDomains; preload" always;
add_header X-Frame-Options DENY;
add_header X-Content-Type-Options nosniff;
add_header X-XSS-Protection "1; mode=block";

# vim: ft=nginx ts=4 sw=4 noet :

Create the dhparam as indicated above.

# sudo -u http openssl dhparam -out /nginx/ssl/dhparam4096.pem 4096

Set permissions properly.

# sudo chmod 660 /nginx/ssl/dhparam4096.pem
Retrieved from "https://kyau.net/w/index.php?title=ArchLinux:Nginx&oldid=4693"