【WSL/WSL2-Ubuntu】突破界限：不使用服务器在一台Windows搭建Nginx+FastDFS
打造超级开发环境：Nginx和FastDFS在WSL中的完美结合
前言
随着软件开发领域的快速发展，跨平台的开发环境变得日益重要。Windows Subsystem for Linux（WSL）和WSL 2为开发者提供了在Windows操作系统上体验Linux环境的便捷途径。本文将引导读者深入探索WSL/WSL 2，并教授如何在其中搭建Nginx和FastDFS，为开发和测试提供更加灵活、高效的工作环境。
文章目录
- 打造超级开发环境：Nginx和FastDFS在WSL中的完美结合
- 前言
- 1. 安装和配置WSL/WSL 2
-
- 1.1 启用WSL和WSL 2功能
-
- 1.1.1 打开 PowerShell 作为管理员，启用WSL功能
- 1.1.2 安装Ubuntu
- 1.1.2 设置用户名密码
- 2. 更新系统和安装必要软件
-
- 2.1 更新系统
-
- 2.1.1 打开终端
- 2.1.2 运行系统更新
- 2.2 安装必要软件
-
- 2.2.1 libfastcommon 安装
- 2.2.2 创建软链接
- 2.2.3 检查软链接
- 3. 安装和配置FastDFS
-
-
- 3.1 下载并解压 FastDFS
- 3.2 修改安装路径
- 3.3 Tracker-server配置
- 3.4 Storage -server配置
- 3.5 Client -server配置
-
- 4. fastdfs-nginx-module 安装
-
- 4.1fastdfs-nginx-module 下载和解压
- 4.2 修改 config 文件
- 5.Nginx 安装
-
- 5.1 安装依赖项
- 5.2 下载并解压 Nginx
- 5.3 创建nginx 一些模块的存储目录
- 5.4 编译安装nginx
- 5.5 snprintf()报错
- 5.6 拷贝 编辑 fastdfs-nginx-module的配置文件到/etc/fdfs/
- 5.7 复制其他配置文件，创建软链接
- 5.8 修改 Nginx 配置
- 5.9 启动 Nginx
- 5.10 再次启动Nginx
- 5.10 测试访问
- 6. 模块间关系：
- 7. 各个模块用法：
- 8. 各个模块存在的意义：
- 总结
1. 安装和配置WSL/WSL 2
【WSL/WSL 2-Redis】解决Windows无法安装WSL Ubuntu子系统与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:
- 默认发行版：Ubuntu默认发行版
- Ubuntu 22.04 LTS：Ubuntu 22.04 LTS
- Ubuntu 20.04：Ubuntu 20.04
这里我使用Ubuntu 22.04 LTS
1.1.2 设置用户名密码
2. 更新系统和安装必要软件
2.1 更新系统
2.1.1 打开终端
2.1.2 运行系统更新
sudo apt update
2.2 安装必要软件
2.2.1 libfastcommon 安装
# 安装必要的依赖项
sudo apt-get install -y gcc make libevent-dev libevent-2.1-7 cmake
# 创建目录并下载 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 创建软链接
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
查看子系统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
安装后，FastDFS主程序所在的位置是:
- /usr/local/bin可执行文件所在位置。默认安装在/usr/bin中。
- /etc/fdfs配置文件所在位置。就是默认位置。
- /usr/local/lib64主程序代码所在位置。默认在/usr/bin中。
- /usr/local/include/fastdfs包含的一些插件组所在位置。默认在/usrlinclude/fastdfs 中。
3.3 Tracker-server配置
！！！！！回到根目录
cd ~
创建数据目录
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，就是刚才创建的文件夹
base_path = /data/fastdfs/tracker
同步一下启动脚本，同步安装目录在/usr/local/bin下；
sudo vim /etc/init.d/fdfs_trackerd
# 修改 PRG
PRG=/usr/local/bin/fdfs_storaged
# 启动服务
sudo /etc/init.d/fdfs_trackerd start
# 查看运行情况
ps aux | grep fdfs_trackerd
3.4 Storage -server配置
# 复制配置文件
sudo cp /etc/fdfs/storage.conf.sample /etc/fdfs/storage.conf
# 创建存储路径
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配置
# 复制配置文件
sudo cp /etc/fdfs/client.conf.sample /etc/fdfs/client.conf
# 创建客户端路径
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 创建nginx 一些模块的存储目录
可能由于权限不足，导致我们需要手动创建一些目录，后面还会讲到
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 服务器以及额外模块的命令，特别是 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 静态模块，用于提供预压缩的文件。--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，包括各种模块的支持，并设置了日志文件和临时存储的路径。配置完成后，通常会运行 make 和 make install 命令来编译和安装 Nginx，以及配置的模块。
在继续编译之前，请检查 ./configure 命令的输出，确保没有错误或缺少的依赖项。此外，请确保您对指定路径有写权限，并且系统上已安装所需的依赖项。
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()函数不是标准C/C++库函数，在许多编译器中，厂商提供了其相应的实现的版本。在gcc中，该函数名称就snprintf()，而在VS中称为_snprintf()。
Makefile文件中，设置的编译等级比较高，使用-werror选项，导致如果出现任何警告都将视为错误，所以就会导致编译失败。
禁用警告当作错误处理：
如果您只是想先绕过这个问题，您可以在编译时禁用将警告当作错误处理。这可能并不是最佳做法，但可以让您继续编译。在 configure 或 Makefile 中寻找类似 -Werror 的标志，并将其删除或注释掉。
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 标志会将所有警告视为错误，这意味着如果有任何警告，编译过程会失败。这样的做法有其优点，因为它强制开发者解决潜在的问题，确保代码的质量。然而，有时候这也可能导致编译失败，尤其是在一些旧版本的代码或编译器中，可能存在一些不同程度的警告。
当你删除 -Werror 标志后，编译过程将不再把警告当作错误对待，从而允许编译器继续进行，即使有一些警告。这样做的目的是让编译能够在存在一些轻微问题或非常规范的代码时继续进行。
请注意，尽管删除 -Werror 可能会让编译通过，但在实际生产环境中，最好是在有警告的情况下尽量解决这些警告，以确保代码的健壮性和可维护性。有时，特定的警告可能指示潜在的 bug 或安全问题，因此忽略这些警告可能会引入潜在的风险。
cd ..
sudo make
sudo make install
5.6 拷贝 编辑 fastdfs-nginx-module的配置文件到/etc/fdfs/
！！！！！回到根目录
cd ~
# 复制模块配置文件
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
5.7 复制其他配置文件，创建软链接
# 复制其他配置文件
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
# 创建软链接
sudo ln -s /usr/local/lib64/libfdfsclient.so /usr/lib64/libfdfsclient.so
# 创建网络访问存储服务的软链接
sudo ln -s /data/fastdfs/storage/store/data /data/fastdfs/storage/store/data/M00
5.8 修改 Nginx 配置
# 修改 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;
# 配置服务器
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;
}
}
}
5.9 启动 Nginx
# 启动 Nginx
cd /usr/local/nginx
sudo ./sbin/nginx -t
sudo ./sbin/nginx
由于安装时权限不足，有可能会出问题，你可以打开目录或根据提示看看缺哪个，创建后重新安装，也可以使用命令创建
这里提示我缺少
/usr/local/nginx/logs/test.log
sudo mkdir -p /usr/local/nginx/logs
echo "This is a test file." | sudo tee /usr/local/nginx/logs/access.log
什么是tee
tee 是一个在 Linux 和类 Unix 操作系统上常用的命令行工具。tee 命令的主要功能是从标准输入读取数据，将其复制到标准输出，并写入一个或多个文件。它通常用于在不中断数据流的情况下将输出保存到文件中，同时在终端上显示。
tee 命令的基本语法如下：
command | tee [OPTION]... [FILE]...
command: 要从标准输入读取的命令或数据。tee: 命令本身。[OPTION]: 可选参数，用于调整tee命令的行为。[FILE]: 要写入的文件名。如果省略文件名，tee将向标准输出复制数据。
一些常用的 tee 选项包括：
-a：追加到文件而不是覆盖文件。-i：忽略写入时的错误。
例如，要将命令的输出保存到文件并在终端上显示，可以使用如下命令：
ls -l | tee output.txt
这将列出当前目录的文件，并将输出保存到 output.txt 文件中，并在终端上显示相同的输出。
，使用 echo "This is a test file." | sudo tee /usr/local/nginx/logs/access.log 就是将文本写入文件同时保持在终端上显示的一个例子。
5.10 再次启动Nginx
sudo ./sbin/nginx
此时我们可以在8888端口发现配置成功了
5.10 测试访问
上传一张图片
我们当前在usr\local\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上也可以访问
http://192.168.14.131:8888/group1/M00/00/00/wKgOg2VZzrSAXZyIAADwwTe7XM4453.jpg
# 查看 Nginx 运行状态
sudo /usr/local/nginx/sbin/nginx -t
# 重新启动 Storage
sudo /etc/init.d/fdfs_storaged restart
# 启动 Nginx
sudo /usr/local/nginx/sbin/nginx
6. 模块间关系：
-
libfastcommon： 这是一个 FastDFS 系统的底层库，提供了一些基础的功能和工具，如事件处理、日志、内存池等。FastDFS 系统的其他组件，如 Tracker 和 Storage，都依赖于 libfastcommon。
-
Tracker： Tracker 是 FastDFS 的一个核心组件，用于跟踪存储服务器的状态和文件信息。它负责协调 Storage 节点，并提供文件上传、下载的元数据查询服务。
-
Storage： Storage 是 FastDFS 的存储节点，负责文件的实际存储和提供文件的读写服务。多个 Storage 节点可以通过 Tracker 进行协调，形成一个分布式的存储系统。
-
Client： 客户端是与 FastDFS 系统交互的用户端，用于上传、下载文件等操作。它通过配置文件与 Tracker 和 Storage 进行通信。
-
fastdfs-nginx-module： 这是一个 Nginx 模块，用于在 Nginx 服务器上实现 FastDFS 文件服务的 HTTP 访问接口。它允许 Nginx 直接通过 HTTP 访问 FastDFS 存储的文件。
-
Nginx： Nginx 是一个高性能的开源反向代理服务器，用于处理 HTTP 请求。在这里，Nginx 与 fastdfs-nginx-module 配合使用，使 Nginx 具备了直接访问 FastDFS 存储的文件的能力。
7. 各个模块用法：
-
libfastcommon： 安装 libfastcommon 库并创建软链接，为 FastDFS 的其他组件提供基础支持。
-
Tracker： 安装 Tracker，配置并启动 Tracker 服务。Tracker 负责协调存储服务器，并提供元数据查询服务。
-
Storage： 安装 Storage，配置并启动 Storage 服务。Storage 负责实际的文件存储和提供读写服务。
-
Client： 安装客户端，配置客户端参数，可以通过客户端上传、下载文件等操作。
-
fastdfs-nginx-module： 安装该模块，配置 Nginx，使其能够通过 HTTP 访问 FastDFS 存储的文件。
-
Nginx： 配置 Nginx，加载 fastdfs-nginx-module 模块，实现对 FastDFS 存储文件的直接访问。
8. 各个模块存在的意义：
-
分布式存储： FastDFS 采用分布式存储架构，允许横向扩展，提高了存储容量和性能。
-
高可用性： 多个 Storage 节点之间通过 Tracker 协调，当一个节点发生故障时，系统依然可以提供服务。
-
元数据查询： Tracker 提供了文件的元数据查询服务，客户端可以通过 Tracker 查询文件信息，如文件路径、大小等。
-
HTTP 访问接口： 通过 fastdfs-nginx-module，Nginx 可以直接通过 HTTP 访问 FastDFS 存储的文件，提高了文件的访问效率。
-
灵活性： FastDFS 提供了客户端 API，允许开发者通过编程接口与 FastDFS 系统进行交互，实现更多自定义的操作。
综合而言，FastDFS 提供了一个高性能、可扩展、分布式的文件存储解决方案，适用于需要大规模文件存储和访问的场景，如图片、视频等多媒体文件的存储与分发。
总结
通过按照以上步骤，你已经在WSL/WSL 2上成功搭建了Nginx和FastDFS。这使得你可以在Windows系统中方便地运行和测试这些服务。
这只是一个基本的配置，根据实际需要，你可能需要进一步调整和优化配置，以满足特定的项目要求。
这不仅仅是搭建服务的过程，更是对跨平台开发和操作的一次探索。