| --- |
| title: 自定义 Nginx 配置 |
| --- |
| |
| <!-- |
| # |
| # Licensed to the Apache Software Foundation (ASF) under one or more |
| # contributor license agreements. See the NOTICE file distributed with |
| # this work for additional information regarding copyright ownership. |
| # The ASF licenses this file to You under the Apache License, Version 2.0 |
| # (the "License"); you may not use this file except in compliance with |
| # the License. You may obtain a copy of the License at |
| # |
| # http://www.apache.org/licenses/LICENSE-2.0 |
| # |
| # Unless required by applicable law or agreed to in writing, software |
| # distributed under the License is distributed on an "AS IS" BASIS, |
| # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| # See the License for the specific language governing permissions and |
| # limitations under the License. |
| # |
| --> |
| |
| APISIX 会通过 `apisix/cli/ngx_tpl.lua` 这个模板和 `conf/config-default.yaml` 加 `conf/config.yaml` 的配置生成 Nginx 配置文件。 |
| |
| 在执行完 `./bin/apisix start`,你可以在 `conf/nginx.conf` 看到生成的 Nginx 配置文件。 |
| |
| 在自定义 Nginx 配置文件之前,烦请仔细阅读 `conf/config-default.yaml`。你可以在 `conf/config.yaml` 里面覆盖掉默认值。举个例子,你可以通过 `xxx_snippet` 之类的配置,在 `conf/nginx.conf` 里面注入你的自定义配置: |
| |
| ```yaml |
| ... |
| # config.yaml 里面的内容 |
| nginx_config: |
| main_configuration_snippet: | |
| daemon on; |
| http_configuration_snippet: | |
| server |
| { |
| listen 45651; |
| server_name _; |
| access_log off; |
| |
| location /ysec_status { |
| req_status_show; |
| allow 127.0.0.1; |
| deny all; |
| } |
| } |
| |
| chunked_transfer_encoding on; |
| |
| http_server_configuration_snippet: | |
| set $my "var"; |
| http_admin_configuration_snippet: | |
| log_format admin "$request_time $pipe"; |
| http_end_configuration_snippet: | |
| server_names_hash_bucket_size 128; |
| stream_configuration_snippet: | |
| tcp_nodelay off; |
| ... |
| ``` |
| |
| 注意`nginx_config`及其子项的格式缩进,在执行`./bin/apisix start`时,错误的缩进将导致更新`conf/nginx.conf`文件失败。 |