原文作者：Maxim Ivanitskiy of F5

原文链接：无需重启 NGINX 开源版即可实现 SSL/TLS 证书轮换

转载来源：NGINX 开源社区

---

NGINX 唯一中文官方社区 ，尽在 nginx.org.cn

在高性能 Web 服务器领域，NGINX 是一个广受欢迎的选择，因为其轻便高效的架构支持它处理大量流量。通过在 NGINX JavaScript 模块（njs）中引入共享字典（shared dictionary）功能，NGINX 的性能更上一层楼。

在本文中，我们将探讨 njs 共享字典的功能和优势，并展示如何设置 NGINX 开源版，以无需重启即可轮换 SSL/TLS 证书。

共享字典简介及其优势

新 js_shared_dict_zone 指令允许 NGINX 开源版用户启用共享内存区，在 worker 进程之间高效交换数据。 这些共享内存区充当键值字典，存储着可实时访问和修改的动态配置设置。

共享字典的主要优势包括：

• 开销极少且易于使用 – 直接内置在 njs 中，得益于直观的 API 和简单的实现，可轻松配置和使用。它还能够帮助您简化 worker 进程之间的数据管理和共享。
• 轻量高效 – 与 NGINX 无缝集成，利用其事件驱动型非阻塞 I/O 模型。这种方法减少了内存占用，并提高了并发处理能力，支持 NGINX 高效处理大量并发连接。
• 可扩展性 – 借助 NGINX 跨多个 worker 进程的横向扩展能力，您可以在这些进程之间共享和同步数据，而无需复杂的进程间通信机制。通过 time-to-live (TTL) 设置，您可以管理共享字典条目中的记录，将不活动的条目从区域中删除。evict 参数会删除最早的键值对，为新条目腾出空间。

使用共享字典进行 SSL 轮换

共享字典最有效的用例之一是 SSL/TLS 轮换。使用 js_shared_dict_zone 时，无需重启 NGINX 就可更新 SSL/TLS 证书或密钥。此外，它还提供了一个类似 REST 的 API，可用于管理 NGINX 上的证书。

下面是一个 NGINX 配置文件示例，该配置文件使用 js_set 和 ssl_certificate 指令来设置 HTTPS 服务器。 JavaScript 处理程序使用 js_set 从文件中读取 SSL/TLS 证书或密钥。

此配置片段使用共享字典将证书和密钥作为缓存存储在共享内存中。如果没有密钥，则会从磁盘中读取证书或密钥，并将其放入缓存。

您还可以暴露一个位置，以便手动清除缓存。一旦磁盘上的文件更新（如证书和密钥更新），共享字典就会从磁盘中读取这些更新。该调整允许在不重启 NGINX 进程的情况下轮换证书/密钥。

http {
     ...
    js_shared_dict_zone zone=kv:1m;
   

    server {
    …
     # Sets an njs function for the variable. Returns a value of cert/key
      js_set $dynamic_ssl_cert main.js_cert;
      js_set $dynamic_ssl_key main.js_key;
   

      # use variable's data
      ssl_certificate data:$dynamic_ssl_cert;
      ssl_certificate_key data:$dynamic_ssl_key;
     

     # a location to clear cache 
   location = /clear {
      js_content main.clear_cache;
      # allow 127.0.0.1;
      # deny all;
    }
  ...
  }

下面是使用 js_shared_dict_zone 轮换 SSL/TLS 证书和密钥的 JavaScript 实现：

function js_cert(r) {

  if (r.variables['ssl_server_name']) {
    return read_cert_or_key(r, '.cert.pem');
  } else {
    return '';
  }
}

function js_key(r) {
  if (r.variables['ssl_server_name']) {
    return read_cert_or_key(r, '.key.pem');
  } else {
    return '';
  }
}
/** 
   * Retrieves the key/cert value from Shared memory or fallback to disk
   */
  function read_cert_or_key(r, fileExtension) {
    let data = '';
    let path = '';
    const zone = 'kv';
    let certName = r.variables.ssl_server_name;
    let prefix =  '/etc/nginx/certs/';
    path = prefix + certName + fileExtension;
    r.log('Resolving ${path}');
    const key = ['certs', path].join(':');
    const cache = zone && ngx.shared && ngx.shared[zone];
   

    if (cache) {
    data = cache.get(key) || '';
    if (data) {
      r.log(`Read ${key} from cache`);
      return data;
    }
  }
  try {
    data = fs.readFileSync(path, 'utf8');
    r.log('Read from cache');
  } catch (e) {
    data = '';
    r.log(`Error reading from file:${path}. Error=${e}`);
  }
  if (cache && data) {
    try {
      cache.set(key, data);
      r.log('Persisted in cache');
    } catch (e) {
      const errMsg = `Error writing to shared dict zone: ${zone}. Error=${e}`;
      r.log(errMsg);
    }
  }

  return data
}

可通过发送 /clear 请求让缓存失效，这样 NGINX 在下一次 SSL/TLS 握手时就会从磁盘加载 SSL/TLS 证书或密钥。此外，您还可以使用 js_content 从请求中获取 SSL/TLS 证书或密钥，同时持久化和更新缓存。

本例的完整代码可在 njs GitHub 代码库中找到。

立即开始

共享字典功能是一款强大的应用可编程性工具，在简化和可扩展性方面具有显著优势。利用 js_shared_dict_zone 的功能，您可以发掘新的增长机遇，并高效处理不断增长的流量需求。

准备好使用 js_shared_dict_zone 来加速 NGINX 部署了吗？您可以使用 js_shared_dict_zone 升级 NGINX 部署，解锁新的用例。有关此功能的更多信息，请参阅我们的文档。此外，您还可以在最近推出的 njs-acme 项目（支持 njs 模块运行时与 ACME 提供程序协同工作）中看到共享字典功能的完整示例。

如果您对 NGINX 开源版感兴趣或有任何问题，欢迎微信添加小 N 助手（微信号：nginxoss）加入 NGINX 官方微信群，以了解更多信息、提出问题并获得有关 NGINX 开源版的反馈。

---

NGINX 唯一中文官方社区 ，尽在 nginx.org.cn

更多 NGINX 相关的技术干货、互动问答、系列课程、活动资源： 开源社区官网 | 微信公众号