Debian Apache如何支持Node.js

在 Debian 上让 Apache 支持 Node.js 的推荐做法

在 Debian 上，最佳实践是让 Apache 充当反向代理，将请求转发到运行在 localhost 的 Node.js 服务（如端口 3000）。这样既能利用 Apache 的成熟生态（虚拟主机、TLS、压缩、缓存等），又能让 Node.js 专注于业务逻辑与长连接场景（如 WebSocket）。核心思路是启用 Apache 的 mod_proxy、mod_proxy_http，必要时配合 mod_proxy_wstunnel、mod_headers、mod_rewrite 等模块完成转发与协议升级。

安装与准备

• 安装 Apache 与常用模块

  • 执行：sudo apt update && sudo apt install apache2
  • 启用模块：sudo a2enmod proxy proxy_http proxy_wstunnel headers rewrite
  • 说明：上述模块分别用于反向代理、HTTP 转发、WebSocket 隧道、请求头处理与 URL 重写，是承载 Node.js 应用与 WebSocket 的常见组合。

• 安装并启动 Node.js 应用

  • 安装 Node.js（示例为 NodeSource 14.x，可按需选择版本）：
    • curl -sL https://deb.nodesource.com/setup_14.x | sudo -E bash -
    • sudo apt-get install -y nodejs
  • 验证：node -v、npm -v
  • 启动应用（生产环境建议用进程管理工具如 PM2）：
    • 全局安装 PM2：sudo npm install -g pm2
    • 启动示例：pm2 start npm --name "myapp" -- run start
    • 常用：pm2 list、pm2 restart myapp、pm2 save && sudo pm2 startup（设置开机自启）

配置 Apache 反向代理

• 创建站点配置

  • 新建：sudo nano /etc/apache2/sites-available/nodeapp.conf
  • 示例（HTTP，端口 3000）：

    <VirtualHost *:80>
        ServerName yourdomain.com
        ProxyPreserveHost On
        ProxyRequests Off
    
        ProxyPass        / http://127.0.0.1:3000/
        ProxyPassReverse / http://127.0.0.1:3000/
    
        ErrorLog  ${APACHE_LOG_DIR}/nodeapp_error.log
        CustomLog ${APACHE_LOG_DIR}/nodeapp_access.log combined
    </VirtualHost>
    

  • 启用站点：sudo a2ensite nodeapp.conf
  • 可选：禁用默认站点 sudo a2dissite 000-default.conf
  • 检查并生效：sudo apache2ctl configtest && sudo systemctl reload apache2
  • 说明：将 yourdomain.com 替换为你的域名，Node.js 服务需监听 127.0.0.1:3000 或相应端口。

• 启用 HTTPS（推荐）

  • 安装证书工具：sudo apt install certbot python3-certbot-apache
  • 申请并自动配置证书：sudo certbot --apache -d yourdomain.com
  • 说明：Certbot 会自动创建或调整虚拟主机以启用 TLS，并配置自动续期。

WebSocket 与常见场景

• WebSocket 代理示例

  • 在虚拟主机中添加（与 HTTP 代理并存）：

    # WebSocket
    ProxyPass        /ws/  ws://127.0.0.1:3000/
    ProxyPassReverse /ws/  ws://127.0.0.1:3000/
    

  • 说明：WebSocket 需要 mod_proxy_wstunnel；路径如 /ws/ 可按项目实际调整。

• 静态资源与路径前缀

  • 将静态资源由 Apache 直接服务，Node.js 仅处理 API：

    Alias /static /var/www/myapp/static
    <Directory /var/www/myapp/static>
        Require all granted
    </Directory>
    
    ProxyPass        /api/  http://127.0.0.1:3000/api/
    ProxyPassReverse /api/  http://127.0.0.1:3000/api/
    

  • 说明：通过 Alias 与 ProxyPass 分流，减少 Node.js 负载并提升静态资源性能。

排错与优化

• 基础检查
  • 端口连通：curl -I http://127.0.0.1:3000
  • Apache 配置：sudo apache2ctl configtest
  • 日志定位：tail -f ${APACHE_LOG_DIR}/nodeapp_error.log
  • 防火墙/云安全组：放行 80/443 端口
• 运行保障
  • 使用 PM2 守护进程并设置开机自启，确保 Node.js 崩溃后自动重启
  • 按需开启压缩、缓存、HTTP/2 等 Apache 特性，提升整体吞吐与体验