如何将Cpanel中的LiteSpeed配置为Chatwoot的前端代理？

前提说明 #

你的Docker版Chatwoot已正常运行在127.0.0.1:3000，以下配置对应你提供的Nginx规则，适配Cpanel环境下的LiteSpeed。

1. 开启下划线请求头支持 #

Chatwoot API依赖带下划线的请求头，LiteSpeed默认禁用该特性，需开启：

• 登录Cpanel，找到「LiteSpeed Web Server」管理入口
• 进入「Server Configuration」→「Tuning」，将Allow Underscores in Headers设为Yes
• 保存设置后重启LiteSpeed

2. 配置虚拟主机代理规则 #

在Cpanel中找到目标域名的虚拟主机配置入口（通常在「Advanced」→「Edit Virtual Host Configuration」，不同主题位置可能略有差异），添加以下配置片段：

2.1 处理.well-known路径（用于SSL验证） #

location /.well-known {
  alias /var/www/ssl-proof/chatwoot/.well-known;
}

2.2 主代理规则（转发所有请求到Chatwoot） #

location / {
  proxy_pass http://127.0.0.1:3000;
  proxy_pass_header Authorization;
  proxy_set_header Upgrade $http_upgrade;
  proxy_set_header Connection "upgrade";
  proxy_set_header Host $host;
  proxy_set_header X-Forwarded-Proto $scheme;
  proxy_set_header X-Forwarded-Ssl on;
  proxy_set_header X-Real-IP $remote_addr;
  proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  proxy_http_version 1.1;
  proxy_set_header Connection "";
  proxy_buffering off;
  client_max_body_size 0;
  proxy_read_timeout 36000s;
  proxy_redirect off;
}

保存配置后重启LiteSpeed生效。

备选：使用.htaccess配置（共享主机场景） #

若无法编辑虚拟主机配置，可在域名根目录创建/编辑.htaccess文件，添加以下内容：

RewriteEngine On

# 转发.well-known路径到指定目录
RewriteRule ^\.well-known/(.*)$ /var/www/ssl-proof/chatwoot/.well-known/$1 [L]

# 代理所有请求到Chatwoot
RewriteRule ^(.*)$ http://127.0.0.1:3000/$1 [P,L]
ProxyPassReverse / http://127.0.0.1:3000/

# 设置代理请求头
RequestHeader set Upgrade %{HTTP:Upgrade}e
RequestHeader set Connection "upgrade"
RequestHeader set Host %{HTTP:Host}e
RequestHeader set X-Forwarded-Proto %{REQUEST_SCHEME}e
RequestHeader set X-Forwarded-Ssl on
RequestHeader set X-Real-IP %{REMOTE_ADDR}e
RequestHeader set X-Forwarded-For %{REMOTE_ADDR}e

# 调整超时与缓存设置
ProxyTimeout 36000
SetEnv proxy-nokeepalive 1
SetEnv proxy-sendchunked 1

验证配置 #

重启LiteSpeed后，访问你的域名，确认Chatwoot界面正常加载；可查看Chatwoot容器日志，验证请求头是否正确传递。

内容的提问来源于stack exchange，提问作者Wilbernight