打造超級開發(fā)環(huán)境：Nginx和FastDFS在WSL中的完美結(jié)合

前言

隨著軟件開發(fā)領(lǐng)域的快速發(fā)展，跨平臺的開發(fā)環(huán)境變得日益重要。Windows Subsystem for Linux（WSL）和WSL 2為開發(fā)者提供了在Windows操作系統(tǒng)上體驗Linux環(huán)境的便捷途徑。本文將引導(dǎo)讀者深入探索WSL/WSL 2，并教授如何在其中搭建Nginx和FastDFS，為開發(fā)和測試提供更加靈活、高效的工作環(huán)境。

歡迎訂閱專欄：Python庫百寶箱：解鎖編程的神奇世界

1. 安裝和配置WSL/WSL 2

【W(wǎng)SL/WSL 2-Redis】解決Windows無法安裝WSL Ubuntu子系統(tǒng)與Redis安裝

1.1 啟用WSL和WSL 2功能

1.1.1 打開 PowerShell 作為管理員，啟用WSL功能

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

1.1.2 安裝Ubuntu

Ubuntu:

• 默認(rèn)發(fā)行版：Ubuntu默認(rèn)發(fā)行版
• Ubuntu 22.04 LTS：Ubuntu 22.04 LTS
• Ubuntu 20.04：Ubuntu 20.04
  這里我使用Ubuntu 22.04 LTS
  

1.1.2 設(shè)置用戶名密碼

2. 更新系統(tǒng)和安裝必要軟件

2.1 更新系統(tǒng)

2.1.1 打開終端

2.1.2 運行系統(tǒng)更新

sudo apt update

2.2 安裝必要軟件

2.2.1 libfastcommon 安裝

# 安裝必要的依賴項
sudo apt-get install -y gcc make libevent-dev libevent-2.1-7 cmake

# 創(chuàng)建目錄并下載 libfastcommon
sudo mkdir -p /usr/local/fastdfs
wget https://gitee.com/mirrors/libfastcommon/repository/archive/V1.0.43.tar.gz
sudo tar -xzvf V1.0.43.tar.gz -C /usr/local/fastdfs/
cd /usr/local/fastdfs/libfastcommon-V1.0.43/
sudo ./make.sh
sudo ./make.sh install

2.2.2 創(chuàng)建軟鏈接

sudo ln -s /usr/lib64/libfastcommon.so /usr/local/lib/libfastcommon.so

sudo ln -s /usr/local/lib64/libfdfsclient.so /usr/local/lib/libfdfsclient.so

sudo ln -s /usr/local/lib64/libfdfsclient.so /usr/lib/libfdfsclient.so

2.2.3 檢查軟鏈接

ls -l /usr/local/lib/libfastcommon.so
ls -l /usr/local/lib/libfdfsclient.so
ls -l /usr/lib/libfdfsclient.so

回到根目錄

cd ~

3. 安裝和配置FastDFS

查看子系統(tǒng)ip

ip addr

這里的eth0就是我們要使用到的地址，即192.168.14.131

3.1 下載并解壓 FastDFS

wget https://gitee.com/mirrors/fastdfs/repository/archive/V6.06.tar.gz
sudo tar -zxvf V6.06.tar.gz -C /usr/local/fastdfs/

3.2 修改安裝路徑

cd /usr/local/fastdfs/fastdfs-V6.06/
sudo vim make.sh

修改為

TARGET_PREFIX=$DESTDIR/usr/local

sudo ./make.sh
sudo ./make.sh install

安裝后，F(xiàn)astDFS主程序所在的位置是:

• /usr/local/bin可執(zhí)行文件所在位置。默認(rèn)安裝在/usr/bin中。
• /etc/fdfs配置文件所在位置。就是默認(rèn)位置。
• /usr/local/lib64主程序代碼所在位置。默認(rèn)在/usr/bin中。
• /usr/local/include/fastdfs包含的一些插件組所在位置。默認(rèn)在/usrlinclude/fastdfs 中。

3.3 Tracker-server配置

！?。。?！回到根目錄

cd ~

創(chuàng)建數(shù)據(jù)目錄

