OUI 项目常见问题解决方案

OUI 项目常见问题解决方案

oui 🐛 A framework used to develop Web interface for OpenWrt. Use Lua-eco + Vue3 + Vite + Element Plus. 项目地址: https://gitcode.com/gh_mirrors/ou/oui

项目基础介绍

OUI 是一个用于开发 OpenWrt Web 界面的框架。它采用了前后端分离的架构，后端使用 Lua-eco 开发 API，前端则使用 Vue3、Vite 和 Element Plus 进行页面开发。OUI 支持多用户和 ACL 管理，提供了细粒度的权限控制。每个页面都被单独打包为 IPK 文件，实现了模块化开发。

主要的编程语言包括：

• Lua：用于后端 API 开发
• JavaScript：用于前端开发
• Vue：前端框架
• C：部分底层代码
• Makefile：构建脚本
• Shell：脚本语言
• HTML：前端页面

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

1. 环境配置问题

问题描述：新手在配置开发环境时，可能会遇到依赖库安装不全或版本不匹配的问题。

解决步骤：

1. 检查依赖库：确保所有必要的依赖库已安装，包括 Lua-eco、Vue3、Vite 和 Element Plus。
2. 版本匹配：确认各依赖库的版本与项目要求的版本一致。可以通过项目文档或 package.json 文件查看版本要求。
3. 使用包管理工具：使用 npm 或 yarn 安装前端依赖，使用 luarocks 安装 Lua 依赖。

2. 编译错误

问题描述：在编译项目时，可能会遇到编译错误，尤其是对于不熟悉 Makefile 和 Lua 的新手。

解决步骤：

1. 检查编译命令：确保使用正确的编译命令。通常，前端代码使用 npm run build 或 yarn build，后端代码使用 make。
2. 查看错误日志：仔细阅读编译错误日志，定位错误的具体位置。常见的错误包括缺少依赖库、语法错误等。
3. 逐步调试：如果错误难以定位，可以尝试逐步编译，先编译前端代码，再编译后端代码，逐步排查问题。

3. 权限管理问题

问题描述：新手在使用 OUI 进行多用户和 ACL 管理时，可能会遇到权限配置错误的问题。

解决步骤：

1. 理解 ACL 配置：详细阅读项目文档中关于 ACL 配置的部分，理解各个权限项的含义。
2. 逐步配置：从简单的权限配置开始，逐步增加复杂度，确保每一步配置都正确无误。
3. 测试权限：在配置完成后，使用不同用户登录系统，测试权限是否按预期工作。如果发现问题，及时调整配置。

通过以上步骤，新手可以更好地理解和使用 OUI 项目，避免常见问题的困扰。

oui 🐛 A framework used to develop Web interface for OpenWrt. Use Lua-eco + Vue3 + Vite + Element Plus. 项目地址: https://gitcode.com/gh_mirrors/ou/oui