<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>BFE on Liangweidong's blog</title><link>https://liangweidonggood.github.io/tags/bfe/</link><description>Recent content in BFE on Liangweidong's blog</description><generator>Hugo -- gohugo.io</generator><language>zh-cn</language><lastBuildDate>Wed, 15 Apr 2026 00:00:00 +0800</lastBuildDate><atom:link href="https://liangweidonggood.github.io/tags/bfe/index.xml" rel="self" type="application/rss+xml"/><item><title>反向代理 6 巨头 + 内网穿透双雄：从 Nginx/Tengine 健康检查到全场景工具横评</title><link>https://liangweidonggood.github.io/p/fan-xiang-dai-li-liu-ju-tou-nei-wang-chuan-tou-shuang-xiong/</link><pubDate>Wed, 15 Apr 2026 00:00:00 +0800</pubDate><guid>https://liangweidonggood.github.io/p/fan-xiang-dai-li-liu-ju-tou-nei-wang-chuan-tou-shuang-xiong/</guid><description>&lt;img src="https://liangweidonggood.github.io/p/fan-xiang-dai-li-liu-ju-tou-nei-wang-chuan-tou-shuang-xiong/image/cover.jpg" alt="Featured image of post 反向代理 6 巨头 + 内网穿透双雄：从 Nginx/Tengine 健康检查到全场景工具横评" /&gt;&lt;h2 id="写于-2026-年-4-月的回望"&gt;写于 2026 年 4 月的回望
&lt;/h2&gt;&lt;p&gt;做博客 14 年，第一次把&amp;quot;反向代理 + 内网穿透&amp;quot;合并到一篇文章里——不是因为它们逻辑上多紧密，而是因为在&lt;strong&gt;写代码、跑业务、对外服务&lt;/strong&gt;这条链路上，这两类工具几乎总是成对出现：你先要有个&lt;strong&gt;公网入口&lt;/strong&gt;（反代 + 四层代理），再考虑&lt;strong&gt;内网服务怎么被访问&lt;/strong&gt;（内网穿透）。&lt;strong&gt;入口打不通，内网穿透也无处发力&lt;/strong&gt;。&lt;/p&gt;
&lt;p&gt;本文是 0.7 批次&amp;quot;架构实战&amp;quot;系列的一篇，合并源文档 9 篇（其中 3 篇有实战内容、6 篇仅有工具骨架），目标是给读者一份&lt;strong&gt;可立即拿去选型&lt;/strong&gt;的横评 + 实战手册。&lt;/p&gt;
&lt;h2 id="全文目录"&gt;全文目录
&lt;/h2&gt;&lt;ul&gt;
&lt;li&gt;一、为什么需要反向代理？3 个真实场景&lt;/li&gt;
&lt;li&gt;二、6 款主流反代工具特性横评&lt;/li&gt;
&lt;li&gt;三、Nginx 与 Tengine：编译安装 + 健康检查实战（基于源文档深度展开）&lt;/li&gt;
&lt;li&gt;四、Stream 四层代理：主动检查 vs 被动检查的踩坑点&lt;/li&gt;
&lt;li&gt;五、内网穿透双雄：frp 与 cpolar 选型&lt;/li&gt;
&lt;li&gt;六、选型矩阵：按业务场景一图看懂&lt;/li&gt;
&lt;li&gt;七、常见 8 个坑点速查&lt;/li&gt;
&lt;/ul&gt;
&lt;hr&gt;
&lt;h2 id="一为什么需要反向代理3-个真实场景"&gt;一、为什么需要反向代理？3 个真实场景
&lt;/h2&gt;&lt;p&gt;&lt;strong&gt;反向代理（Reverse Proxy）&lt;/strong&gt; 站在客户端与真实服务器之间，客户端只看到代理的地址，&lt;strong&gt;永远不知道后端有几台机器&lt;/strong&gt;。在生产环境里，反向代理通常承担三类职责：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;统一入口 + 域名路由&lt;/strong&gt;：把 &lt;code&gt;a.example.com&lt;/code&gt;、&lt;code&gt;b.example.com&lt;/code&gt; 解析到同一个入口，按 &lt;code&gt;Host&lt;/code&gt; 头转发到不同后端&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;TLS 终结 + HTTPS 加速&lt;/strong&gt;：所有证书/加解密在反代层完成，后端只跑明文 HTTP，省 CPU 省证书&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;负载均衡 + 健康检查&lt;/strong&gt;：检测后端故障、自动剔除/恢复&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;在微服务、Service Mesh、API 网关场景里，反代还承担&lt;strong&gt;动态路由、灰度发布、限流熔断&lt;/strong&gt;等高级职责——这正是 Caddy、Traefik、Envoy、BFE 竞相入场的原因。&lt;/p&gt;
&lt;h2 id="二6-款主流反代工具特性横评"&gt;二、6 款主流反代工具特性横评
&lt;/h2&gt;&lt;table&gt;
	&lt;thead&gt;
			&lt;tr&gt;
					&lt;th&gt;工具&lt;/th&gt;
					&lt;th&gt;出品方 / 协议&lt;/th&gt;
					&lt;th&gt;核心定位&lt;/th&gt;
					&lt;th&gt;配置风格&lt;/th&gt;
					&lt;th&gt;动态生效&lt;/th&gt;
					&lt;th&gt;四层代理&lt;/th&gt;
					&lt;th&gt;生态优势&lt;/th&gt;
			&lt;/tr&gt;
	&lt;/thead&gt;
	&lt;tbody&gt;
			&lt;tr&gt;
					&lt;td&gt;&lt;strong&gt;Nginx&lt;/strong&gt;&lt;/td&gt;
					&lt;td&gt;F5 / BSD-2&lt;/td&gt;
					&lt;td&gt;HTTP 反代事实标准&lt;/td&gt;
					&lt;td&gt;静态 conf + reload&lt;/td&gt;
					&lt;td&gt;需 reload&lt;/td&gt;
					&lt;td&gt;stream 模块&lt;/td&gt;
					&lt;td&gt;模块生态最丰富&lt;/td&gt;
			&lt;/tr&gt;
			&lt;tr&gt;
					&lt;td&gt;&lt;strong&gt;Tengine&lt;/strong&gt;&lt;/td&gt;
					&lt;td&gt;阿里 / BSD-2&lt;/td&gt;
					&lt;td&gt;Nginx 增强 + 通用 API 网关&lt;/td&gt;
					&lt;td&gt;兼容 Nginx + 动态配置&lt;/td&gt;
					&lt;td&gt;支持域名/证书/路由动态生效&lt;/td&gt;
					&lt;td&gt;stream + UDP bypass&lt;/td&gt;
					&lt;td&gt;双 11 验证 + Ingress 标注&lt;/td&gt;
			&lt;/tr&gt;
			&lt;tr&gt;
					&lt;td&gt;&lt;strong&gt;Caddy&lt;/strong&gt;&lt;/td&gt;
					&lt;td&gt;个人作者 / Apache-2&lt;/td&gt;
					&lt;td&gt;自动 HTTPS + 极简配置&lt;/td&gt;
					&lt;td&gt;Caddyfile / JSON&lt;/td&gt;
					&lt;td&gt;reload（零停机）&lt;/td&gt;
					&lt;td&gt;需 reverse_proxy + layer4 插件&lt;/td&gt;
					&lt;td&gt;自动 ACME、HTTP/3 默认开&lt;/td&gt;
			&lt;/tr&gt;
			&lt;tr&gt;
					&lt;td&gt;&lt;strong&gt;Traefik&lt;/strong&gt;&lt;/td&gt;
					&lt;td&gt;Traefik Labs / MIT&lt;/td&gt;
					&lt;td&gt;云原生动态反代&lt;/td&gt;
					&lt;td&gt;动态发现（Docker/K8s）&lt;/td&gt;
					&lt;td&gt;热加载（监听 provider）&lt;/td&gt;
					&lt;td&gt;需 entrypoints TCP&lt;/td&gt;
					&lt;td&gt;K8s Ingress 一等公民&lt;/td&gt;
			&lt;/tr&gt;
			&lt;tr&gt;
					&lt;td&gt;&lt;strong&gt;Envoy&lt;/strong&gt;&lt;/td&gt;
					&lt;td&gt;Lyft/CNCF / Apache-2&lt;/td&gt;
					&lt;td&gt;Service Mesh 数据面&lt;/td&gt;
					&lt;td&gt;YAML/JSON xDS&lt;/td&gt;
					&lt;td&gt;xDS 热推送&lt;/td&gt;
					&lt;td&gt;原生 L4/L7&lt;/td&gt;
					&lt;td&gt;Istio 默认 sidecar&lt;/td&gt;
			&lt;/tr&gt;
			&lt;tr&gt;
					&lt;td&gt;&lt;strong&gt;BFE&lt;/strong&gt;&lt;/td&gt;
					&lt;td&gt;百度 / Apache-2&lt;/td&gt;
					&lt;td&gt;大流量七层网关&lt;/td&gt;
					&lt;td&gt;类 Nginx conf&lt;/td&gt;
					&lt;td&gt;动态配置&lt;/td&gt;
					&lt;td&gt;支持七层 + 部分四层&lt;/td&gt;
					&lt;td&gt;百度搜索/地图规模验证&lt;/td&gt;
			&lt;/tr&gt;
	&lt;/tbody&gt;
