当前位置：首页 > news >正文

Mac环境安装Nginx指南实录

news 2025/9/21 6:05:29

在Mac电脑上运行Nginx，最简便且推荐的方法是使用 Homebrew 安装和管理。以下是详细步骤指南：

✅ 一、安装 Homebrew（如已安装可跳过）

打开终端（Terminal），执行以下命令安装 Homebrew（Mac 上最常用的包管理工具）：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装完成后，执行：

brew --version

安装成功效果图

✅ 二、使用 Homebrew 安装 Nginx

brew install nginx

安装完成后，可查看版本确认：

nginx -v

nginx版本查询

默认安装路径为：

配置文件：/usr/local/etc/nginx/nginx.conf（Apple Silicon 为 /opt/homebrew/etc/nginx/nginx.conf）
网页根目录：/usr/local/var/www（或 /opt/homebrew/var/www）

✅ 三、启动 Nginx

brew services start nginx

或手动启动：

nginx

打开浏览器访问：

http://localhost:8080

如果看到 “Welcome to nginx!” 页面，说明运行成功。

✅ 四、常用命令

操作	命令
启动	`nginx` 或 `brew services start nginx`
重启	`brew services restart nginx`
停止	`brew services stop nginx`
重新加载配置	`nginx -s reload`
测试配置	`nginx -t`

✅ 五、修改配置示例

编辑配置文件：

nano /usr/local/etc/nginx/nginx.conf

添加一个简单的虚拟主机：

server {listen 8080;server_name localhost;location / {root /usr/local/var/www;index index.html;}
}

保存后执行：

nginx -s reload

✅ 六、设置开机自启（可选）

brew services start nginx

Homebrew 会自动将其注册为 launchd 服务，实现开机自启。

✅ 七、卸载（如需要）

brew uninstall nginx

本次项目需要做的实操事情

如何把安装好的Nginx静态资源替换成宿主机本地绝对路径，省得记相对规则：

location / {root   /opt/homebrew/var/www;index  index.html index.htm;
}

配置完成效果

使用nginx命令启动之后

nginx -t      # 语法检查
nginx -s reload

静态资源如何存放

将前端静态资源直接打包成dist文件夹，然后使用下述命令，复制的是“dist 里面的文件”，而不是 dist 文件夹本身

# 进入 dist
cd dist
# 把内部所有文件复制到 nginx 根目录
cp -r * /opt/homebrew/var/www/

展示图

Nginx如何添加自定义请求头

server {listen       8080;server_name  localhost;location / {root   /opt/homebrew/var/www;index  index.html index.htm;}location /kb/ {proxy_pass http://localhost:10003;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;proxy_set_header X-Custom-Header custom-value;  # 添加自定义头}location /user/ {proxy_pass http://localhost:10003;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;proxy_set_header X-Custom-Header custom-value;  # 添加自定义头}location /assistant/ {proxy_pass http://localhost:10003;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;proxy_set_header X-Custom-Header custom-value;  # 添加自定义头}location /kl/ {proxy_pass http://localhost:10003;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;proxy_set_header X-Custom-Header custom-value;  # 添加自定义头}location /platform/ {proxy_pass http://localhost:10003;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;proxy_set_header X-Custom-Header custom-value;  # 添加自定义头}
}