本文将指导您如何配置Nginx以代理前后端分离的项目,并特别说明了对WebSocket的代理设置。通过本教程,您将能够实现一次性配置,进而使项目能够在任意局域网服务器上部署,并可通过IP地址或域名访问服务。
笔者建议 先速览本文了解大致内容后再复制对应的代码。本文环境基于Windows VUE3 typescript 理论通用于linux
前提条件
-
已安装Nginx
-
前后端项目代码部署在服务器上
Nginx配置步骤
基础代理配置
编辑Nginx配置文件,通常位于/etc/nginx/nginx.conf
或/etc/nginx/conf.d/
目录下的某个.conf
文件。例如:
server {
listen 80; # 监听端口
server_name localhost; # 服务器名称 局域网内一般就是localhost
location / {
proxy_pass http://前端项目地址; # 前端项目代理
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
location /api/ {
proxy_pass http://后端项目地址; # 后端接口代理
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
}
为了自动化区分生产环境和开发环境,我们需要使用到“.env”
如图通过.env.development .env.production 然后修改 package.json即可自动区分环境。然后再请求代码中这样写
export const BASE_URL = import.meta.env.VITE_APP_BASE_API
以下为笔者实例配置
#user nobody;
worker_processes 2;
#error_log logs/error.log;
#error_log logs/error.log notice;
#error_log logs/error.log info;
pid logs/nginx.pid;
events {
worker_connections 2048;
}
http {
include mime.types;
default_type application/octet-stream;
#log_format main '$remote_addr - $remote_user [$time_local] "$request" '
# '$status $body_bytes_sent "$http_referer" '
# '"$http_user_agent" "$http_x_forwarded_for"';
#access_log logs/access.log main;
sendfile on;
#tcp_nopush on;
#keepalive_timeout 0;
keepalive_timeout 65;
#gzip on;
server {
listen 8119;
server_name localhost;
# 指定根目录为 dist 文件夹
root ./dist;
index index.html;
location / {
try_files $uri $uri/ /index.html;
}
# 将以/api开始的请求代理到本机的8112端口的后端服务,并且去掉URL中的/api
location /api/ {
proxy_pass http://localhost:8112/; # 注意这里的尾部斜线
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
# 其他可能需要的代理设置...
}
# 添加通用 WebSocket 代理
location /ws/ {
proxy_pass http://localhost:8112;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "Upgrade";
proxy_set_header Host $host;
proxy_read_timeout 60s;
proxy_send_timeout 60s;
}
}
server {
listen 80;
server_name localhost;
#charset koi8-r;
#access_log logs/host.access.log main;
location / {
root html;
index index.html index.htm;
}
#error_page 404 /404.html;
# redirect server error pages to the static page /50x.html
#
error_page 500 502 503 504 /50x.html;
location = /50x.html {
root html;
}
# proxy the PHP scripts to Apache listening on 127.0.0.1:80
#
#location ~ \.php$ {
# proxy_pass http://127.0.0.1;
#}
# pass the PHP scripts to FastCGI server listening on 127.0.0.1:9000
#
#location ~ \.php$ {
# root html;
# fastcgi_pass 127.0.0.1:9000;
# fastcgi_index index.php;
# fastcgi_param SCRIPT_FILENAME /scripts$fastcgi_script_name;
# include fastcgi_params;
#}
# deny access to .htaccess files, if Apache's document root
# concurs with nginx's one
#
#location ~ /\.ht {
# deny all;
#}
}
# another virtual host using mix of IP-, name-, and port-based configuration
#
#server {
# listen 8000;
# listen somename:8080;
# server_name somename alias another.alias;
# location / {
# root html;
# index index.html index.htm;
# }
#}
# HTTPS server
#
#server {
# listen 443 ssl;
# server_name localhost;
# ssl_certificate cert.pem;
# ssl_certificate_key cert.key;
# ssl_session_cache shared:SSL:1m;
# ssl_session_timeout 5m;
# ssl_ciphers HIGH:!aNULL:!MD5;
# ssl_prefer_server_ciphers on;
# location / {
# root html;
# index index.html index.htm;
# }
#}
}
其中前端的dist目录笔者使用的是相对路径,也就意味着/conf/nginx.conf中./ 相对的根目录是conf的同级目录。这也是实现通用化部署的关键。这样配置在其他地方解压后仍然可以生效。
而后端则是全部以 /api 作为默认的请求的url,然后通过nginx反向代理到真实的后端。
例如请求的是 /api/login 到服务器 则被代理后为 http://localhost:8112/login 即指向了服务器自身。
WebSocket代理配置
在配置文件中增加针对WebSocket的代理设定。这段代码除了服务地址和指定的代理的路径“/ws/”其余部分是固定配置。
# 添加通用 WebSocket 代理
location /ws/ {
proxy_pass http://localhost:8112;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "Upgrade";
proxy_set_header Host $host;
proxy_read_timeout 60s;
proxy_send_timeout 60s;
}
而websocket则需要再代码中这样写
socket = new WebSocket(`ws://${window.location.host}/ws/upgrade_log`);
此行代码用于创建一个新的WebSocket连接。具体解释如下:
-
ws://${window.location.host}/ws/upgrade_log
:这是一个模板字符串,用来定义WebSocket服务器的URL。-
ws://
:是WebSocket协议的前缀,表示这是一个WebSocket连接。在安全环境中(例如使用HTTPS时),会使用wss://
作为前缀。 -
${window.location.host}
:这部分代码使用了JavaScript的模板字符串语法来嵌入一个表达式。window.location.host
获取当前浏览器窗口中显示的文档的主机名(即域名或IP地址加端口号)。这意味着WebSocket连接到当前页面所在的域名或IP地址上。 -
/ws/upgrade_log
:这是WebSocket服务在服务器上的具体路径。在Nginx配置中,我们可能设置了一个location块来监听/ws/路径,并将其代理到实际运行WebSocket服务的后端服务器。
-
所以,整行代码的作用是,在客户端创建一个WebSocket连接,连接到与当前网页相同host的服务器上,特定的/ws/upgrade_log
路径。当这个WebSocket连接建立后,就可以用于双向通信,客户端和服务器可以互相发送消息。
然后通过Nginx的代理实现任何通过ip访问前端网页时都能连接到服务器的websocket服务。