---
title: "宝塔面板反向代理配置指南"
description: "详细介绍如何在宝塔面板（BT Panel）中为网站配置反向代理（Nginx Reverse Proxy），包含代理 URL、添加请求头、发送域名、WebSocket 与缓存设置，适用于后端服务、API 网关与 Node.js 项目。"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.bt.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 宝塔面板反向代理配置指南

## 反向代理

本文将介绍如何设置反向代理。

反向代理是一种服务器技术，它位于用户与原始服务器之间，扮演着中间人的角色。

当用户向服务器发送请求时，请求首先到达反向代理服务器。反向代理服务器会根据请求的内容，如 URL 等信息，将请求转发到后端实际处理请求的服务器上。

后端服务器处理完请求后，将响应发送给反向代理服务器，然后反向代理服务器再将响应转发给用户。对于用户来说，他感觉自己直接与原始服务器进行了交互，但实际上所有的请求和响应都经过了反向代理服务器。

:::warning[注意]
  - 设置了反向代理后，【访问限制】中的相应路径的规则将会失效
:::

## 操作步骤

1. 登录宝塔面板。点击左侧导航栏的`网站`，进入网站列表页面。

2. 选择需要管理域名的站点，点击对应站点的域名
   
   ![选择站点](/img/user-guide/site/select-site.png)

3. 在弹出的窗口中，点击左侧导航栏的`反向代理`，进入反向代理配置页面。

   ![反向代理](/img/user-guide/site/reverse-proxy.png)
   
4. 点击`添加反向代理`，添加反向代理规则。

   例如，后端服务地址为 `http://127.0.0.1:3000/`，希望通过网站地址 `https://www.bt.cn/` 访问该服务。

   配置反向代理后，访问 `https://www.bt.cn/` 就会显示 `http://127.0.0.1:3000/` 的内容。

   ![添加反向代理](/img/user-guide/site/add-reverse-proxy.png)

:::info[说明]
  - 代理目录：访问这个目录时将会把目标URL的内容返回并显示(需要开启高级功能)
  - 目标URL：可以填写你需要代理的站点，目标URL必须为可正常访问的URL，否则将返回错误
  - 发送域名：将域名添加到请求头传递到代理服务器，默认为目标URL域名，若设置不当可能导致代理无法正常运行
  - 内容替换：只能在使用nginx时提供，最多可以添加3条替换内容,如果不需要替换请留空
:::

Source: https://docs.bt.cn/user-guide/site/php/site-config/reverse-proxy/index.mdx