NewLife.Cube 项目常见问题解决方案

NewLife.Cube 项目常见问题解决方案

NewLife.Cube Web快速开发平台，搭建管理后台，灵活可扩展！内部集成了用户权限管理、模板继承、SSO登录、OAuth服务端、数据导出与分享等多个功能模块，在真实项目中经历过单表100亿数据添删改查的考验。 项目地址: https://gitcode.com/gh_mirrors/ne/NewLife.Cube

1. 项目基础介绍和主要编程语言

NewLife.Cube 是一个基于 .NET 平台的 Web 快速开发框架，旨在帮助开发者快速搭建具有管理后台、灵活可扩展的系统。它内部集成了用户权限管理、模板继承、SSO 登录、OAuth 服务端、数据导出与分享等多个功能模块。项目的主要编程语言是 C#。

2. 新手常见问题及解决步骤

问题一：如何快速搭建和运行 NewLife.Cube 项目？

解决步骤：

1. 确保安装了 .NET SDK。
2. 克隆项目到本地：git clone https://github.com/NewLifeX/NewLife.Cube.git
3. 使用 Visual Studio 打开项目。
4. 找到并运行 NewLife.Cube 项目。
5. 在浏览器中访问 http://localhost:<端口>/，默认端口为 5000。

问题二：如何配置数据库连接？

解决步骤：

1. 在项目的 appsettings.json 文件中找到 ConnectionStrings 部分。
2. 根据需要更改数据库连接字符串，例如：

"Membership": "Data Source=|DataDirectory|Membership.db;provider=sqlite",
"Cube": "Data Source=|DataDirectory|Cube.db;provider=sqlite",
"Log": "Data Source=|DataDirectory|Log.db;provider=sqlite"

3. 如果使用 MySQL，需要更改为：

"Membership": "Server=myServerAddress;Port=3306;Database=Membership;Uid=myUsername;Pwd=myPassword;provider=mysql",
"Cube": "Server=myServerAddress;Port=3306;Database=Cube;Uid=myUsername;Pwd=myPassword;provider=mysql",
"Log": "Server=myServerAddress;Port=3306;Database=Log;Uid=myUsername;Pwd=myPassword;provider=mysql"

4. 保存文件并重新启动项目。

问题三：如何设置和启动 SSO 单点登录？

解决步骤：

1. 在项目的 appsettings.json 文件中配置 SSO 相关的连接字符串。
2. 编译并运行 CubeSSO 项目。
3. 修改 CubeSSO 项目的 appsettings.json 文件，配置允许的域名和其他设置。
4. 启动 SSO 服务，默认地址为 http://localhost:8080。
5. 在主项目中的 Startup.cs 文件中配置 SSO 中间件。

app.UseSSOAuthentication();

6. 保存文件并重新启动项目。现在，应该可以使用 SSO 登录了。

NewLife.Cube Web快速开发平台，搭建管理后台，灵活可扩展！内部集成了用户权限管理、模板继承、SSO登录、OAuth服务端、数据导出与分享等多个功能模块，在真实项目中经历过单表100亿数据添删改查的考验。 项目地址: https://gitcode.com/gh_mirrors/ne/NewLife.Cube