sudo mkdir -p /data/fastdfs/tracker

從sample獲取conf配置文件

sudo cp /etc/fdfs/tracker.conf.sample /etc/fdfs/tracker.conf

修改配置文件

sudo vim /etc/fdfs/tracker.conf

# 修改 base_path，就是剛才創(chuàng)建的文件夾
base_path = /data/fastdfs/tracker

同步一下啟動腳本，同步安裝目錄在/usr/local/bin下；

sudo vim /etc/init.d/fdfs_trackerd

# 修改 PRG
PRG=/usr/local/bin/fdfs_storaged

# 啟動服務(wù)
sudo /etc/init.d/fdfs_trackerd start

# 查看運行情況
ps aux | grep fdfs_trackerd

3.4 Storage -server配置

# 復(fù)制配置文件
sudo cp /etc/fdfs/storage.conf.sample /etc/fdfs/storage.conf

# 創(chuàng)建存儲路徑
sudo mkdir -p /data/fastdfs/storage/base
sudo mkdir -p /data/fastdfs/storage/store

# 修改 storage.conf
sudo vim  /etc/fdfs/storage.conf  

# 修改 base_path 和 tracker_server
base_path = /data/fastdfs/storage/base
tracker_server = 192.168.14.131:22122
store_path0 = /data/fastdfs/storage/store

sudo vim /etc/init.d/fdfs_storaged

# 修改 PRG
PRG=/usr/local/bin/fdfs_storaged

sudo /etc/init.d/fdfs_storaged start

ps aux | grep fdfs_storage

3.5 Client -server配置

# 復(fù)制配置文件
sudo cp /etc/fdfs/client.conf.sample /etc/fdfs/client.conf

# 創(chuàng)建客戶端路徑
sudo mkdir -p /data/fastdfs/client

# 修改 client.conf
sudo vim  /etc/fdfs/client.conf

# 修改 tracker_server 和 base_path
tracker_server = 192.168.14.131:22122
base_path = /data/fastdfs/client

# 上傳測試文件
echo "This is a test file." > /tmp/test.log
sudo /usr/local/bin/fdfs_upload_file /etc/fdfs/client.conf /tmp/test.log

4. fastdfs-nginx-module 安裝

4.1fastdfs-nginx-module 下載和解壓

?。。。?！回到根目錄

cd ~

# 下載并解壓 fastdfs-nginx-module
wget https://gitee.com/fastdfs100/fastdfs-nginx-module/repository/archive/V1.22.tar.gz
sudo tar -xzvf V1.22.tar.gz -C /usr/local/fastdfs/

4.2 修改 config 文件

cd /usr/local/fastdfs/fastdfs-nginx-module-V1.22/src/
sudo vim config

# 修改 config 文件
CORE_INCS="$CORE_INCS /usr/local/include/fastdfs /usr/include/fastcommon/"   

5.Nginx 安裝

5.1 安裝依賴項

# 安裝依賴項
sudo apt-get install -y build-essential libtool
sudo apt-get update
sudo apt-get install -y libpcre3 libpcre3-dev zlib1g-dev openssl

?。。。?！回到根目錄

cd ~

5.2 下載并解壓 Nginx

# 下載并解壓 Nginx
wget http://nginx.org/download/nginx-1.16.1.tar.gz
sudo tar -xzvf nginx-1.16.1.tar.gz -C /usr/local/fastdfs/

5.3 創(chuàng)建nginx 一些模塊的存儲目錄

可能由于權(quán)限不足，導(dǎo)致我們需要手動創(chuàng)建一些目錄，后面還會講到

sudo mkdir -p  /var/temp/nginx
sudo mkdir -p  /var/run/nginx
sudo mkdir -p  /var/log/nginx

5.4 編譯安裝nginx

cd /usr/local/fastdfs/nginx-1.16.1/
# 配置 Nginx
sudo  ./configure --prefix=/usr/local/nginx --pid-path=/var/run/nginx/nginx.pid --lock-path=/var/lock/nginx.lock --error-log-path=/var/log/nginx/error.log --http-log-path=/var/log/nginx/access.log --with-http_gzip_static_module --http-client-body-temp-path=/var/temp/nginx/client --http-proxy-temp-path=/var/temp/nginx/proxy --http-fastcgi-temp-path=/var/temp/nginx/fastcgi --http-uwsgi-temp-path=/var/temp/nginx/uwsgi --http-scgi-temp-path=/var/temp/nginx/scgi --add-module=/usr/local/fastdfs/fastdfs-nginx-module-V1.22/src

