sub-web 项目常见问题解决方案

sub-web 项目常见问题解决方案

sub-web 项目地址: https://gitcode.com/gh_mirrors/su/sub-web

项目基础介绍

sub-web 是一个基于 vue-cli 和 tindy2013/subconverter 后端实现的配置自动生成工具。该项目的主要目的是通过前端界面自动生成配置文件，方便用户快速配置和管理网络代理。项目的主要编程语言包括：

• Vue.js: 用于构建前端界面。
• JavaScript: 用于实现前端逻辑。
• SCSS: 用于样式管理。
• Dockerfile: 用于容器化部署。

新手使用注意事项及解决方案

1. 环境依赖未安装

问题描述: 新手在尝试运行项目时，可能会遇到环境依赖未安装的问题，导致项目无法正常启动。

解决步骤:

1. 检查 Node.js 和 Yarn 是否安装:

   • 打开终端，输入以下命令检查 Node.js 和 Yarn 是否已安装：

     node -v
     yarn -v
     

   • 如果未安装，请先安装 Node.js 和 Yarn。

2. 安装项目依赖:

   • 进入项目根目录，运行以下命令安装项目依赖：

     yarn install
     

3. 启动项目:

   • 依赖安装完成后，运行以下命令启动项目：

     yarn serve
     

   • 项目启动后，可以通过浏览器访问 http://localhost:8080/ 查看效果。

2. Docker 镜像构建失败

问题描述: 新手在尝试使用 Docker 构建镜像时，可能会遇到构建失败的问题。

解决步骤:

1. 检查 Docker 是否安装:

   • 打开终端，输入以下命令检查 Docker 是否已安装：

     docker -v
     

   • 如果未安装，请先安装 Docker。

2. 构建 Docker 镜像:

   • 进入项目根目录，运行以下命令构建 Docker 镜像：

     docker build -t subweb-local:latest .
     

3. 运行 Docker 容器:

   • 镜像构建完成后，运行以下命令启动 Docker 容器：

     docker run -d -p 58080:80 --restart always --name subweb subweb-local:latest
     

   • 容器启动后，可以通过浏览器访问 http://localhost:58080/ 查看效果。

3. 后端配置错误

问题描述: 新手在配置后端时，可能会遇到配置错误的问题，导致前端无法正常连接后端。

解决步骤:

1. 检查 .env 文件:

   • 打开项目根目录下的 .env 文件，确保后端配置正确。
   • 例如，确保 VUE_APP_DEFAULT_BACKEND 配置项指向正确的后端地址。

2. 修改后端配置:

   • 如果需要修改后端地址，可以直接在 .env 文件中修改：

     VUE_APP_DEFAULT_BACKEND=http://your-backend-address:port
     

3. 重新启动项目:

   • 修改完成后，重新启动项目：

     yarn serve
     

   • 确保前端能够正常连接到后端。

总结

通过以上步骤，新手可以顺利解决在使用 sub-web 项目时遇到的常见问题。希望这些解决方案能够帮助你更好地理解和使用该项目。

sub-web 项目地址: https://gitcode.com/gh_mirrors/su/sub-web