linux

2026-05-20

NGINX 零停机平滑升级全流程实操指南一、概述在生产环境下，升级 NGINX 二进制文件通常面临一个挑战：如何升级而不需要停止服务（零停机）？NGINX 通过一套精巧的信号量（Signals）机制实现了平滑升级。其核心原理是：启动一个新的主进程（Master Process）接管监听端口，让旧进程在处理完现有请求后优雅退出，从而实现无缝切换。二、升级前置准备与环境摸底在升级之前，必须确保新版本的编译参数与当前运行的版本完全一致，否则会导致启动失败或功能缺失。1. 查询当前版本及编译参数# 查看当前版本号 nginx -v # 查看详细编译参数 (极其重要，升级时必须使用相同的参数) nginx -V记录项：重点记录 configure arguments 之后的所有内容（如 --prefix=/usr/local/nginx）。2. 确认二进制文件路径与 PID# 确认 nginx 可执行文件路径 which nginx # 确认当前运行的主进程 PID ps aux | grep nginx 记录项：记录 master process 的 PID。3. 配置文件语法检查在任何操作前，确保当前配置文件没有语法错误。nginx -t三、新版本编译准备核心原则：只编译→→不安装。严禁直接执行 make install，因为这会覆盖您生产环境的配置文件。1. 下载并解压wget http://nginx.org/download/nginx-x.x.x.tar.gz tar -zxvf nginx-x.x.x.tar.gz cd nginx-x.x.x2. 配置与编译使用第一阶段记录的编译参数进行配置：# 使用之前 nginx -V 记录的参数 ./configure --prefix=/usr/local/nginx [其他参数...] # 编译生成二进制文件 make编译完成后，新的二进制文件位于 objs/nginx。四、执行平滑升级（核心步骤）步骤 1：二进制文件替换由于 Linux 内核禁止覆盖正在运行的二进制文件（会报 Text file busy），我们必须使用 mv 命令通过改变 inode 的方式进行替换。 # 1. 备份旧文件 cp /usr/local/nginx/sbin/nginx /usr/local/nginx/sbin/nginx.bak # 2. 使用 mv 替换新文件 (绕过 Text file busy) mv objs/nginx /usr/local/nginx/sbin/nginx # 3. (可选) 如果系统中有快捷路径 /usr/local/bin/nginx，请同步更新 cp /usr/local/nginx/sbin/nginx /usr/local/bin/nginx步骤 2：启动新主进程 (USR2)向旧主进程发送 USR2 信号，通知其启动新版本的二进制进程。 kill -USR2 <旧MasterPID> 状态：此时，旧主进程和新主进程同时存在，它们共同监听端口，但新请求将开始分发给新进程。步骤 3：优雅停止旧工作进程 (WINCH) 向旧主进程发送 WINCH 信号，通知旧的工作进程（Worker Processes）在处理完当前请求后立即退出。 code Bash kill -WINCH <旧MasterPID> 状态：此时，所有新流量已全部由新版本进程处理。步骤 4：业务验证（关键环节）在彻底删除旧版本前，必须进行全方位验证：本地验证： curl -I http://127.0.0.1:端口外部验证： telnet IP 端口或浏览器访问。日志验证： tail -f /usr/local/nginx/logs/error.log 检查是否有 [emerg] 报错。 ### 步骤 5：彻底关闭旧主进程 (QUIT) 确认业务运行稳定后，关闭不再需要的旧主进程。 ```text kill -QUIT ``` 五、异常处理与回滚方案 1. 怎么回滚？如果在步骤 3 之后发现新版本运行异常，可以通过以下指令将流量瞬间切回旧版本： code Bash # 向新主进程发送 WINCH 信号，让新 worker 退出 kill -WINCH # 此时流量会自动切回尚未关闭的旧 worker 进程 2. 常见坑点排查 ```text Text file busy：不要用 cp 覆盖运行中的文件，必须用 mv。版本显示不一致：如果 nginx -v 显示旧版而 ps 显示新版，说明 /usr/local/bin/nginx 和 /usr/local/nginx/sbin/nginx 两者不一致，请同步覆盖。 Telnet 不通：若 curl 内部通但外部不通，请检查防火墙（Firewalld/Security Group）策略，这通常与 NGINX 升级无关，而是网络层波动。 ``` 六、总结流程图备份→→编译→→mv替换→→USR2(启动新版)→→WINCH(切流量)→→验证→→QUIT(删旧版)

