Nginx常用命令，及常见错误

Nginx 常用命令

Nginx 提供了一系列命令来管理其服务，包括启动、停止、重启、重新加载配置等。以下是常用的 Nginx 命令：

1. 启动 Nginx

sudo systemctl start nginx

2. 停止 Nginx

sudo systemctl stop nginx

3. 重启 Nginx

sudo systemctl restart nginx

4. 重新加载配置

在修改 Nginx 配置文件后，使用重新加载命令以应用更改，而无需停止服务。

sudo systemctl reload nginx

5. 检查 Nginx 状态

sudo systemctl status nginx

6. 测试配置文件语法

在重新加载配置之前，建议先测试配置文件是否有语法错误。

sudo nginx -t

7. 查看 Nginx 版本

nginx -v

或查看更详细的版本信息：

nginx -V

Nginx 常见错误及解决方法

在使用 Nginx 时，可能会遇到各种错误。以下是一些常见的错误及其解决方法：

1. 配置文件语法错误

错误信息示例：

nginx: [emerg] unknown directive "unknowndirective" in /etc/nginx/nginx.conf:12
nginx: configuration file /etc/nginx/nginx.conf test failed

解决方法：

• 检查配置文件中的拼写错误或未知指令。
• 使用 sudo nginx -t 测试配置文件。

sudo nginx -t

2. 端口被占用

错误信息示例：

nginx: [emerg] bind() to 0.0.0.0:80 failed (98: Address already in use)
nginx: configuration file /etc/nginx/nginx.conf test failed

解决方法：

• 查找占用端口的进程。

sudo netstat -tuln | grep 80

• 杀死占用端口的进程。

sudo kill -9 <PID>

3. 权限问题

错误信息示例：

nginx: [alert] could not open error log file: /var/log/nginx/error.log (13: Permission denied)
: the "user" directive makes sense only if the master process runs with super-user privileges, ignored in /etc/nginx/nginx.conf:1
nginx: [emerg] open() "/var/www/html/index.html" failed (13: Permission denied)
nginx: configuration file /etc/nginx/nginx.conf test failed

解决方法：

• 确保 Nginx 用户有权限访问相关文件和目录。

sudo chown -R www-data:www-data /var/www/html
sudo chmod -R 755 /var/www/html

4. SSL 证书问题

错误信息示例：

nginx: [emerg] SSL_CTX_use_PrivateKey_file("/etc/letsencrypt/live/yourdomain.com/privkey.pem") failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)
nginx: configuration file /etc/nginx/nginx.conf test failed

解决方法：

• 确保私钥和证书文件匹配。
• 重新生成或检查证书文件。

sudo certbot --nginx -d yourdomain.com -d www.yourdomain.com

5. 配置文件路径错误

错误信息示例：

nginx: [emerg] open() "/etc/nginx/sites-enabled/your-vue-app" failed (2: No such file or directory) in /etc/nginx/nginx.conf:62
nginx: configuration file /etc/nginx/nginx.conf test failed

解决方法：

• 确保配置文件路径正确，并且文件存在。

ls /etc/nginx/sites-available/your-vue-app
sudo ln -s /etc/nginx/sites-available/your-vue-app /etc/nginx/sites-enabled/

6. 模块未加载

错误信息示例：

nginx: [emerg] unknown directive "http2" in /etc/nginx/nginx.conf:12
nginx: configuration file /etc/nginx/nginx.conf test failed

解决方法：

• 确保 Nginx 编译时启用了所需的模块。

./configure --with-http_ssl_module --with-http_v2_module
make
sudo make install

7. 日志文件权限问题

错误信息示例：

nginx: [alert] could not open error log file: /var/log/nginx/error.log (13: Permission denied)
nginx: configuration file /etc/nginx/nginx.conf test failed

解决方法：

• 确保 Nginx 用户有权限写入日志文件。

sudo chown -R www-data:www-data /var/log/nginx
sudo chmod -R 755 /var/log/nginx