&lt;/table&gt;
&lt;h3 id="工具生态位速读"&gt;工具生态位速读
&lt;/h3&gt;&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Nginx / Tengine&lt;/strong&gt;：做&amp;quot;经典反代&amp;quot;——&lt;code&gt;nginx.conf&lt;/code&gt; 写好、reload 完事，&lt;strong&gt;适合中小规模、配置不频繁变化的场景&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Caddy&lt;/strong&gt;：做&amp;quot;个人/小团队站点&amp;quot;——&lt;strong&gt;默认自动 HTTPS&lt;/strong&gt;，省心，配置文件 5 行就能跑&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Traefik&lt;/strong&gt;：做&amp;quot;K8s/容器编排动态反代&amp;quot;——&lt;strong&gt;监听 Docker/K8s 标签自动生成路由&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Envoy&lt;/strong&gt;：做&amp;quot;Service Mesh 数据面&amp;quot;——&lt;strong&gt;xDS 协议动态下发配置&lt;/strong&gt;，Istio 默认用它&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;BFE&lt;/strong&gt;：做&amp;quot;超大流量七层网关&amp;quot;——&lt;strong&gt;百度搜索级别流量验证&lt;/strong&gt;，国内大厂可选&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id="三nginx-与-tengine编译安装--健康检查实战"&gt;三、Nginx 与 Tengine：编译安装 + 健康检查实战
&lt;/h2&gt;&lt;p&gt;本节是源文档里有完整实战内容的部分，逐行引用并补全注释。&lt;/p&gt;
&lt;h3 id="31-编译选项对比"&gt;3.1 编译选项对比
&lt;/h3&gt;&lt;div class="highlight"&gt;&lt;div class="chroma"&gt;
&lt;table class="lntable"&gt;&lt;tr&gt;&lt;td class="lntd"&gt;
&lt;pre tabindex="0" class="chroma"&gt;&lt;code&gt;&lt;span class="lnt"&gt; 1
&lt;/span&gt;&lt;span class="lnt"&gt; 2
&lt;/span&gt;&lt;span class="lnt"&gt; 3
&lt;/span&gt;&lt;span class="lnt"&gt; 4
&lt;/span&gt;&lt;span class="lnt"&gt; 5
&lt;/span&gt;&lt;span class="lnt"&gt; 6
&lt;/span&gt;&lt;span class="lnt"&gt; 7
&lt;/span&gt;&lt;span class="lnt"&gt; 8
&lt;/span&gt;&lt;span class="lnt"&gt; 9
&lt;/span&gt;&lt;span class="lnt"&gt;10
&lt;/span&gt;&lt;span class="lnt"&gt;11
&lt;/span&gt;&lt;span class="lnt"&gt;12
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;
&lt;td class="lntd"&gt;
&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;# Nginx 1.24 编译（Debian/Ubuntu 风格）&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;./configure &lt;span class="se"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; --prefix&lt;span class="o"&gt;=&lt;/span&gt;/usr/local/nginx &lt;span class="se"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; --with-http_ssl_module &lt;span class="se"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; --with-http_stub_status_module &lt;span class="se"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; --with-pcre &lt;span class="se"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; --with-http_gzip_static_module &lt;span class="se"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; --with-stream &lt;span class="se"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; --with-stream_ssl_module &lt;span class="se"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; --add-module&lt;span class="o"&gt;=&lt;/span&gt;../nginx_upstream_check_module
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;make &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; make install
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;
&lt;/div&gt;
&lt;/div&gt;&lt;div class="highlight"&gt;&lt;div class="chroma"&gt;
&lt;table class="lntable"&gt;&lt;tr&gt;&lt;td class="lntd"&gt;
&lt;pre tabindex="0" class="chroma"&gt;&lt;code&gt;&lt;span class="lnt"&gt; 1
&lt;/span&gt;&lt;span class="lnt"&gt; 2
&lt;/span&gt;&lt;span class="lnt"&gt; 3
&lt;/span&gt;&lt;span class="lnt"&gt; 4
&lt;/span&gt;&lt;span class="lnt"&gt; 5
&lt;/span&gt;&lt;span class="lnt"&gt; 6
&lt;/span&gt;&lt;span class="lnt"&gt; 7
&lt;/span&gt;&lt;span class="lnt"&gt; 8
&lt;/span&gt;&lt;span class="lnt"&gt; 9
&lt;/span&gt;&lt;span class="lnt"&gt;10
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;
&lt;td class="lntd"&gt;
&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;# Tengine 3.1 编译（额外启用 HTTP/2、realip、upstream_check）&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;./configure &lt;span class="se"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; --prefix&lt;span class="o"&gt;=&lt;/span&gt;/usr/local/nginx &lt;span class="se"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; --with-http_ssl_module &lt;span class="se"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; --with-http_v2_module &lt;span class="se"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; --with-stream &lt;span class="se"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; --with-stream_ssl_module &lt;span class="se"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; --with-http_realip_module &lt;span class="se"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; --with-http_gzip_static_module &lt;span class="se"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; --add-module&lt;span class="o"&gt;=&lt;/span&gt;../nginx_upstream_check_module
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;
&lt;/div&gt;
&lt;/div&gt;&lt;p&gt;Tengine 在 Nginx 1.24 基础上额外提供（&lt;strong&gt;源文档原文特性清单&lt;/strong&gt;）：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;HTTP/3 支持&lt;/strong&gt;（QUIC v1 与 draft-29）&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;基于 header / cookie / query / 服务权重的高级路由&lt;/strong&gt;，&lt;strong&gt;动态无损生效&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;配置分域名 TLS 多版本、timeout、强制 HTTPS、CORS、robots&lt;/strong&gt; 动态生效&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;bypass 内核的用户态 UDP 转发（xUDP）&lt;/strong&gt;，性能远高于内核 UDP&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;流式上传&lt;/strong&gt;到后端 / FastCGI&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;异步 OpenSSL&lt;/strong&gt;，可对接 QAT 硬件加速&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;更强大的负载均衡&lt;/strong&gt;：一致性 hash、会话保持、主动健康检查、动态 upstream 域名解析&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;CSS/JS 合并&lt;/strong&gt;、&lt;strong&gt;空白字符去除&lt;/strong&gt;、&lt;strong&gt;内存监控&lt;/strong&gt;、&lt;strong&gt;CPU 亲缘性自动绑定&lt;/strong&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id="32-迁移原-nginx-到-tengine"&gt;3.2 迁移原 Nginx 到 Tengine
&lt;/h3&gt;&lt;p&gt;源文档提供了一套&lt;strong&gt;保留证书与 conf 的安全迁移流程&lt;/strong&gt;：&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;div class="chroma"&gt;
&lt;table class="lntable"&gt;&lt;tr&gt;&lt;td class="lntd"&gt;
&lt;pre tabindex="0" class="chroma"&gt;&lt;code&gt;&lt;span class="lnt"&gt; 1
&lt;/span&gt;&lt;span class="lnt"&gt; 2
&lt;/span&gt;&lt;span class="lnt"&gt; 3
&lt;/span&gt;&lt;span class="lnt"&gt; 4
&lt;/span&gt;&lt;span class="lnt"&gt; 5
&lt;/span&gt;&lt;span class="lnt"&gt; 6
&lt;/span&gt;&lt;span class="lnt"&gt; 7
&lt;/span&gt;&lt;span class="lnt"&gt; 8
&lt;/span&gt;&lt;span class="lnt"&gt; 9
&lt;/span&gt;&lt;span class="lnt"&gt;10
&lt;/span&gt;&lt;span class="lnt"&gt;11
&lt;/span&gt;&lt;span class="lnt"&gt;12
&lt;/span&gt;&lt;span class="lnt"&gt;13
&lt;/span&gt;&lt;span class="lnt"&gt;14
&lt;/span&gt;&lt;span class="lnt"&gt;15
&lt;/span&gt;&lt;span class="lnt"&gt;16
&lt;/span&gt;&lt;span class="lnt"&gt;17
&lt;/span&gt;&lt;span class="lnt"&gt;18
&lt;/span&gt;&lt;span class="lnt"&gt;19
&lt;/span&gt;&lt;span class="lnt"&gt;20
&lt;/span&gt;&lt;span class="lnt"&gt;21
&lt;/span&gt;&lt;span class="lnt"&gt;22
&lt;/span&gt;&lt;span class="lnt"&gt;23
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;
&lt;td class="lntd"&gt;
&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;# 1. 备份&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;mkdir -p /backup
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;rsync -av /usr/local/nginx/conf/cert /backup/
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;rsync -av /usr/local/nginx/conf/nginx.conf /backup/
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;# 2. 停止原服务（如有 HAProxy/keepalived 协同）&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;systemctl stop keepalived
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;systemctl stop nginx
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;systemctl stop nginxwebui
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;# 3. 卸载旧版&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;rm -rf /usr/local/nginx
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;# 4. 安装 Tengine（编译步骤见 3.1）&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;# 5. 还原备份&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;rsync -av --force /backup/nginx.conf /usr/local/nginx/conf/
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;rsync -av /backup/cert /usr/local/nginx/conf/
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;# 6. 启动&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;systemctl start keepalived
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;systemctl start nginx
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;systemctl start nginxwebui
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;
&lt;/div&gt;
&lt;/div&gt;&lt;p&gt;&lt;strong&gt;关键点&lt;/strong&gt;：Tengine 完全兼容 Nginx 配置，所以可以直接复用 &lt;code&gt;nginx.conf&lt;/code&gt; 与证书目录。&lt;code&gt;--force&lt;/code&gt; 标志在还原时避免 rsync 因目标存在而拒绝覆盖。&lt;/p&gt;
&lt;h2 id="四stream-四层代理主动检查-vs-被动检查的踩坑点"&gt;四、Stream 四层代理：主动检查 vs 被动检查的踩坑点
&lt;/h2&gt;&lt;p&gt;源文档反复强调的一条铁律：&lt;/p&gt;

 &lt;blockquote&gt;
 &lt;p&gt;&lt;strong&gt;注意：这个模块（&lt;code&gt;nginx_upstream_check_module&lt;/code&gt;）只能支持 HTTP，不支持 stream；且被动检查不能和主动检查同时使用。&lt;/strong&gt;&lt;/p&gt;

 &lt;/blockquote&gt;
