原文作者：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 相关的技术干货、互动问答、系列课程、活动资源： 开源社区官网 | 微信公众号
