Node.js动态网站迁移至443端口遇Cyberpanel占用问题求助

核心问题分析 #

443是HTTPS默认端口，你的Cyberpanel自带的LiteSpeed/OpenLiteSpeed服务已经在占用这个端口，直接让Node.js绑定443必然冲突。另外Cyberpanel的站点检查要求必须存在index.html/index.php文件，不能直接删除，得配合反向代理方案解决。

分步解决 #

1. 确认443端口占用情况
   先执行命令查看哪个进程占用了443：

   sudo netstat -tulpn | grep :443
   

   输出里的进程名大概率是litespeed或者openlitespeed，这是Cyberpanel的核心web服务，不能停止，别想着杀掉它来让Node.js使用443端口。

2. 配置Cyberpanel反向代理
   通过反向代理让Cyberpanel的web服务把443端口的请求转发到Node.js的3000端口，操作步骤：

   • 登录Cyberpanel后台，进入网站 -> 列出网站，找到你的站点点击管理
   • 找到反向代理（或Proxy Settings）选项，添加规则：
     • 代理路径填/（表示所有请求都转发）
     • 目标URL填http://127.0.0.1:3000
     • 保存设置，Cyberpanel会自动生效配置

3. 满足index文件要求
   在你的网站根目录创建一个空的index.html文件（不能删除，否则Cyberpanel会报错），可以用命令快速创建：

   touch /path/to/your/website/root/index.html
   

   也可以写个简单的加载提示：

   <!DOCTYPE html>
   <html>
   <body>
     <h1>服务加载中...</h1>
   </body>
   </html>
   

   配置好反向代理后，访问网站时这个文件不会被实际展示，请求会直接转发到Node.js服务。

4. 确保Node.js服务稳定运行
   新手常遇到终端关闭后Node.js服务停止的问题，推荐用pm2管理：

   • 安装pm2：

     npm install -g pm2
     

   • 启动你的Node.js应用：

     pm2 start your-app.js
     

   • 设置开机自启（重启服务器后自动启动服务）：

     pm2 startup
     pm2 save
     

5. 验证HTTPS访问
   确保你的站点在Cyberpanel里已经配置了SSL证书（可在站点管理的SSL选项里申请免费的Let's Encrypt证书），之后访问https://你的域名就能直接访问到Node.js服务，无需修改Node.js脚本的端口。

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