&lt;h3 id="41-主动健康检查仅-http"&gt;4.1 主动健康检查（仅 HTTP）
&lt;/h3&gt;&lt;div class="highlight"&gt;&lt;div class="chroma"&gt;
&lt;table class="lntable"&gt;&lt;tr&gt;&lt;td class="lntd"&gt;
&lt;pre tabindex="0" class="chroma"&gt;&lt;code&gt;&lt;span class="lnt"&gt; 1
&lt;/span&gt;&lt;span class="lnt"&gt; 2
&lt;/span&gt;&lt;span class="lnt"&gt; 3
&lt;/span&gt;&lt;span class="lnt"&gt; 4
&lt;/span&gt;&lt;span class="lnt"&gt; 5
&lt;/span&gt;&lt;span class="lnt"&gt; 6
&lt;/span&gt;&lt;span class="lnt"&gt; 7
&lt;/span&gt;&lt;span class="lnt"&gt; 8
&lt;/span&gt;&lt;span class="lnt"&gt; 9
&lt;/span&gt;&lt;span class="lnt"&gt;10
&lt;/span&gt;&lt;span class="lnt"&gt;11
&lt;/span&gt;&lt;span class="lnt"&gt;12
&lt;/span&gt;&lt;span class="lnt"&gt;13
&lt;/span&gt;&lt;span class="lnt"&gt;14
&lt;/span&gt;&lt;span class="lnt"&gt;15
&lt;/span&gt;&lt;span class="lnt"&gt;16
&lt;/span&gt;&lt;span class="lnt"&gt;17
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;
&lt;td class="lntd"&gt;
&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-nginx" data-lang="nginx"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="k"&gt;http&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="kn"&gt;upstream&lt;/span&gt; &lt;span class="s"&gt;backend_http&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="kn"&gt;server&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="kn"&gt;{BACKEND_1}}:8080&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="kn"&gt;server&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="kn"&gt;{BACKEND_2}}:8080&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="kn"&gt;check&lt;/span&gt; &lt;span class="s"&gt;type=http&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="kn"&gt;check&lt;/span&gt; &lt;span class="s"&gt;interval=5000&lt;/span&gt; &lt;span class="s"&gt;rise=2&lt;/span&gt; &lt;span class="s"&gt;fall=3&lt;/span&gt; &lt;span class="s"&gt;timeout=2000&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="kn"&gt;check_http_send&lt;/span&gt; &lt;span class="s"&gt;&amp;#34;GET&lt;/span&gt; &lt;span class="s"&gt;/health&lt;/span&gt; &lt;span class="s"&gt;HTTP/1.0\r\nHost:&lt;/span&gt; &lt;span class="s"&gt;example.com\r\n\r\n&amp;#34;&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="kn"&gt;check_http_expect_alive&lt;/span&gt; &lt;span class="s"&gt;http_2xx&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="p"&gt;}&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="kn"&gt;server&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="kn"&gt;listen&lt;/span&gt; &lt;span class="mi"&gt;80&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="kn"&gt;location&lt;/span&gt; &lt;span class="s"&gt;/&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="kn"&gt;proxy_pass&lt;/span&gt; &lt;span class="s"&gt;http://backend_http&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="p"&gt;}&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="p"&gt;}&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;
&lt;/div&gt;
&lt;/div&gt;&lt;p&gt;参数含义（源文档原文）：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;interval&lt;/code&gt;：调用间隔（毫秒）&lt;/li&gt;
&lt;li&gt;&lt;code&gt;rise&lt;/code&gt;：连续成功多少次后标记存活&lt;/li&gt;
&lt;li&gt;&lt;code&gt;fall&lt;/code&gt;：连续失败多少次后摘除&lt;/li&gt;
&lt;li&gt;&lt;code&gt;timeout&lt;/code&gt;：单次检查超时&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id="42-被动健康检查stream-块"&gt;4.2 被动健康检查（stream 块）
&lt;/h3&gt;&lt;div class="highlight"&gt;&lt;div class="chroma"&gt;
&lt;table class="lntable"&gt;&lt;tr&gt;&lt;td class="lntd"&gt;
&lt;pre tabindex="0" class="chroma"&gt;&lt;code&gt;&lt;span class="lnt"&gt; 1
&lt;/span&gt;&lt;span class="lnt"&gt; 2
&lt;/span&gt;&lt;span class="lnt"&gt; 3
&lt;/span&gt;&lt;span class="lnt"&gt; 4
&lt;/span&gt;&lt;span class="lnt"&gt; 5
&lt;/span&gt;&lt;span class="lnt"&gt; 6
&lt;/span&gt;&lt;span class="lnt"&gt; 7
&lt;/span&gt;&lt;span class="lnt"&gt; 8
&lt;/span&gt;&lt;span class="lnt"&gt; 9
&lt;/span&gt;&lt;span class="lnt"&gt;10
&lt;/span&gt;&lt;span class="lnt"&gt;11
&lt;/span&gt;&lt;span class="lnt"&gt;12
&lt;/span&gt;&lt;span class="lnt"&gt;13
&lt;/span&gt;&lt;span class="lnt"&gt;14
&lt;/span&gt;&lt;span class="lnt"&gt;15
&lt;/span&gt;&lt;span class="lnt"&gt;16
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;
&lt;td class="lntd"&gt;
&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-nginx" data-lang="nginx"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="k"&gt;stream&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="kn"&gt;upstream&lt;/span&gt; &lt;span class="s"&gt;backend_tcp&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="kn"&gt;server&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="kn"&gt;{MQTT_NODE_1}}:1883&lt;/span&gt; &lt;span class="s"&gt;fail_timeout=30s&lt;/span&gt; &lt;span class="s"&gt;max_fails=3&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="kn"&gt;server&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="kn"&gt;{MQTT_NODE_2}}:1883&lt;/span&gt; &lt;span class="s"&gt;fail_timeout=30s&lt;/span&gt; &lt;span class="s"&gt;max_fails=3&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="kn"&gt;server&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="kn"&gt;{MQTT_NODE_3}}:1883&lt;/span&gt; &lt;span class="s"&gt;fail_timeout=30s&lt;/span&gt; &lt;span class="s"&gt;max_fails=3&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="kn"&gt;server&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="kn"&gt;{MQTT_NODE_4}}:1883&lt;/span&gt; &lt;span class="s"&gt;fail_timeout=30s&lt;/span&gt; &lt;span class="s"&gt;max_fails=3&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="kn"&gt;server&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="kn"&gt;{MQTT_NODE_5}}:1883&lt;/span&gt; &lt;span class="s"&gt;fail_timeout=30s&lt;/span&gt; &lt;span class="s"&gt;max_fails=3&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="kn"&gt;server&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="kn"&gt;{MQTT_NODE_6}}:1883&lt;/span&gt; &lt;span class="s"&gt;fail_timeout=30s&lt;/span&gt; &lt;span class="s"&gt;max_fails=3&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="kn"&gt;keepalive&lt;/span&gt; &lt;span class="mi"&gt;32&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="p"&gt;}&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="kn"&gt;server&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="kn"&gt;listen&lt;/span&gt; &lt;span class="mi"&gt;1883&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="kn"&gt;proxy_pass&lt;/span&gt; &lt;span class="s"&gt;backend_tcp&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="p"&gt;}&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;
&lt;/div&gt;
&lt;/div&gt;&lt;p&gt;&lt;strong&gt;被动检查的语义&lt;/strong&gt;：客户端连接失败 3 次（&lt;code&gt;max_fails=3&lt;/code&gt;）后，30 秒内不再向该后端转发——完全由&amp;quot;连接失败&amp;quot;驱动，不需要主动探测。&lt;/p&gt;
&lt;h3 id="43-主动-vs-被动什么时候用哪个"&gt;4.3 主动 vs 被动：什么时候用哪个？
&lt;/h3&gt;&lt;table&gt;
	&lt;thead&gt;
			&lt;tr&gt;
					&lt;th&gt;维度&lt;/th&gt;
					&lt;th&gt;主动检查&lt;/th&gt;
					&lt;th&gt;被动检查&lt;/th&gt;
			&lt;/tr&gt;
	&lt;/thead&gt;
	&lt;tbody&gt;
			&lt;tr&gt;
					&lt;td&gt;适用协议&lt;/td&gt;
					&lt;td&gt;HTTP（仅）&lt;/td&gt;
					&lt;td&gt;TCP/UDP/任意四层&lt;/td&gt;
			&lt;/tr&gt;
			&lt;tr&gt;
					&lt;td&gt;检查方式&lt;/td&gt;
					&lt;td&gt;定期 GET 健康路径&lt;/td&gt;
					&lt;td&gt;客户端连接失败计数&lt;/td&gt;
			&lt;/tr&gt;
			&lt;tr&gt;
					&lt;td&gt;摘除速度&lt;/td&gt;
					&lt;td&gt;&lt;code&gt;interval&lt;/code&gt; 周期级&lt;/td&gt;
					&lt;td&gt;30s 内响应&lt;/td&gt;
			&lt;/tr&gt;
			&lt;tr&gt;
					&lt;td&gt;副作用&lt;/td&gt;
					&lt;td&gt;后端会收到&amp;quot;无意义的健康探测&amp;quot;&lt;/td&gt;
					&lt;td&gt;零副作用&lt;/td&gt;
			&lt;/tr&gt;
			&lt;tr&gt;
					&lt;td&gt;踩坑点&lt;/td&gt;
					&lt;td&gt;不能与被动&lt;strong&gt;同时&lt;/strong&gt;用&lt;/td&gt;
					&lt;td&gt;必须配置 &lt;code&gt;max_fails&lt;/code&gt;&lt;/td&gt;
			&lt;/tr&gt;
	&lt;/tbody&gt;
