隱私提示：本文檔中的所有 IP 地址、域名均為示例占位符。在實(shí)際部署時(shí)，請將其替換為您真實(shí)的配置信息，切勿直接將包含真實(shí)內(nèi)網(wǎng) IP 的配置文件截圖發(fā)布到公共網(wǎng)絡(luò)。

文檔概述

本文檔記錄了如何通過 Nginx 將公網(wǎng)域名請求代理到公司內(nèi)部網(wǎng)絡(luò)服務(wù)的完整過程。重點(diǎn)解決了 IPv6 解析導(dǎo)致的連接超時(shí) 問題，并詳細(xì)闡述了 端口映射 與 DNS 解析 的核心原理。適用于需要將內(nèi)網(wǎng)開發(fā)/測試環(huán)境暴露給公網(wǎng)訪問的場景。

核心目標(biāo)

1. 場景：用戶通過公網(wǎng)域名（如 app.example.com）訪問部署在公司內(nèi)網(wǎng)的 Web 服務(wù)（如 192.168.x.x:3000）。
2. 架構(gòu)：
   • 入口：云服務(wù)器（公網(wǎng) IP，運(yùn)行 Nginx）。
   • 出口：公司內(nèi)網(wǎng)服務(wù)器（內(nèi)網(wǎng) IP，運(yùn)行實(shí)際業(yè)務(wù)）。
   • 動作：Nginx 作為反向代理，轉(zhuǎn)發(fā)請求并返回結(jié)果。
3. 關(guān)鍵難點(diǎn)：
   • Nginx 默認(rèn)嘗試 IPv6 解析域名，若網(wǎng)絡(luò)環(huán)境不支持 IPv6 會導(dǎo)致 connect() failed (101: Network is unreachable)。
   • 用戶容易混淆“代理端口”與“源服務(wù)端口”，導(dǎo)致訪問失敗。

實(shí)施步驟詳解

第一步：修復(fù) IPv6 解析報(bào)錯

在 CentOS/RHEL 等現(xiàn)代 Linux 發(fā)行版中，Nginx 默認(rèn)可能優(yōu)先嘗試 IPv6 解析。如果服務(wù)器或上游網(wǎng)絡(luò)不支持 IPv6，代理請求會失敗。

解決方案：在 nginx.conf 的 http 塊中強(qiáng)制指定 DNS 解析器并關(guān)閉 IPv6。

配置文件路徑：/etc/nginx/nginx.conf

