nginx-stream-ssl-preread/CHANGELOG.md

变更日志 (CHANGELOG)

本文件记录 Nginx Stream + SSL Preread 自动分流方案的所有变更，按时间倒序排列。

格式参考：Keep a Changelog

---

[v2.1] - 2026-10-06

变更（基于服务器实际运行版本同步）

• 新增 worker_rlimit_nofile 16384：提升 Nginx 进程文件描述符上限，适配高并发场景
• stream map 变量名简化：主配置的 $backend_target_40130 简化为 $backend_target（主配置仅一个 map，无需带端口后缀）
• stream access_log 恢复：从 stream_access_40130.log 恢复为 stream_access.log
• include 指令注释优化：明确标注 zhonjin_http.conf include 位置和 zhonjin_stream.conf include 位置

影响文件

• nginx.conf — 更新为服务器实际运行版本

---

[v2.0] - 2026-10-06

架构变更

• 配置文件模块化：将 nginx.conf 拆分为模块化结构，子域名配置独立管理
  • nginx.conf — 主配置（40130 端口 + 全局参数 + include 指令）
  • zhonjin_http.conf — 子域名 HTTP 服务配置，include 到 http 块
  • zhonjin_stream.conf — 子域名 Stream 分流配置，include 到 stream 块
  • zhonjin.com.conf — 配置总览说明文档

新增

服务组 2：mqtt.zhonjin.com:40715 → 内网服务 8085

• 域名：mqtt.zhonjin.com（独立子域名）
• 外网地址：
  • HTTP: http://mqtt.zhonjin.com:40715 → 自动 301 跳转
  • HTTPS: https://mqtt.zhonjin.com:40715
• 映射目标：http://127.0.0.1:8085
• 内部端口：HTTPS 127.0.0.1:5007 / HTTP 跳转 127.0.0.1:5008
• Stream 监听：40715，使用 $backend_target_40715 变量分流
• SSL Session Cache：shared:SSL_mqtt:5m
• 日志：/var/log/nginx/stream_access_40715.log

服务组 3：baolin.zhonjin.com:40716 → 内网服务 5000

• 域名：baolin.zhonjin.com（独立子域名）
• 外网地址：
  • HTTP: http://baolin.zhonjin.com:40716 → 自动 301 跳转
  • HTTPS: https://baolin.zhonjin.com:40716
• 映射目标：http://127.0.0.1:5000
• 内部端口：HTTPS 127.0.0.1:5009 / HTTP 跳转 127.0.0.1:5010
• Stream 监听：40716，使用 $backend_target_40716 变量分流
• SSL Session Cache：shared:SSL_baolin_1:5m
• 日志：/var/log/nginx/stream_access_40716.log

服务组 4：baolin.zhonjin.com:40719 → 内网服务 5001

• 域名：baolin.zhonjin.com（独立子域名）
• 外网地址：
  • HTTP: http://baolin.zhonjin.com:40719 → 自动 301 跳转
  • HTTPS: https://baolin.zhonjin.com:40719
• 映射目标：http://127.0.0.1:5001
• 内部端口：HTTPS 127.0.0.1:5011 / HTTP 跳转 127.0.0.1:5012
• Stream 监听：40719，使用 $backend_target_40719 变量分流
• SSL Session Cache：shared:SSL_baolin_2:5m
• 日志：/var/log/nginx/stream_access_40719.log

技术说明

• 各服务组使用不同子域名，但共用同一通配符证书 *.zhonjin.com
• 每个服务组独立 map 变量，互不干扰
• SSL session cache 名称按域名+编号命名，避免冲突

---

[v1.0] - 初始版本

新增

• 基础架构：Nginx stream 模块 + ssl_preread 协议检测
• 服务组 1：chanking.zhonjin.com:40130 → 内网服务 5004
• HTTP 自动 301 跳转到 HTTPS
• WebSocket 支持（Upgrade 头透传）
• SSL 安全配置：TLSv1.2/1.3, HSTS, 强加密套件
• Stream 独立日志：stream_access.log, stream_error.log

---

已知问题

待发现后记录，格式：

• [日期] 问题描述：影响范围 / 临时解决方案 / 永久修复方案

---

Bug 修复记录

记录所有 bug 修复，格式：

[日期] Bug 标题

• 现象：描述问题表现
• 根因：分析根本原因
• 修复方案：具体修改内容
• 影响文件：涉及的文件列表
• 验证方式：如何确认修复有效