This document summarizes the configuration of an nginx.conf file. It explains the purpose and optimal settings for various configuration directives over 24 lines, including setting the user and group, number of worker processes, log files, included configuration files for mimetypes and proxies, the index directive, default response type, log formatting, and settings for access logging, sendfile, tcp_nopush, and server_name_hash_bucket_size.

1. study2study #4
-Nginx -
@n0ts
Naoya NAKAZAWA
11/11/2011

2. who?
• @n0ts
• Naoya NAKAZAWA
•
• 22.5 /

4. nginx.conf
http://wiki.nginx.org/
NginxFullExample
line 1-24

5. line 1
user www www;

6. user www www;
line 1
: nobody nobody
root
setuid()/setguid()

7. line 2
worker_processes 5;

8. line 2
worker_processes 5;
: wroker_processes < >
:1
CPU nginx
CPU

9. worker_processes 5;
cont ;
- SMP
- I/O
- select()/poll() 1
events

10. line 3
error_log logs/error.log;

11. error_log logs/error.log;
line 3
: error_log < > [ debug | info | notice | warn | error | crit ]
: ${prefix}/logs/error.log
(fastcgi )
- main : error
- HTTP : crit
- server : crit
VirtualHost

12. line 4
pid logs/nginx.pid;

13. pid logs/nginx.pid;
line 4
: pid < >
PID
HUP
# kill -HUP `cat logs/nginx.pid`

14. line 5
worker_rlimit_nofile 8192;

15. worker_rlimit_nofile 8192;
line 5
: worker_rlimit_nofile < >
: OS

16. line 7
events {

17. events {
line 7
Events
Nginx
accept_mutex, accept_mutex_delay,
debug_connection, devpoll_changes, devpoll_events,
kqueue_changes, kqueue_events, epoll_events,
multi_accept, rtsig_signo, rtsig_overflow_events,
rtsig_overflow_test, rtsig_overflow_threshold, use,
worker_connections

18. line 8
worker_connections 4096;

19. worker_connections 4096;
line 8
: worker_connections < >
: ?
max_clients = worker_processes * worker_connections
max_clients = worker_processes * worker_connectins / 4

20. line 9
}

21. }
line 9

22. line 11
http {

23. http {
line 11
HTTP
Nginx HTTP
64

24. line 12
include conf/mime.types;

25. include conf/mime.types;
line 12
: include < >
:
v0.4.4
include vhosts/*.conf;

26. line 13
include /etc/nginx/proxy.conf;

27. include /etc/nginx/proxy.conf;
line 13

28. line 14
include /etc/nginx/fastcgi.conf

29. include /etc/nginx/fastcgi.conf
line 14

30. line 15
index index.html index.htm index.php;

31. line 15
index index.html index.htm index.php;
: index < >
: index.html

32. line 17
default type application/octet-stream;

33. line 17
default type application/octet-stream;
: default_type <MIME >
text/plain
MIME
MIME

34. line 18-20
log_format main
'$remote_addr - $remote_user [$time_local] $status '
'"$request" $body_bytes_sent "$http_referer" '
'"$http_user_agent" "$http_x_forwarded_for"';

35. log_format main
line 18-20
'$remote_addr - $remote_user [$time_local] $status '
'"$request" $body_bytes_sent "$http_referer" '
'"$http_user_agent" "$http_x_forwarded_for"';
: log_format < >< >
: log_format combined “...”
%b Apache mod_log_config
combined
log_format combined ‘$remote_addr - $remote_user [$time_local] ‘
‘“$request” $status $body_bytes_sent ‘
‘“$http_referer” “$http_user_agent”’;

36. line 21
access_log logs/access.log main;

37. access_log logs/access.log main;
line 21
: access_log < > [< >[ = ]] | off
: log/access.log combined

38. line 22
sendfile on;

39. line
sendfile on; 22
: sendfile [on | off]
: sendfile off
sendfile()

40. line 23
tcp_nopush on;

41. tcp_nopush on;
line 23
: tcp_nopush [on | off]
: off
FreeBSD
TCP_NOPUSH Linux TCP_CORK
sendfile

42. line 24
server_name_hash_bucket_size 128;

43. server_name_hash_bucket_size 128;
line 24
: server_names_hash_bucket_size >
: 32/64/128
CPU

45. Thanks!