SafeLine WAF 添加.mobi域名时Nginx配置优化指南

在使用SafeLine WAF 4.0.2版本时，部分用户在尝试添加.mobi后缀的域名时遇到了Nginx配置相关的错误提示。本文将深入分析该问题的成因，并提供完整的解决方案。

问题现象

当管理员在SafeLine WAF控制台添加如"cyqqqqpace.mobi"这样的域名时，系统会返回以下Nginx配置错误：

nginx conf reload error: 
nginx: [warn] could not build optimal server_names_hash, you should increase either
server_names_hash_max_size: 512 or server_names_hash_bucket_size: 64; ignoring server_names_hash_bucket_size
nginx: [warn] could not build optimal server_names_hash, you should increase either server_names_hash_max_size:
512 or server_names_hash_bucket_size: 64; ignoring server_names_hash_bucket_size

问题根源分析

这个警告信息表明Nginx在处理服务器名称哈希表时遇到了限制。具体来说：

1. server_names_hash_max_size：控制Nginx服务器名称哈希表的最大大小
2. server_names_hash_bucket_size：控制每个哈希桶的大小

当添加的域名数量较多或域名长度较长时，默认配置可能不足以容纳所有域名，特别是像.mobi这样的顶级域名。

完整解决方案

方法一：修改Nginx配置参数

1. 定位到SafeLine的Nginx配置文件目录：

   /data/safeline/resources/nginx/custom_params/
   

2. 编辑或创建backend_1文件，添加以下内容：

   server_names_hash_max_size 1024;
   server_names_hash_bucket_size 128;
   

3. 保存文件后，执行以下命令使配置生效：

   docker exec safeline-mgt nginx -s reload
   

方法二：系统级刷新

如果上述方法无效，可以尝试以下步骤：

1. 执行SafeLine升级命令强制刷新系统配置
2. 清除浏览器缓存后重新登录WAF控制台
3. 再次尝试添加域名

最佳实践建议

1. 对于大型部署环境，建议预先调整Nginx哈希参数：

   • 小型站点：保持默认值即可
   • 中型站点：建议max_size设为1024，bucket_size设为128
   • 大型站点：建议max_size设为2048，bucket_size设为256

2. 定期检查Nginx错误日志，监控哈希表使用情况

3. 添加新域名后，建议验证Nginx配置：

   docker exec safeline-mgt nginx -t
   

通过以上方法，可以确保SafeLine WAF能够正确处理各种后缀的域名添加请求，包括但不限于.mobi域名。这些调整不仅解决了当前问题，也为未来可能的扩展需求做好了准备。