微信小程序Nginx環境配置

環境配置概述

主要內容：

• SSL免費證書申請步驟
• Nginx HTTPS 配置
• TLS 1.2 升級過程

微信小程序要求使用 https 發送請求，那麼Web服務器就要配置成支持 https，須要先申請SSL證書

小程序也要求 TLS（傳輸層安全協議）的版本至少爲 1.2，在配置好 https以後，若是 TLS 的版本較低，就涉及到升級問題

因此 Server端環境配置的主要步驟：

• 申請 SSL 證書
• 配置web服務器支持https（我使用的是nginx）
• 升級到 TLS 1.2 

 

SSL證書申請

https 須要使用SSL證書，這個證書的價格爲每一年三五千到一萬多，對於小團隊或者是想熟悉一下小程序的用戶來講，這個價格仍是比較高的，這種狀況能夠選擇免費證書

另外，也能夠考慮一下雲服務，例如 野狗、LeanCloud 這些成熟的服務平臺，都支持 https，若是這些平臺能知足本身的業務需求，就省掉了不少麻煩

免費證書：阿里雲上的 賽門鐵克 免費型DV SSL

申請過程

wanwang.aliyun.com

登陸控制檯，點擊左側菜單中的 安全 -> 證書服務，這個頁面中右上角有 購買證書 按鈕，點擊進入購買頁，選擇免費型DV SSL，購買

訂單金額爲0元，只是走一遍購買流程，完成後回到證書服務頁面，能夠在列表中看到一個證書

首先進行 「補全」 操做，填寫本身的域名和基本信息

以後 「補全」 鏈接會變爲 「進度」，點擊後根據提示操做，主要是驗證本身的服務器，我選的是文件驗證，下載一個文件上傳到本身服務器，等待驗證

驗證沒問題後，大概10分鐘左右就能夠下載SSL證書了

 

Nginx HTTPS 配置

證書上傳到nginx目錄下，例如：

/usr/local/nginx/cert

修改 nginx配置文件：

配置 HTTPS server 塊兒，添加SSL配置

# HTTPS server
#
server {
    listen       443 ssl;
    server_name  localhost;
    ......
    
    ssl on;
    ssl_certificate   /usr/local/nginx/cert/213994146300992.pem;
    ssl_certificate_key  /usr/local/nginx/cert/213994146300992.key;
    ssl_session_timeout 5m;
    ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:ECDHE:ECDH:AES:HIGH:!NULL:!aNULL:!MD5:!ADH:!RC4;
    ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
    ssl_prefer_server_ciphers on;


    location / {
        root   html;
        index  index.html index.htm;
    }

    ......
    
}

購買證書後，會提示如何修改，從新加載配置文件，瀏覽器中使用 https 方式訪問本身的域名，看是否能夠正常訪問

 

升級到 TLS 1.2

查看 TLS 版本

訪問 https url 後，地址欄前面會有一個‘綠色小鎖圖標’，點擊它能夠查看到 TLS 版本信息

若是沒有達到 1.2 就須要升級，下面的操做環境爲 centos linux

 

1）查看 openssl 版本

openssl version -a  

1.0.2如下的版本就要升級，以前的版本官方都已經中止維護

 

2）升級 openssl

到官網下載新版

https://www.openssl.org/source/

例以下載到 /usr/local

升級 ：

cd /usr/local
tar zxvf openssl-1.0.2j.tar.gz  
cd openssl-1.0.2j 
./config --prefix=/usr/local/openssl  
make && make install  

mv /usr/bin/openssl /usr/bin/openssl.OFF      #備份
mv /usr/include/openssl /usr/include/openssl.OFF  
ln -s /usr/local/openssl/bin/openssl  /usr/bin/openssl  #建立軟連接
ln -s /usr/local/openssl/include/openssl /usr/include/openssl  
echo "/usr/local/openssl/lib"  >>/etc/ld.so.conf  
ldconfig -v  

驗證：

openssl version -a  

 

3）從新編譯 nginx

升級OpenSSL以後，nginx須要從新編譯，不然TLS仍是舊版本的

下面是基本安裝，如您需求更多，請自行調整

用到的軟件

• openssl 前面已經安裝完了

• pcre  若是安裝過就無需再裝

• zlib 系統自帶也行

Pcre安裝：

下載地址

http://www.pcre.org/
例以下載到 /usr/local

cd /usr/local
tar -zxv -f pcre-8.39.tar.gz
cd pcre-8.39
./configure --prefix=/usr/local/pcre/
make && make install

Pcre安裝步驟..

Zlib安裝：

下載地址 

http://www.zlib.net/
例以下載到 /usr/local

cd /usr/local
tar -zxv -f zlib-1.2.10.tar.gz
cd zlib-1.2.10
./configure --prefix=/usr/local/zlib/
make && make install

Zlib安裝

編譯nginx:

tar zxvf nginx-1.10.3.tar.gz
cd nginx-1.10.3

./configure --prefix=/data/nginx --with-http_ssl_module --with-openssl=/usr/local/openssl

tar -zxvf nginx-1.10.2.tar.gz
cd nginx-1.10.2

./configure \
--user=用戶 \
--group=組 \
--prefix=/usr/local/nginx \
--with-http_ssl_module \
--with-openssl=/usr/local/openssl-1.0.2j \
--with-pcre=/usr/local/pcre-8.39 \
--with-zlib=/usr/local/zlib-1.2.10 \
--with-http_stub_status_module \
--with-threads

make && make install

更多...

編譯完成後，記得把修改配置文件，添加好 SSL 的相關信息

而後啓動nginx，訪問 https url 再次驗證 TSL 版本

 

Nginx編譯安裝時遇到的問題：

報錯信息以下：

/bin/sh: line 2: ./config: No such file or directory
make[1]: *** [/usr/local/ssl/.openssl/include/openssl/ssl.h] Error 127
make[1]: Leaving directory `/usr/local/src/nginx-1.10.2‘
make: *** [build] Error 2

須要說明的是，我這裏編譯所使用的Nginx源碼是1.10.2的。根據報錯信息咱們知道，出錯是由於Nginx在編譯時並不能在/usr/local/ssl/.openssl/ 這個目錄找到對應的文件，其實咱們打開/usr/local/ssl/這個目錄能夠發現這個目錄下是沒有.openssl目錄的，所以咱們修改Nginx編譯時對openssl的路徑選擇就能夠解決這個問題了

解決方案：

打開nginx源文件下的/root/nginx-1.10.2/auto/lib/openssl/conf文件

找到這麼一段代碼：

CORE_INCS="$CORE_INCS $OPENSSL/.openssl/include"
CORE_DEPS="$CORE_DEPS $OPENSSL/.openssl/include/openssl/ssl.h"
CORE_LIBS="$CORE_LIBS $OPENSSL/.openssl/lib/libssl.a"
CORE_LIBS="$CORE_LIBS $OPENSSL/.openssl/lib/libcrypto.a"
CORE_LIBS="$CORE_LIBS $NGX_LIBDL"

修改爲如下代碼：

CORE_INCS="$CORE_INCS $OPENSSL/.openssl/include"
CORE_DEPS="$CORE_DEPS $OPENSSL/include/openssl/ssl.h"
CORE_LIBS="$CORE_LIBS $OPENSSL/lib/libssl.a"
CORE_LIBS="$CORE_LIBS $OPENSSL/lib/libcrypto.a"
CORE_LIBS="$CORE_LIBS $NGX_LIBDL"

而後再進行Nginx的編譯安裝便可　

 

小結

通過這些步驟，微信小程序就能夠和後端正常溝通了