PDF《Nginx 中文文档》

4 贡献导引 请严格按照以下步骤操作,如有任何问题,请提出 issue 在 GitHub 上点击 fork 将本仓库 fork 到自己的仓库,如 yourname/nginx-docs ,然后 clone 到本地. $ git clone [email protected]:yourname/nginx-docs.git $ cd nginx-docs # 将项目与上游关联 $ git remote add source [email protected]:DocsHome/nginx-docs.git 增加内容或者修复错误后提交,并推送到自己的仓库. $ git add . $ git commit -a Fix issue #1: change helo to hello $ git push origin/master 在 GitHub 上提交 pull request . 请定期更新自己仓库内容. $ git fetch source $ git rebase source/master $ git push -f origin master 排版规范 本项目排版遵循 中文排版指南 规范. 贡献导引

5 Nginx 中文文档 Nginx 官方文档中文翻译版,由本人在学习 nginx 时顺带翻译.因部分章节涉及到 Nginx Plus 或者其他内容,我将忽略该部分章节的内容. 文档前期翻译得比较粗糙,而且是基于旧版文档对照翻译,可能存在许多不当和错误之 处,之后会慢慢修正和校对. 如果您发现内容存在错误或者不当之处,欢迎提出 issue 或 PR,期待您的加入:如何贡献. 在线阅读:Github | GitBook 安装 如果你没有安装 gitbook,则先使用 npm(或者 cnpm)安装 gitbook-cli : npm install gitbook-cli -g 进入项目根目录,执行以下命令运行 gitbook: 安装依赖 gitbook install 启动本地服务器 gitbook serve 项目状态 翻译中…… 介绍

6 排版规范 本项目排版遵循 中文排版指南 规范. LICENSE 本作品采用知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议进行许可. 介绍

7 安装 nginx nginx 可以以不同的方式安装,安装方式取决于当前的操作系统. 在 Linux 上安装 对于 Linux,可以使用 nginx.org 的 nginx 软件包. 在 FreeBSD 上安装 在 FreeBSD 上,可以从 软件包 或通过 ports 系统安装 nginx.ports 系统提供更大的灵活 性,提供了各种选项可供选择.port 将使用指定的选项编译 nginx 并进行安装. 从源码安装 如果需要某些特殊功能软件包和 ports 无法提供,那么可以从源码中编译 nginx.虽然此方式 更加灵活,但对于初学者来说可能会很复杂.更多信息请参阅 从源码构建 nginx. 原文档 http://nginx.org/en/docs/install.html 安装 nginx

8 初学者指南 本指南旨在介绍 Nginx 基本内容和一些在 Nginx 上可以完成的简单任务.这里假设您已经安 装了 nginx,否则请参阅 安装 nginx 页面. 本指南介绍如何启动、停止 nginx 和重新加载配 置,解释配置文件的结构,并介绍如何设置 nginx 以提供静态内容服务,如何配置 nginx 作为 代理服务器,以及如何将其连接到一个 FastCGI 应用程序. nginx 有一个主进程(Master)和几个工作进程(Worker).主进程的主要目的是读取和评估 配置,并维护工作进程.工作进程对请求进行处理.nginx 采用了基于事件模型和依赖于操作 系统的机制来有效地在工作进程之间分配请求.工作进程的数量可在配置文件中定义,并且 可以针对给定的配置进行修改,或者自动调整到可用 CPU 内核的数量(请参阅 worker_processes). 配置文件决定了 nginx 及其模块的工作方式.默认情况下,配置文件名为 nginx.conf ,并放 在目录 /usr/local/nginx/conf , /etc/nginx 或 /usr/local/etc/nginx 中. 启动、停止和重新加载配置 要启动 nginx,需要运行可执行文件.nginx 启动之后,可以通过调用可执行文件附带 -s 参数 来控制它. 使用以下语法: nginx -s 信号 信号可能是以下之一: stop - 立即关闭 quit - 正常关闭 reload - 重新加载配置文件 reopen - 重新打开日志文件 例如,要等待工作进程处理完当前的请求才停止 nginx 进程,可以执行以下命令: nginx -s quit 这个命令的执行用户应该是与启动nginx用户是一致的 在将重新加载配置的命令发送到 nginx 或重新启动之前,配置文件所做的内容更改将不会生 效.要重新加载配置,请执行: 初学者指南