上述命令用于配置、編譯和安裝 Nginx Web 服務(wù)器以及額外模塊的命令，特別是 FastDFS Nginx 模塊。下面是您使用的選項的解釋：

• --prefix=/usr/local/nginx：指定 Nginx 的安裝目錄。
• --pid-path=/var/run/nginx/nginx.pid：指定 Nginx 主進程的 PID 文件路徑。
• --lock-path=/var/lock/nginx.lock：指定鎖文件的路徑。
• --error-log-path=/var/log/nginx/error.log：指定錯誤日志文件的路徑。
• --http-log-path=/var/log/nginx/access.log：指定 HTTP 訪問日志文件的路徑。
• --with-http_gzip_static_module：啟用 HTTP gzip 靜態(tài)模塊，用于提供預(yù)壓縮的文件。
• --http-client-body-temp-path=/var/temp/nginx/client：指定用于存儲客戶端請求主體的臨時文件的路徑。
• --http-proxy-temp-path=/var/temp/nginx/proxy：指定用于存儲代理模塊的臨時文件的路徑。
• --http-fastcgi-temp-path=/var/temp/nginx/fastcgi：指定用于存儲 FastCGI 模塊的臨時文件的路徑。
• --http-uwsgi-temp-path=/var/temp/nginx/uwsgi：指定用于存儲 uWSGI 模塊的臨時文件的路徑。
• --http-scgi-temp-path=/var/temp/nginx/scgi：指定用于存儲 SCGI 模塊的臨時文件的路徑。
• --add-module=/usr/local/fastdfs/fastdfs-nginx-module-1.22/src：添加 FastDFS Nginx 模塊到編譯過程中。

這個命令配置了 Nginx，包括各種模塊的支持，并設(shè)置了日志文件和臨時存儲的路徑。配置完成后，通常會運行 make 和 make install 命令來編譯和安裝 Nginx，以及配置的模塊。

在繼續(xù)編譯之前，請檢查 ./configure 命令的輸出，確保沒有錯誤或缺少的依賴項。此外，請確保您對指定路徑有寫權(quán)限，并且系統(tǒng)上已安裝所需的依賴項。

sudo make
sudo make install

5.5 snprintf()報錯

cc1: all warnings being treated as errors
make[1]: *** [objs/Makefile:1214: objs/addon/src/ngx_http_fastdfs_module.o] Error 1
make[1]: Leaving directory ‘/usr/local/fastdfs/nginx-1.16.1’
make: *** [Makefile:8: build] Error 2

snprintf()函數(shù)不是標(biāo)準(zhǔn)C/C++庫函數(shù)，在許多編譯器中，廠商提供了其相應(yīng)的實現(xiàn)的版本。在gcc中，該函數(shù)名稱就snprintf()，而在VS中稱為_snprintf()。
Makefile文件中，設(shè)置的編譯等級比較高，使用-werror選項，導(dǎo)致如果出現(xiàn)任何警告都將視為錯誤，所以就會導(dǎo)致編譯失敗。
禁用警告當(dāng)作錯誤處理：
如果您只是想先繞過這個問題，您可以在編譯時禁用將警告當(dāng)作錯誤處理。這可能并不是最佳做法，但可以讓您繼續(xù)編譯。在 configure 或 Makefile 中尋找類似 -Werror 的標(biāo)志，并將其刪除或注釋掉。

cd objs
sudo vim Makefile

CFLAGS =  -pipe  -O -W -Wall -Wpointer-arith -Wno-unused-parameter -Werror -g  -D_FILE_OFFSET_BITS=64 -DFDFS_OUTPUT_CHUNK_SIZE='256*1024' -DFDFS_MOD_CONF_FILENAME='"/etc/fdfs/mod_fastdfs.conf"'