2026年05月20日
1 阅读
0 评论
0 点赞

2026-01-11

Onlyoffice 文件大小超出了为服务器设置的限制我的容器名是 myonlyoffice 请修改成自己的容器名一、从docker 容器中下载 /etc/onlyoffice/documentserver/default.jsondocker cp myonlyoffice:/etc/onlyoffice/documentserver/default.json /usr/local/default.json查看 default.json 文件中的 FileConverter"FileConverter": { "converter": { "maxDownloadBytes": 524288000, // 这里要修改 "downloadTimeout": { "connectionAndInactivity": "2m", "wholeCycle": "2m" }, "downloadAttemptMaxCount": 3, "downloadAttemptDelay": 1000, "maxprocesscount": 1, "fontDir": "null", "presentationThemesDir": "null", "x2tPath": "null", "docbuilderPath": "null", "args": "", "spawnOptions": {}, "errorfiles": "", "streamWriterBufferSize": 8388608, "maxRedeliveredCount": 2, "inputLimits": [ { "type": "docx;dotx;docm;dotm", "zip": { "uncompressed": "5000MB", // 修改 "template": "*.xml" } }, { "type": "xlsx;xltx;xlsm;xltm", "zip": { "uncompressed": "1000MB", // 修改 "template": "*.xml" } }, { "type": "pptx;ppsx;potx;pptm;ppsm;potm", "zip": { "uncompressed": "1000MB", // 修改 "template": "*.xml" } } ] } }二、将修改好的配置文件上传到容器中docker cp /usr/local/default.json myonlyoffice:/etc/onlyoffice/documentserver/default.json在重启容器docker restart myonlyoffice三、完成

2026年01月11日
0 阅读
0 评论
0 点赞

2025-11-27

centos8.5更换阿里yum源 1、删除centos8 /etc/yum.repos.d/目录下的所有yum源。cd /etc/yum.repos.d/ && rm -rf *repo 2、下载 CentOS-Base.repo 到 /etc/yum.repos.d/。curl -o /etc/yum.repos.d/CentOS-Base.repo https://mirrors.aliyun.com/repo/Centos-vault-8.5.2111.repo3、运行 yum makecache 生成缓存。yum makecache

2025年11月27日
0 阅读
0 评论
0 点赞

2025-11-26

在联网机器上下载所有 RPM 包并在离线机器上安装所有软件在联网机器上下载所有 RPM 包并在离线机器上安装所有软件下载1. 安装下载工具sudo dnf install -y dnf-utils2. 创建目录mkdir ~/openEuler-20.03-LTS-SP4 && cd ~/openEuler-20.03-LTS-SP43. 启用必要仓库（关键！）欧拉openEuler系统sudo dnf config-manager --set-enabled everything EPOLCentos8.5系统sudo dnf config-manager --set-enabled base AppStream3. 下载dnf download --resolve \ nginx \ redis \ docker \ java-1.8.0-openjdk \ java-1.8.0-openjdk-devel4. 验证ls -l *.rpm | wc -l5. 打包tar -czvf openEuler-24.03-LTS-x86_64.tar.gz *.rpm安装：1. 解压 RPM 包cd /tmp tar -xzvf offline-apps.tar.gz dnf deplist java-1.8.0-openjdk2. 安装所有软件（自动解决依赖顺序）sudo dnf install -y *.rpm# （如果系统只有 yum，没有 dnf，可用：） # sudo yum localinstall -y *.rpm3. 启动并启用服务sudo systemctl enable --now nginx sudo systemctl enable --now redis sudo systemctl enable --now docker4. 验证安装结果nginx -v # 应显示版本 redis-cli --version # 应显示版本 docker --version # 应显示版本 java -version # 应显示 OpenJDK 17 curl http://localhost # 应看到 nginx 欢迎页

2025年11月26日
0 阅读
0 评论
0 点赞

2025-10-15

2025年10月15日
0 阅读
0 评论
0 点赞

2025-09-29

OnlyOffice 9.0.4 前端定制记录：去除匿名命名弹窗、隐藏插件菜单、关闭页眉 Logo 链接前言本文记录在 OnlyOffice DocumentServer Web 前端侧的定制修改，适用于 9.0.4 版本。修改基于统一 SDK api.js，对所有编辑器生效（文档/表格/演示/PDF/Visio）。一、修改目标关闭“输入用于协作的名称”匿名命名弹窗隐藏“插件”功能区选项卡，并禁用插件能力隐藏页眉左上角的 OnlyOffice Logo（去除跳转链接）二、变更文件与位置生产服务真实使用目录（按你的安装方式选择其一）：Docker: /var/www/onlyoffice/documentserver/web-apps/apps/api/documents/api.jsLinux 安装版: 同上路径Windows 安装版: C:\Program Files\ONLYOFFICE\DocumentServer\web-apps\apps\api\documents\api.js模板文件（务必同步）：api.js.tpl压缩文件（务必处理）：api.js.gz（可能还有 api.js.br）说明：OnlyOffice 实际加载的资源通常带有版本哈希前缀，例如 /9.0.4-xxxx/web-apps/.../api.js。重启/升级后该目录可能再生成，因此建议同时改模板并处理压缩文件，或在业务集成处直接传参覆盖（见文末“更稳妥做法”）。三、代码改动点（统一 SDK 默认配置）修改 DocsAPI.DocEditor.defaultConfig.editorConfig.customization：// 关闭匿名命名弹窗 anonymous: { request: false }, // 隐藏插件选项卡 layout: { toolbar: { plugins: false } }, // 完全禁用插件能力 plugins: false, // 隐藏页眉 Logo（无渲染自然无链接） logo: { visible: false }以上片段出现在：apps/api/documents/api.js 内 DocsAPI.DocEditor.defaultConfig 对象中同步到 apps/api/documents/api.js.tpl，避免重启后被模板覆盖四、同步到服务端并处理压缩文件 - 必须同步两处源码：api.js 与 api.js.tpl - 压缩资源处理（二选一）： ### 简便做法（回退用未压缩版） ```text # 删除压缩文件，让服务器回退到未压缩的 api.js # Linux rm api.js.gz rm api.js.br # Windows 资源管理器直接删除 api.js.gz（和 api.js.br，如果有） ``` ### 推荐做法（保持压缩以提升性能） Windows（7-Zip + Brotli）： ```text # 进入目录：.../web-apps/apps/api/documents/ 7z a -tgzip -mx=9 api.js.gz api.js # 若有 brotli .\brotli.exe -f -q 11 api.js -o api.js.br ``` Linux： ```text # 进入目录：.../web-apps/apps/api/documents/ gzip -c -9 api.js > api.js.gz brotli -f -q 11 api.js -o api.js.br # 如需 ``` 完成后：重启 DocumentServer/容器/反向代理（示例：supervisorctl restart all 或重启容器/服务）清浏览器与代理/CDN 缓存；或追加时间戳强刷： http:///web-apps/apps/api/documents/api.js?_ts=1690000000000 ## 五、验证步骤 1) 打开浏览器开发者工具 Network，搜索 api.js，确认实际请求路径（可能是带版本号的路径）。 2) 点开响应，搜索关键字： anonymous 且包含 ```text request: false layout.toolbar.plugins = false customization.plugins = false logo.visible = false ``` 3) 打开任一文档：不再出现“输入用于协作的名称”弹窗顶部“插件”选项卡消失页眉左上角 Logo 不显示（无链接） ## 六、常见问题与排查 ### 修改后又“恢复默认”：可能只改了非模板文件，重启后由 api.js.tpl 重新生成可能改了非版本目录；服务端实际使用的是带版本目录 ### 浏览器仍旧显示老配置：优先返回 .gz/.br，未处理压缩文件导致浏览器/代理/CDN 缓存未清 ### 个别页面仍有“插件”按钮或弹窗：该页面在 new DocsAPI.DocEditor(..., config) 显式传参覆盖了默认值

2025年09月29日
0 阅读
0 评论
0 点赞

2025-09-11

CentOS 麒麟V10 系统上安装 Java 1.8.0_241（即 Java 8 Update 241）前言CentOS 系统上安装 Java 1.8.0_241（即 Java 8 Update 241），这是一个较旧但仍在企业中广泛使用的版本。由于 Oracle 从 Java 8u211 之后开始对商业用户收费，并限制公开下载，因此官方不再提供直接下载链接。开始安装# 1. 安装 OpenJDK 8 sudo yum install -y java-1.8.0-openjdk-devel # 2. 验证安装 java -version javac -version输出示例：openjdk version "1.8.0_xxx" OpenJDK Runtime Environment (...) OpenJDK 64-Bit Server VM (...)

2025年09月11日
0 阅读
0 评论
0 点赞

2025-09-04

2025年09月04日
0 阅读
0 评论
0 点赞