&lt;/table&gt;
&lt;p&gt;&lt;strong&gt;结论&lt;/strong&gt;：&lt;strong&gt;HTTP 反代用主动&lt;/strong&gt;（拿到 2xx 200 状态才算健康）；&lt;strong&gt;stream / MQTT / 数据库连接池用被动&lt;/strong&gt;（主动检查模块不支持 stream）。&lt;/p&gt;
&lt;h3 id="44-主动检查可视化nginx-自带状态页"&gt;4.4 主动检查可视化（Nginx 自带状态页）
&lt;/h3&gt;&lt;div class="highlight"&gt;&lt;div class="chroma"&gt;
&lt;table class="lntable"&gt;&lt;tr&gt;&lt;td class="lntd"&gt;
&lt;pre tabindex="0" class="chroma"&gt;&lt;code&gt;&lt;span class="lnt"&gt;1
&lt;/span&gt;&lt;span class="lnt"&gt;2
&lt;/span&gt;&lt;span class="lnt"&gt;3
&lt;/span&gt;&lt;span class="lnt"&gt;4
&lt;/span&gt;&lt;span class="lnt"&gt;5
&lt;/span&gt;&lt;span class="lnt"&gt;6
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;
&lt;td class="lntd"&gt;
&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;# 启动两个测试后端&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;docker run -d --name nginx1 --restart&lt;span class="o"&gt;=&lt;/span&gt;always -p &lt;span class="o"&gt;{{&lt;/span&gt;PORT_HTTP_1&lt;span class="o"&gt;}}&lt;/span&gt;:80 nginx:latest
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;docker run -d --name nginx2 --restart&lt;span class="o"&gt;=&lt;/span&gt;always -p &lt;span class="o"&gt;{{&lt;/span&gt;PORT_HTTP_2&lt;span class="o"&gt;}}&lt;/span&gt;:80 nginx:latest
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;# 访问状态页&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;curl http://&lt;span class="o"&gt;{{&lt;/span&gt;STATUS_HOST&lt;span class="o"&gt;}}&lt;/span&gt;:&lt;span class="o"&gt;{{&lt;/span&gt;STATUS_PORT&lt;span class="o"&gt;}}&lt;/span&gt;/status
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;
&lt;/div&gt;
&lt;/div&gt;&lt;p&gt;输出示例（源文档原文截图对应文字）：&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;div class="chroma"&gt;
&lt;table class="lntable"&gt;&lt;tr&gt;&lt;td class="lntd"&gt;
&lt;pre tabindex="0" class="chroma"&gt;&lt;code&gt;&lt;span class="lnt"&gt;1
&lt;/span&gt;&lt;span class="lnt"&gt;2
&lt;/span&gt;&lt;span class="lnt"&gt;3
&lt;/span&gt;&lt;span class="lnt"&gt;4
&lt;/span&gt;&lt;span class="lnt"&gt;5
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;
&lt;td class="lntd"&gt;
&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-fallback" data-lang="fallback"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;Nginx http upstream check status
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;Check upstream server number: 2, generation: 1
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;Index Upstream Name Status Rise counts Fall counts Check type Check port
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;0 cluster {{HOST}}:{{PORT_HTTP_1}} up 2 0 tcp 0
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;1 cluster {{HOST}}:{{PORT_HTTP_2}} up 2 0 tcp 0
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;
&lt;/div&gt;
&lt;/div&gt;&lt;p&gt;&lt;strong&gt;停掉一个后端&lt;/strong&gt;（&lt;code&gt;docker stop nginx1&lt;/code&gt;），状态页会显示 &lt;code&gt;down&lt;/code&gt; + &lt;code&gt;Fall counts&lt;/code&gt; 递增；&lt;strong&gt;两个全挂后服务直接 502&lt;/strong&gt;——这就是 source 文档实测的&amp;quot;主动检查 + 服务降级&amp;quot;行为。&lt;/p&gt;
&lt;h2 id="五内网穿透双雄frp-与-cpolar-选型"&gt;五、内网穿透双雄：frp 与 cpolar 选型
&lt;/h2&gt;&lt;p&gt;内网穿透解决&amp;quot;&lt;strong&gt;没有公网 IP 时，怎么让外部访问内网服务&lt;/strong&gt;&amp;ldquo;的问题。市面上有两类典型玩家：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;frp（fast reverse proxy）&lt;/strong&gt;：开源、自建、需要一台公网 VPS 当中转&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;cpolar&lt;/strong&gt;：商业化、零配置、官方中转服务器（有公网域名）&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id="51-frp--frpc-速读"&gt;5.1 frp / frpc 速读
&lt;/h3&gt;&lt;table&gt;
	&lt;thead&gt;
			&lt;tr&gt;
					&lt;th&gt;维度&lt;/th&gt;
					&lt;th&gt;详情&lt;/th&gt;
			&lt;/tr&gt;
	&lt;/thead&gt;
	&lt;tbody&gt;
			&lt;tr&gt;
					&lt;td&gt;协议&lt;/td&gt;
					&lt;td&gt;TCP / UDP / HTTP / HTTPS / QUIC&lt;/td&gt;
			&lt;/tr&gt;
			&lt;tr&gt;
					&lt;td&gt;客户端&lt;/td&gt;
					&lt;td&gt;frpc（运行在内网机器）&lt;/td&gt;
			&lt;/tr&gt;
			&lt;tr&gt;
					&lt;td&gt;服务端&lt;/td&gt;
					&lt;td&gt;frps（运行在公网 VPS）&lt;/td&gt;
			&lt;/tr&gt;
			&lt;tr&gt;
					&lt;td&gt;配置格式&lt;/td&gt;
					&lt;td&gt;INI（v0.50 之前）/ TOML（v0.50+）&lt;/td&gt;
			&lt;/tr&gt;
			&lt;tr&gt;
					&lt;td&gt;鉴权&lt;/td&gt;
					&lt;td&gt;token + TLS 可选&lt;/td&gt;
			&lt;/tr&gt;
			&lt;tr&gt;
					&lt;td&gt;性能&lt;/td&gt;
					&lt;td&gt;公网 VPS 带宽上限&lt;/td&gt;
			&lt;/tr&gt;
			&lt;tr&gt;
					&lt;td&gt;部署成本&lt;/td&gt;
					&lt;td&gt;需要 1 台公网 VPS（最低配置 1C1G）&lt;/td&gt;
			&lt;/tr&gt;
	&lt;/tbody&gt;
