开发者安装 - MFunction96/MFBlogReactRedux GitHub Wiki

开发者安装

环境配置

集成开发环境

请安装最新版Visual Studio并安装以下工作负载:

  • ASP.NET和Web开发
  • Node.js开发
  • .NET Core跨平台开发

首次开启项目时请耐心等待Visual Studio完成还原第三方依赖。

手动配置环境

安装依赖

安装MFBlog前需参照依赖手动安装所有依赖运行库。

还原第三方依赖

联网状态下,在MFBlog解决方案的MFBlog项目中(在MFBlog.csproj所在文件夹中)打开终端(bashpowershell等),在终端中输入以下指令。

每个指令耗时与网络稳定性和速度成负相关。

dotnet restore
npm install

数据库

MFBlog推荐使用MariaDB(或其它MySQL分支数据库)。

安装数据库

MariaDB安装请参阅https://downloads.mariadb.org

配置数据库

请使用初始root用户登录数据库。

增强安全性

请修改root用户密码以保证安全性,并关闭匿名登录方式。

use mysql;
delete from user where user='';
set password for 'root'@'localhost' = password('<password>');
flush privileges;

若需要启动数据库远程访问功能,请在mysql数据库下执行以下语句。

update user set host = '%' where user = 'root';
flush privileges;

创建数据库及用户

MFBlog不推荐使用root用户以及mysql数据库下存储数据。安装前需要创建独立数据库及用户。请参照以下SQL语句建立数据库及用户。

请自行替换<databasename>、<username>、<password>内容。

create database <databasename>;
use <databasename>;
create user '<username>'@'localhost' identified by '<password>';
grant all on <databasename>.* to '<username>'@'localhost';
flush privileges;

配置应用程序

MFBlog解决方案的MFBlog项目中(在MFBlog.csproj所在文件夹中),打开appsettings.json文件。

根据数据库用户及数据库配置,修改相应配置。

<server>指数据库位置;本机为localhost

<userid>指用户名。

<pwd>指密码。

<port>指数据库端口;默认为3306。

<database>指数据库名。

{
  "ConnectionStrings": {
    "DefaultConnection": "server=<server>;userid=<userid>;pwd=<pwd>;port=<port>;database=<database>;"
  }
}

创建数据表

MFBlog解决方案的MFBlog项目中(在MFBlog.csproj所在文件夹中)打开终端(bashpowershell等),在终端中输入以下指令。

dotnet ef database update

SendGrid

若无SendGrid账户,请先访问SendGrid获取免费账户。

安装密码管理器

MFBlog解决方案的MFBlog项目中(在MFBlog.csproj所在文件夹中)打开终端(bashpowershell等),在终端中输入以下指令安装密码管理器。

请自行替换<SendGridUser>内容。

dotnet user-secrets set SendGridUser <SendGridUser>

配置SendGrid密码

密码管理器工具避开实现详细信息,例如哪里和如何存储值。 无需知道这些实现的详细信息,可以使用该工具。 在当前版本中,这些值存储在JSON用户配置文件目录中的配置文件:

<userSecretsId>来自中指定的值.csproj文件。

  • Windows:%APPDATA%\microsoft\UserSecrets\ <userSecretsId>\secrets.json
  • Linux:~/.microsoft/usersecrets/<userSecretsId>/secrets.json
  • Mac:~/.microsoft/usersecrets/<userSecretsId>/secrets.json

打开相应位置的secrets.json文件,根据注册的SendGrid账户设置修改SendGrid配置。

请自行替换<SendGridUser>、<SendGridKey>内容。

{
  "SendGridUser": "<SendGridUser>",
  "SendGridKey": "<SendGridKey>"
}

运行

Visual Studio

在Visual Studio环境中,运行将默认托管到IIS中运行,自启动Chrome并显示页面。

手动运行

MFBlog解决方案的MFBlog项目中(在MFBlog.csproj所在文件夹中)打开终端(bashpowershell等),在终端中输入以下指令。

dotnet run

然后在浏览器中打开相应地址及端口。

⚠️ **GitHub.com Fallback** ⚠️