vlambda博客
学习文章列表

一、证书申请

申请SSL证书，申请之后会有两个文件提供下载(注意下载nginx版本)

• xxx.key

• xxx.pem

nginx安装版本使用的是1.16.1

二、配置SSL

2.1 证书上传

在nginx的安装目录下创建cert(别的名字也可以)

将下载的SSL证书文件上传到cert下

2.2 Server配置

1. 进入到nginx下的conf文件夹下打开nginx.conf文件

2. 取消https server的注释

# 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;
    }
}

3. 需要配置一下说明的内容

# HTTPS server
server {
    # 注意这里就是443 ssl, 不要把ssl删除了
    listen       443 ssl;
    # 把localhost替换为SSL绑定的域名, 如www.codecoord.com
    # server_name  localhost;
    server_name  www.codecoord.com;
    
    # 添加默认主目录和首页, 根据自己的路径修改
    root /opt/nginx/html;
    index index.html;

    # cert.pem和cert.key替换为上传文件的路径(最好使用完整路径)
    # ssl_certificate      cert.pem;
    # ssl_certificate_key  cert.key;
    ssl_certificate      /opt/nginx/cert/cert.pem;
    ssl_certificate_key  /opt/nginx/cert/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;
    }
}

注意443端口需要在开启外网访问(比如阿里云服务器需要在控制台配置安全组, 不过默认是打开的)

2.2.3 配置转发

1. 这一步是配置对外访问端口和将http请求强制转为https

2. 删除多余配置，只需要留下以下配置

server {
    # 监听端口
    listen       80;
    # 改为自己的域名
    server_name  www.codecoord.com;
    # 将http请求强制转为https
    # rewrite：重写指令，$host$：请求地址，$1：请求参数，permanent：永久访问
    rewrite ^(.*)$ https://$host$1 permanent;
}

3. 上述两步配置完成后测试一下是否配置正确，在sbin目录下运行测试命令

./nginx -t

# 配置成功信息
[root@TianXin sbin]# ./nginx -t
nginx: the configuration file /opt/Nginx/conf/nginx.conf syntax is ok
nginx: configuration file /opt/Nginx/conf/nginx.conf test is successful

4. 如果测试成功则重启nginx，使配置生效

[root@TianXin sbin]# ./nginx -s reload

5. 完整配置参考第四点配置示例

6. 配置完成后访问域名，即可显示https信息

三、配置问题

3.1 ngx_http_ssl_module

1. 注意如果是nginx 1.16.1之前版本, 配置内容会有有所变化，请参考别的版本配置

2. 如果运行./nginx -t时出现以下错误，标识nginx没有安装SSL模块

[root@tianxin conf]# nginx -t
nginx: [emerg] the "ssl" parameter requires ngx_http_ssl_module in /opt/nginx/conf/nginx.conf:112
nginx: configuration file /opt/nginx/conf/nginx.conf test failed

3. 解决方法是重新配置nginx，重新编译带上--with-http_stub_status_module --with-http_ssl_module

4. 可以重新安装nginx(建议, 可以避免很多问题)也可以不用重新安装, 不用重新安装只需要执行下面的两个命令即可

# 清除编译文件
make clean
# 配置
./configure --prefix=/opt/nginx --with-http_stub_status_module --with-http_ssl_module
# 编译
make

5. 不要执行make install 否则会覆盖原来的文件

6. 关闭nginx

nginx -s stop

7. 拷贝目录下的objs/nginx替换之前的nginx启动文件

cp objs/nginx /opt/nginx/sbin/

8. 最后启动nginx即可

3.2 ERR_SSL_PROTOCOL_ERROR

1. 此问题在该版本中出现是因为listen配置的时候把443 后面的ssl删除了导致这个错误

server {
    # 注意这里就是443 ssl, 不要把ssl删除了，之前的版本
    listen       443 ssl;
    ...
}

2. 解决方法就是不要把443后面的ssl漏了，注意中间有空格

四、配置示例

4.1 SSL完整配置

#user  nobody;
worker_processes  1;

#error_log  logs/error.log;
#error_log  logs/error.log  notice;
#error_log  logs/error.log  info;

#pid        logs/nginx.pid;

events {
    worker_connections  1024;
}

http {
    include       mime.types;
    default_type  application/octet-stream;
    sendfile        on;
    keepalive_timeout  65;
    
    server {
        listen       80;
        server_name  www.codecoord.com codecoord.com;
        rewrite ^(.*)$ https://$host$1 permanent;
    }
    
    # https
    server {
        # 注意这里就是443 ssl, 不要把ssl删除
        listen       443 ssl;
        # 替换为SSL绑定的域名, 如www.codecoord.com
        server_name  www.codecoord.com;
        # 添加默认主目录和首页, 根据自己的路径修改
        root /opt/nginx/html;
        index index.html;

        # cert.pem和cert.key替换为上传文件的路径
        ssl_certificate      /opt/nginx/cert/www.codecoord.com.pem;
        ssl_certificate_key  /opt/nginx/cert/www.codecoord.com.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;
            try_files $uri $uri/ /index.html;   # 解决vue页面刷新404问题
        }
    }
}