&lt;/table&gt;
&lt;p&gt;典型 frpc 配置文件片段（公开文档参考）：&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;div class="chroma"&gt;
&lt;table class="lntable"&gt;&lt;tr&gt;&lt;td class="lntd"&gt;
&lt;pre tabindex="0" class="chroma"&gt;&lt;code&gt;&lt;span class="lnt"&gt;1
&lt;/span&gt;&lt;span class="lnt"&gt;2
&lt;/span&gt;&lt;span class="lnt"&gt;3
&lt;/span&gt;&lt;span class="lnt"&gt;4
&lt;/span&gt;&lt;span class="lnt"&gt;5
&lt;/span&gt;&lt;span class="lnt"&gt;6
&lt;/span&gt;&lt;span class="lnt"&gt;7
&lt;/span&gt;&lt;span class="lnt"&gt;8
&lt;/span&gt;&lt;span class="lnt"&gt;9
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;
&lt;td class="lntd"&gt;
&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-toml" data-lang="toml"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;serverAddr&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;&amp;#34;x.x.x.x&amp;#34;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;serverPort&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;7000&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="p"&gt;[[&lt;/span&gt;&lt;span class="nx"&gt;proxies&lt;/span&gt;&lt;span class="p"&gt;]]&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;name&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;&amp;#34;ssh&amp;#34;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;type&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;&amp;#34;tcp&amp;#34;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;localIP&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;&amp;#34;127.0.0.1&amp;#34;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;localPort&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;22&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;remotePort&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;6000&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;
&lt;/div&gt;
&lt;/div&gt;&lt;p&gt;启动后 &lt;code&gt;ssh -oPort=6000 user@x.x.x.x&lt;/code&gt; 就能连到内网机器的 22 端口。&lt;/p&gt;
&lt;h3 id="52-cpolar-速读"&gt;5.2 cpolar 速读
&lt;/h3&gt;&lt;table&gt;
	&lt;thead&gt;
			&lt;tr&gt;
					&lt;th&gt;维度&lt;/th&gt;
					&lt;th&gt;详情&lt;/th&gt;
			&lt;/tr&gt;
	&lt;/thead&gt;
	&lt;tbody&gt;
			&lt;tr&gt;
					&lt;td&gt;部署&lt;/td&gt;
					&lt;td&gt;零配置，下载即用&lt;/td&gt;
			&lt;/tr&gt;
			&lt;tr&gt;
					&lt;td&gt;中转&lt;/td&gt;
					&lt;td&gt;官方中转服务器（提供二级公网域名）&lt;/td&gt;
			&lt;/tr&gt;
			&lt;tr&gt;
					&lt;td&gt;限制&lt;/td&gt;
					&lt;td&gt;免费档限带宽、限连接数&lt;/td&gt;
			&lt;/tr&gt;
			&lt;tr&gt;
					&lt;td&gt;适合场景&lt;/td&gt;
					&lt;td&gt;临时演示 / 个人远程&lt;/td&gt;
			&lt;/tr&gt;
			&lt;tr&gt;
					&lt;td&gt;不适合场景&lt;/td&gt;
					&lt;td&gt;长期高带宽、对延迟敏感&lt;/td&gt;
			&lt;/tr&gt;
	&lt;/tbody&gt;
