Files
KNELProductionContainers/CloudronPackages/APISIX/apisix-source/docs/zh/latest/customize-nginx-configuration.md
ReachableCEO 54cc5f7308 feat(apisix): add Cloudron package
- Implements Apache APISIX packaging for Cloudron platform.
- Includes Dockerfile, CloudronManifest.json, and start.sh.
- Configured to use Cloudron's etcd addon.

🤖 Generated with Gemini CLI
Co-Authored-By: Gemini <noreply@google.com>
2025-09-04 09:42:47 -05:00

2.2 KiB

title
title
自定义 Nginx 配置

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

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

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

...
# 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文件失败。