NetAlertX项目反向代理配置全指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00281/article/details/148549221

NetAlertX项目反向代理配置全指南

NetAlertX 💻🔍 WIFI / LAN intruder detector. Scans for devices connected to your network and alerts you if new and unknown devices are found. 项目地址: https://gitcode.com/gh_mirrors/ne/NetAlertX

前言

NetAlertX是一款优秀的网络设备监控工具，在实际部署中经常需要通过反向代理来提供更灵活的访问方式。本文将全面介绍如何为NetAlertX配置反向代理，涵盖NGINX、Apache以及容器化环境下的配置方案。

基础概念

在开始配置前，我们需要了解几个关键概念：

反向代理：作为客户端和服务器之间的中介，接收客户端请求并转发给后端服务器
直接路径访问：通过根路径(如http://example.com/)直接访问应用
子路径访问：通过特定路径(如http://example.com/netalertx/)访问应用

NGINX配置方案

HTTP直接路径配置

创建配置文件/etc/nginx/sites-available/netalertx
添加以下内容：

server {
  listen 80;
  server_name netalertx;
  proxy_preserve_host on;
  proxy_pass http://localhost:20211/;
  proxy_pass_reverse http://localhost:20211/;
}

重新加载NGINX配置：

nginx -s reload

或

systemctl restart nginx

HTTP子路径配置

对于需要通过子路径访问的场景：

server {
  listen 80;
  server_name netalertx;
  proxy_preserve_host on;
  location ^~ /netalertx/ {
    proxy_pass http://localhost:20211/;
    proxy_pass_reverse http://localhost:20211/;
    proxy_redirect ~^/(.*)$ /netalertx/$1;
    rewrite ^/netalertx/?(.*)$ /$1 break;
  }
}

使用ngx_http_sub_module模块

当应用中有硬编码路径时，需要使用内容替换：

location ^~ /netalertx/ {
  # 基础代理配置
  proxy_pass http://localhost:20211/;
  proxy_pass_reverse http://localhost:20211/;
  proxy_redirect ~^/(.*)$ /netalertx/$1;
  rewrite ^/netalertx/?(.*)$ /$1 break;
  
  # 内容替换配置
  sub_filter_once off;
  sub_filter_types *;
  sub_filter 'href="/' 'href="/netalertx/';
  sub_filter '(?>$host)/css' '/netalertx/css';
  sub_filter '(?>$host)/js' '/netalertx/js';
  sub_filter '/img' '/netalertx/img';
  sub_filter '/lib' '/netalertx/lib';
  sub_filter '/php' '/netalertx/php';
}

HTTPS配置

HTTPS配置与HTTP类似，只需添加SSL相关参数：

server {
  listen 443;
  server_name netalertx;
  ssl on;
  ssl_certificate /etc/ssl/certs/netalertx.pem;
  ssl_certificate_key /etc/ssl/private/netalertx.key;
  
  # 其余配置与HTTP版本相同
  proxy_preserve_host on;
  proxy_pass http://localhost:20211/;
  proxy_pass_reverse http://localhost:20211/;
}

Apache配置方案

HTTP直接路径配置

创建文件/etc/apache2/sites-available/netalertx.conf
添加以下内容：

<VirtualHost *:80>
  ServerName netalertx
  ProxyPreserveHost On
  ProxyPass / http://localhost:20211/
  ProxyPassReverse / http://localhost:20211/
</VirtualHost>

启用配置并重启Apache：

a2ensite netalertx
service apache2 reload

HTTPS配置

HTTPS配置需要添加SSL相关指令：

<VirtualHost *:443>
  ServerName netalertx
  SSLEngine On
  SSLCertificateFile /etc/ssl/certs/netalertx.pem
  SSLCertificateKeyFile /etc/ssl/private/netalertx.key
  
  ProxyPreserveHost On
  ProxyPass / http://localhost:20211/
  ProxyPassReverse / http://localhost:20211/
</VirtualHost>

容器化环境配置

使用SWAG容器

SWAG(LinuxServer的Web应用网关)是流行的反向代理解决方案：

创建文件/config/nginx/proxy-confs/netalertx.subfolder.conf
添加以下内容：

location /netalertx {
  return 301 $scheme://$host/netalertx/;
}

location ^~ /netalertx/ {
  include /config/nginx/proxy.conf;
  include /config/nginx/resolver.conf;
  
  set $upstream_app netalertx;
  set $upstream_port 20211;
  set $upstream_proto http;
  
  proxy_pass $upstream_proto://$upstream_app:$upstream_port;
  proxy_set_header Accept-Encoding "";
  
  proxy_redirect ~^/(.*)$ /netalertx/$1;
  rewrite ^/netalertx/?(.*)$ /$1 break;
  
  # 内容替换配置
  sub_filter_once off;
  sub_filter_types *;
  sub_filter 'href="/' 'href="/netalertx/';
  sub_filter '(?>$host)/css' '/netalertx/css';
  sub_filter '(?>$host)/js' '/netalertx/js';
  sub_filter '/img' '/netalertx/img';
  sub_filter '/lib' '/netalertx/lib';
  sub_filter '/php' '/netalertx/php';
}

使用Traefik配置

对于使用Traefik作为反向代理的用户：

在dynamic.toml中添加路由配置：

[http.routers]
  [http.routers.netalertx-router]
    entryPoints = ["websecure"]
    rule = "Host(`www.domain.com`) && PathPrefix(`/netalertx`)"
    service = "netalertx-service"
    middlewares = "auth,netalertx-stripprefix"
    [http.routers.netalertx-router.tls]
       certResolver = "section31"
       [[http.routers.netalertx-router.tls.domains]]
         main = "www.domain.com"

[http.services]
  [http.services.netalertx-service]
    [[http.services.netalertx-service.loadBalancer.servers]]
      url = "http://internal-ip-address:20211/"

[http.middlewares]
  [http.middlewares.netalertx-stripprefix.stripprefix]
    prefixes = "/netalertx"
    forceSlash = false

修改NetAlertX容器中的默认Nginx配置：

server {
    listen 80 default_server;
    root /var/www/html;
    index index.php;
    add_header X-Forwarded-Prefix "/netalertx" always;
    proxy_set_header X-Forwarded-Prefix "/netalertx";

    location ~* \.php$ {
      fastcgi_pass unix:/run/php/php8.2-fpm.sock;
      include fastcgi_params;
      fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
      fastcgi_param SCRIPT_NAME $fastcgi_script_name;
      fastcgi_connect_timeout 75;
      fastcgi_send_timeout 600;
      fastcgi_read_timeout 600;
    }
}