&lt;/table&gt;
&lt;h3 id="53-选型建议"&gt;5.3 选型建议
&lt;/h3&gt;&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;自建、自有 VPS、长期使用 → 选 frp&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;临时演示、个人远程、不想运维 → 选 cpolar&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;公司有安全合规要求、要求数据走自建 → frp&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;想用现成公网域名做微信小程序回调 → cpolar&lt;/strong&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id="六选型矩阵按业务场景一图看懂"&gt;六、选型矩阵：按业务场景一图看懂
&lt;/h2&gt;&lt;table&gt;
	&lt;thead&gt;
			&lt;tr&gt;
					&lt;th&gt;业务场景&lt;/th&gt;
					&lt;th&gt;推荐工具&lt;/th&gt;
					&lt;th&gt;理由&lt;/th&gt;
			&lt;/tr&gt;
	&lt;/thead&gt;
	&lt;tbody&gt;
			&lt;tr&gt;
					&lt;td&gt;经典 Web 反代 + 域名路由&lt;/td&gt;
					&lt;td&gt;&lt;strong&gt;Nginx&lt;/strong&gt;&lt;/td&gt;
					&lt;td&gt;文档最全、运维最熟&lt;/td&gt;
			&lt;/tr&gt;
			&lt;tr&gt;
					&lt;td&gt;Nginx 配置 + 动态生效 + 阿里生态&lt;/td&gt;
					&lt;td&gt;&lt;strong&gt;Tengine&lt;/strong&gt;&lt;/td&gt;
					&lt;td&gt;双 11 验证、Ingress 注解丰富&lt;/td&gt;
			&lt;/tr&gt;
			&lt;tr&gt;
					&lt;td&gt;个人博客 / 小团队 + 想省心&lt;/td&gt;
					&lt;td&gt;&lt;strong&gt;Caddy&lt;/strong&gt;&lt;/td&gt;
					&lt;td&gt;自动 HTTPS + 配置 5 行&lt;/td&gt;
			&lt;/tr&gt;
			&lt;tr&gt;
					&lt;td&gt;K8s/容器编排&lt;/td&gt;
					&lt;td&gt;&lt;strong&gt;Traefik&lt;/strong&gt;&lt;/td&gt;
					&lt;td&gt;动态发现 + Ingress 一等公民&lt;/td&gt;
			&lt;/tr&gt;
			&lt;tr&gt;
					&lt;td&gt;Service Mesh 数据面&lt;/td&gt;
					&lt;td&gt;&lt;strong&gt;Envoy&lt;/strong&gt;&lt;/td&gt;
					&lt;td&gt;Istio 默认 + xDS 协议&lt;/td&gt;
			&lt;/tr&gt;
			&lt;tr&gt;
					&lt;td&gt;超大流量七层网关（百度级别）&lt;/td&gt;
					&lt;td&gt;&lt;strong&gt;BFE&lt;/strong&gt;&lt;/td&gt;
					&lt;td&gt;国内大厂验证&lt;/td&gt;
			&lt;/tr&gt;
			&lt;tr&gt;
					&lt;td&gt;内网 SSH/MySQL 临时外访&lt;/td&gt;
					&lt;td&gt;&lt;strong&gt;frp&lt;/strong&gt;&lt;/td&gt;
					&lt;td&gt;自建、可控、性能强&lt;/td&gt;
			&lt;/tr&gt;
			&lt;tr&gt;
					&lt;td&gt;个人远程、临时演示&lt;/td&gt;
					&lt;td&gt;&lt;strong&gt;cpolar&lt;/strong&gt;&lt;/td&gt;
					&lt;td&gt;零配置、免运维&lt;/td&gt;
			&lt;/tr&gt;
	&lt;/tbody&gt;
