Ubuntu 20.04系统下OpenResty如何使用自定义nginx.conf配置文件？

前置操作：验证自定义配置合法性 #

操作前必须先验证配置文件语法正确，避免启动失败：

# 若提示openresty命令不存在，可替换为完整路径 /usr/local/openresty/bin/openresty
openresty -t -c ~/conf/nginx.conf

返回 test is successful 则代表配置合法，可继续后续操作，否则先修复配置文件内的语法错误。

场景1：临时测试使用自定义配置 #

该方式仅本次生效，重启服务/服务器后会恢复默认配置，适合临时验证配置效果：

• 先停止当前运行的OpenResty服务：sudo systemctl stop openresty
• 加载自定义配置启动：sudo openresty -c ~/conf/nginx.conf
• 验证启动状态：ps aux | grep openresty 或者访问服务端口确认功能正常

场景2：永久生效，重启自动加载自定义配置 #

如果需要每次启动OpenResty都默认加载自定义配置，需要修改systemd服务配置：

• 复制默认服务文件到自定义目录，避免后续OpenResty版本更新覆盖修改：sudo cp /usr/lib/systemd/system/openresty.service /etc/systemd/system/
• 编辑服务文件：sudo nano /etc/systemd/system/openresty.service
• 找到ExecStart配置行，将末尾的默认配置文件路径替换为自定义配置的绝对路径：

  注意：systemd运行环境不识别~相对路径，必须写完整路径，比如root用户的~/conf/nginx.conf对应/root/conf/nginx.conf，普通用户ubuntu的话对应/home/ubuntu/conf/nginx.conf
  修改示例：ExecStart=/usr/local/openresty/nginx/sbin/nginx -c /root/conf/nginx.conf

• 保存退出文件后，重载systemd配置：sudo systemctl daemon-reload
• 重启OpenResty服务生效：sudo systemctl restart openresty
• 验证配置是否生效：sudo systemctl status openresty 确认服务运行正常即可

额外注意事项：

1. 自定义配置文件的读权限需要对OpenResty运行用户开放（默认运行用户通常为nobody或www-data），否则会报权限不足启动失败
2. 每次修改自定义配置后都需要先执行配置合法性校验，再重启服务，避免服务中断

内容的提问来源于stack exchange，提问作者Kid_Learning_C