刪掉-Werror即可編譯成功
在編譯過程中使用 -Werror 標(biāo)志會將所有警告視為錯誤，這意味著如果有任何警告，編譯過程會失敗。這樣的做法有其優(yōu)點，因為它強制開發(fā)者解決潛在的問題，確保代碼的質(zhì)量。然而，有時候這也可能導(dǎo)致編譯失敗，尤其是在一些舊版本的代碼或編譯器中，可能存在一些不同程度的警告。

當(dāng)你刪除 -Werror 標(biāo)志后，編譯過程將不再把警告當(dāng)作錯誤對待，從而允許編譯器繼續(xù)進行，即使有一些警告。這樣做的目的是讓編譯能夠在存在一些輕微問題或非常規(guī)范的代碼時繼續(xù)進行。

請注意，盡管刪除 -Werror 可能會讓編譯通過，但在實際生產(chǎn)環(huán)境中，最好是在有警告的情況下盡量解決這些警告，以確保代碼的健壯性和可維護性。有時，特定的警告可能指示潛在的 bug 或安全問題，因此忽略這些警告可能會引入潛在的風(fēng)險。

cd ..
sudo make
sudo make install

5.6 拷貝 編輯 fastdfs-nginx-module的配置文件到/etc/fdfs/

?。。。。』氐礁夸?/strong>

cd ~

# 復(fù)制模塊配置文件
sudo cp  /usr/local/fastdfs/fastdfs-nginx-module-V1.22/src/mod_fastdfs.conf  /etc/fdfs/
sudo vim  /etc/fdfs/mod_fastdfs.conf

# 修改 tracker_server 和 store_path0
tracker_server = 192.168.14.131:22122
store_path0 = /data/fastdfs/storage/store
url_have_group_name = true

# 復(fù)制其他配置文件
sudo cp /usr/local/fastdfs/fastdfs-V6.06/conf/http.conf /etc/fdfs
sudo cp /usr/local/fastdfs/fastdfs-V6.06/conf/mime.types /etc/fdfs

# 創(chuàng)建軟鏈接
sudo ln -s /usr/local/lib64/libfdfsclient.so /usr/lib64/libfdfsclient.so

# 創(chuàng)建網(wǎng)絡(luò)訪問存儲服務(wù)的軟鏈接
sudo ln -s /data/fastdfs/storage/store/data /data/fastdfs/storage/store/data/M00

# 修改 Nginx 配置
cd /usr/local/nginx/conf
sudo vim nginx.conf

# 修改配置文件
user  nobody;
worker_processes  4;
# 增加 events 部分
events {
    worker_connections  1024;
}

# 配置 http 部分
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;
    error_log /var/log/nginx/error.log;

    sendfile        on;
    keepalive_timeout  65;

    # 配置服務(wù)器
    server {
        listen       8888;
        server_name  localhost;

        # 配置 FastDFS 模塊
        location ~/group[0-9]/M00  {
            ngx_fastdfs_module;
        }
        
        error_page   500 502 503 504  /50x.html;
        location = /50x.html {
            root   html;
        }
    }
}

# 啟動 Nginx
cd /usr/local/nginx
sudo ./sbin/nginx -t
sudo ./sbin/nginx

sudo mkdir -p /usr/local/nginx/logs
echo "This is a test file." | sudo tee /usr/local/nginx/logs/access.log

command | tee [OPTION]... [FILE]...

ls -l | tee output.txt

sudo ./sbin/nginx

# 上傳測試文件
sudo /usr/local/bin/fdfs_upload_file /etc/fdfs/client.conf b.jpg

# 查看文件信息
/usr/local/bin/fdfs_file_info /etc/fdfs/client.conf group1/M00/00/00/wKgOg2VZzrSAXZyIAADwwTe7XM4453.jpg

# 查看存儲路徑下的文件
sudo find /data/fastdfs/storage -type f -exec ls -l {} +

# 查看 Nginx 運行狀態(tài)
sudo /usr/local/nginx/sbin/nginx -t

# 重新啟動 Storage
sudo /etc/init.d/fdfs_storaged restart

# 啟動 Nginx
sudo /usr/local/nginx/sbin/nginx