http {
    # ... 其他配置 ...
    # 【關(guān)鍵配置】指定 DNS 服務(wù)器并禁用 IPv6
    # 語法：resolver <dns_ip> [ipv6=off];
    # 建議替換為您所在區(qū)域穩(wěn)定的公共 DNS (如 114.114.114.114 或 8.8.8.8)
    resolver 114.114.114.114 8.8.8.8 ipv6=off;
    # ... 其他配置 ...
    include /etc/nginx/conf.d/*.conf;
}

操作命令：

# 1. 測試配置語法
sudo nginx -t
# 2. 重載配置生效
sudo systemctl reload nginx

知識點(diǎn)：ipv6=off 參數(shù)告訴 Nginx 在解析域名時(shí)只獲取 A 記錄（IPv4），忽略 AAAA 記錄（IPv6），從而避免不必要的網(wǎng)絡(luò)嘗試和超時(shí)。

第二步：配置反向代理 (Server Block)

創(chuàng)建獨(dú)立的配置文件，將特定域名流量轉(zhuǎn)發(fā)到內(nèi)網(wǎng) IP。

配置文件路徑：/etc/nginx/conf.d/<your-project>.conf

server {
    listen 80;
    # 替換為您的真實(shí)公網(wǎng)域名
    server_name app.example.com; 
    location / {
        # 替換為您的真實(shí)內(nèi)網(wǎng)服務(wù) IP 和端口
        # 注意：此處填寫的是 Nginx 能訪問到的內(nèi)網(wǎng)地址，不要寫公網(wǎng)地址
        proxy_pass http://<Inner_IP>:<Inner_Port>;
        # 傳遞真實(shí)用戶 IP 給后端（重要！否則后端日志全是 Nginx IP）
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        # 優(yōu)化長連接支持（可選，針對 WebSocket 或大文件）
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

操作命令：

sudo nginx -t && sudo systemctl reload nginx

第三步：驗(yàn)證與調(diào)試 (關(guān)鍵技巧)

在修改 DNS 之前，先在服務(wù)器本地驗(yàn)證 Nginx 配置是否正確，避免外部干擾。

測試命令：

# 模擬外部請求，強(qiáng)制指定 Host 頭，訪問本地 127.0.0.1 (即 Nginx 監(jiān)聽口)
# 請將 <your-domain.com> 替換為您的真實(shí)域名
curl -I -H "Host: app.example.com" http://127.0.0.1

結(jié)果分析：

• ? HTTP/1.1 200 OK：配置成功，Nginx 已成功從內(nèi)網(wǎng)拉取數(shù)據(jù)。
• ? 502 Bad Gateway：Nginx 無法連接內(nèi)網(wǎng) IP（檢查防火墻、路由、內(nèi)網(wǎng)服務(wù)狀態(tài)）。
• ? 404 Not Found：域名匹配錯誤，檢查 server_name。

第四步：DNS 解析與端口誤區(qū)排查

1. DNS 解析設(shè)置

確保域名服務(wù)商處，app.example.com 的 A 記錄 指向 云服務(wù)器的公網(wǎng) IP。

• 驗(yàn)證命令：ping app.example.com
• 預(yù)期結(jié)果：返回云服務(wù)器公網(wǎng) IP。

2. 常見誤區(qū)：端口號問題

• 錯誤做法：訪問 http://app.example.com:<Inner_Port>
  • 原因：:<Inner_Port> 是內(nèi)網(wǎng)服務(wù)的端口，云服務(wù)器通常未開放此端口，且 Nginx 也未監(jiān)聽此端口。
• 正確做法：訪問 http://app.example.com (默認(rèn) 80 端口)
  • 原理：用戶訪問 80 端口 -> Nginx 接收 -> Nginx 內(nèi)部 轉(zhuǎn)發(fā)請求到內(nèi)網(wǎng)的 <Inner_Port> 端口 -> 返回結(jié)果給用戶。用戶無需知道內(nèi)網(wǎng)端口。

故障排查清單 (Checklist)

核心知識總結(jié)

反向代理 (Reverse Proxy)：

• 充當(dāng)“中間人”，客戶端只與 Nginx 交互，不知道后端真實(shí)存在。
• 好處：隱藏內(nèi)網(wǎng)結(jié)構(gòu)、統(tǒng)一入口、負(fù)載均衡、SSL 終止。

Resolver 指令：

• 當(dāng) proxy_pass 使用域名而非 IP 時(shí)，Nginx 需要 DNS 解析。
• 在生產(chǎn)環(huán)境中，顯式配置 resolver 并關(guān)閉 IPv6 是最佳實(shí)踐，能避免大量隱蔽的網(wǎng)絡(luò)超時(shí)問題。

Host 頭傳遞：

• proxy_set_header Host $host; 至關(guān)重要。如果不加，后端服務(wù)收到的 Host 可能是內(nèi)網(wǎng) IP，導(dǎo)致某些框架（如 Django, SpringBoot, Vite）拒絕服務(wù)或重定向錯誤。

端口映射邏輯：

• 外部端口 (80/443)：面向公眾，由 Nginx 監(jiān)聽。
• 內(nèi)部端口 (3000/8080/5173)：面向內(nèi)網(wǎng)，由業(yè)務(wù)服務(wù)監(jiān)聽。
• 兩者不需要一致，Nginx 負(fù)責(zé)橋接。

進(jìn)階建議

• 啟用 HTTPS：使用 Let’s Encrypt (certbot) 免費(fèi)證書，將 HTTP 強(qiáng)制跳轉(zhuǎn)到 HTTPS，提升安全性。
• 日志監(jiān)控：定期檢查 /var/log/nginx/error.log，監(jiān)控 upstream 連接狀態(tài)。
• 高可用：如果內(nèi)網(wǎng)服務(wù)有多臺，可在 upstream 塊中配置多臺服務(wù)器實(shí)現(xiàn)負(fù)載均衡。

以上就是Nginx反向代理解決IPv6報(bào)錯與跨網(wǎng)段訪問的詳細(xì)步驟的詳細(xì)內(nèi)容，更多關(guān)于Nginx反向代理解決IPv6報(bào)錯與跨網(wǎng)段訪問的資料請關(guān)注腳本之家其它相關(guān)文章！

最新評論