自定义 Nginx 配置

APISIX 使用的 Nginx 配置是通过模板文件 apisix/cli/ngx_tpl.lua 以及 apisix/cli/config.lua 和conf/config.yaml 中的参数生成的。

在执行完 ./bin/apisix start，你可以在 conf/nginx.conf 看到生成的 Nginx 配置文件。

如果你需要自定义 Nginx 配置，请阅读 conf/config.default.example 中的 nginx_config。你可以在 conf/config.yaml 中覆盖默认值。例如，你可以在 conf/nginx.conf 中通过配置 xxx_snippet 条目注入一些代码片段：

  1. ...
  2. # config.yaml 里面的内容
  3. nginx_config:
  4.     main_configuration_snippet: |
  5.         daemon on;
  6.     http_configuration_snippet: |
  7.         server
  8.         {
  9.             listen 45651;
  10.             server_name _;
  11.             access_log off;
  13.             location /ysec_status {
  14.                 req_status_show;
  15.                 allow 127.0.0.1;
  16.                 deny all;
  17.             }
  18.         }
  20.         chunked_transfer_encoding on;
  22.     http_server_configuration_snippet: |
  23.         set $my "var";
  24.     http_admin_configuration_snippet: |
  25.         log_format admin "$request_time $pipe";
  26.     http_end_configuration_snippet: |
  27.         server_names_hash_bucket_size 128;
  28.     stream_configuration_snippet: |
  29.         tcp_nodelay off;
  30. ...

注意nginx_config及其子项的格式缩进，在执行./bin/apisix start时，错误的缩进将导致更新conf/nginx.conf文件失败。