&lt;/table&gt;
&lt;h2 id="七常见-8-个坑点速查"&gt;七、常见 8 个坑点速查
&lt;/h2&gt;&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;stream 块里用 &lt;code&gt;nginx_upstream_check_module&lt;/code&gt;&lt;/strong&gt; → &lt;strong&gt;不支持&lt;/strong&gt;，主动检查只对 HTTP 生效&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;主动检查 + 被动检查同时配置&lt;/strong&gt; → 行为未定义，&lt;strong&gt;只能二选一&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;&lt;code&gt;/status&lt;/code&gt; 状态页暴露在公网&lt;/strong&gt; → 加 &lt;code&gt;allow / deny&lt;/code&gt; 或只监听内网 IP&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Tengine 迁移后旧证书路径不一致&lt;/strong&gt; → 备份+还原时注意 &lt;code&gt;cert/&lt;/code&gt; 相对路径&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;HTTP/3（QUIC）开启后 443/udp 被防火墙拦&lt;/strong&gt; → 提前在 LB/防火墙开 UDP 443&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Traefik 监听 Docker 标签后服务起来没路由&lt;/strong&gt; → 检查 &lt;code&gt;traefik.enable=true&lt;/code&gt; 标签&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;frpc 配置改完忘 reload&lt;/strong&gt; → frpc 默认不会自动 reload，用 &lt;code&gt;systemctl restart frpc&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;cpolar 免费档被限速&lt;/strong&gt; → 长期高带宽业务直接换 frp&lt;/li&gt;
&lt;/ol&gt;
&lt;h2 id="前置知识--下一步"&gt;前置知识 / 下一步
&lt;/h2&gt;&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;前置&lt;/strong&gt;：Nginx 基础配置（upstream、location、proxy_pass）、systemd 服务管理&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;下一步&lt;/strong&gt;：K8s Ingress 选型（Traefik vs nginx-ingress）、Service Mesh 入门（Envoy + Istio）、CDN 与反代的协同&lt;/li&gt;
&lt;/ul&gt;</description></item></channel></rss>