跨模态搜索系列 --- 一、VCED-环境搭建

一、VCED-环境搭建

1 系统环境搭建

$$\begin{array}{ccc}序号& 系统& 版本\\ 1& Windows10& 21H2\&19044.2486\\ 2& Linux& WSL2\&Ubuntu20.04\end{array}$$

具体步骤：

1. 开启相关服务

   控制面板 $\to$ 程序与功能 $\to$ 启动或关闭Windows功能 $\to$ 适用于Linux的Windows子系统

   

   勾选上述选项，并重启计算机

2. 安装Linux分发版

   • 安装 WSL（默认 C盘）

     • 通过命令 wsl --list --online 查看可用的Linux发行版列表

       

     • 通过命令 wsl --install -d 指定安装Linux版本，进行安装

       

       **注：**若提示错误 0x80072ee2，说明服务器无响应，请尝试修改host或科学上网解决

     • 设置Linux用户信息

       设置好默认用户名和密码，即可开始使用WSL

       通过 wsl -l -v 命令可查看当前wsl版本

       

   • 将wsl由C盘迁移到其他盘目录

     • 导出分发版为tar文件到指定盘目录位置

       wsl --export Ubuntu-20.04 E:\Linux\wsl-ubuntu20.04.tar

     • 生成tar文件后，注销当前分发版

       wsl --unregister Ubuntu-20.04

     • 成功注销后，将导出的分发版重新导入并安装在指定位置

       wsl --import Ubuntu-20.04 E:\Linux E:\Linux\wsl-ubuntu20.04.tar --version 1

       

   • 版本更新

     • 下载版本更新包并运行该msi文件

       https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi

     • 将版本由 WSL 1 转换到 WSL 2

       wsl --set-version Ubuntu-20.04 2

       

     • Error：参考的对象类型不支持尝试的操作

       管理员打开PowerShell，运行命令 netsh winsock reset

   • 配置国内源

     • 备份原来的文件

       cp /etc/apt/sources.list /etc/apt/sources.list.bak

     • 替换成国内源 vim /etc/apt/sources.list

       ## 以清华源为例
       deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ bionic main restricted universe multiverse
       deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ bionic main restricted universe multiverse
       deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ bionic-updates main restricted universe multiverse
       deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ bionic-updates main restricted universe multiverse
       deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ bionic-backports main restricted universe multiverse
       deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ bionic-backports main restricted universe multiverse
       deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ bionic-security main restricted universe multiverse
       deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ bionic-security main restricted universe multiverse
       deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ bionic-proposed main restricted universe multiverse
       deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ bionic-proposed main restricted universe multiverse

     • 更新系统源

       sudo apt-get update & sudo apt-get upgrade

     • 安装 ipconfig sudo apt-get install net-tools

3. 为WSL 2 配置代理 [Clash for Windows]

   • 在Clash客户端中允许局域网连接，打开 Allow LAN 开关，并记录下端口 Port

   • 修改 .bashrc 文件，第一次打开时该文件常为空文件，无需在意，添加如下内容

     host_ip=$(cat /etc/resolv.conf |grep "nameserver" |cut -f 2 -d " ")
     export http_proxy="http://$host_ip:[Port]"
     export https_proxy="http://$host_ip:[Port]"
     

   • 在root用户下，运行 sudo visudo 命令，加入如下内容并保存

     Defaults env_keep="http_proxy https_proxy"
     

   • 输入 source .bashrc 命令使文件修改生效，并通过 echo $http_proxy 命令验证修改是否成功

     当修改成功时，会打印出 http://[ip地址]:[端口] ,此时输入 wget www.google.com 可顺利连接成功

2 服务配置

1. 拉取项目

   git clone https://github.com/kainstan/vced.git

   cd /vced

   # 启动Shell脚本

   ./startup.sh native

2. 环境安装

   Shell脚本会自动配置好相应环境，按上述命令一键执行即可，部分情况下需要手动指定时区以及Rust安装选项，此处参考下图

   

   

   注意： 由于安装路径的问题，可能会出现在root路径下找不到 requirements.txt 和 app.py 文件的情况，此时等安装完毕后，手动进入 /vced/code/service 目录运行 pip install -r requirements.txt 进行安装即可

3. 启动Server服务
   进入server文件夹，启动server python app.py

4. 启动Web服务
   保持上述server运行，另开一个Shell进入web文件夹，启动web服务 streamlit run app.py，默认端口为 8501

   

5. 访问服务
   通过上述地址即可顺利访问服务
   

6. 查看本地文档
   可通过 /docs/build/html/index.html 查看本地文档