# CoreHome

**Repository Path**: anysharp/CoreHome

## Basic Information

- **Project Name**: CoreHome
- **Description**: 基于.NET8开源的个人博客项目，采用前后端分离、高并发、高可用的微服务架构，支持 MySQL、SqlServer、Redis 等多种数据库。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2024-10-28
- **Last Updated**: 2025-04-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 博客

## README

# CoreHome

![build](https://github.com/lixinyang123/CoreHome/workflows/build/badge.svg?branch=main)

An open source blog system based on [.NET](https://dotnet.microsoft.com/) and [Alibaba Cloud](https://www.aliyun.com/).

Current personal [website](https://www.lllxy.net), 

### Features

- Personal information management.
- Homepage project management.
- Theme management (background, light and dark themes, BGM).
- Blog management (classification, tagging, archiving, comments).
- Feedback alerts.
- Network status detection.

### Screenshot

<div style="display:flex; width: 100%;">
    <image style="width: 49%;" src="https://user-images.githubusercontent.com/32838371/168005656-1e49ccb1-737c-464c-bd25-5a7e2f89541b.png" />
    <image style="width: 49%;" src="https://user-images.githubusercontent.com/32838371/195136555-73ce167e-114b-45c5-a6f2-11d65724174f.png" />
    <image style="width: 49%;" src="https://user-images.githubusercontent.com/32838371/195137729-485080ad-5f69-4a8b-859d-ac8bf0245c06.jpeg" />
    <image style="width: 49%;" src="https://user-images.githubusercontent.com/32838371/141163201-b37de67f-91f2-4333-840e-b888ae1d505e.jpeg" />
    <image style="width: 49%;" src="https://user-images.githubusercontent.com/32838371/195313142-b0cc7ba1-0738-47f9-8864-2dba231fdf6c.png" />
    <image style="width: 49%;" src="https://user-images.githubusercontent.com/32838371/195313304-4cd9a30a-9ea9-4f57-8c65-c4c390819c97.png" />
</div>
	
### Build from source

#### Install pre-requisites

- Visual Studio 2022 / Visual Studio Code
- .NET 8.0 SDK
- Libman (VS Extension)
- Bundler & Minifier (VS Extension)
- Mysql
- Docker（WSL2 is recommended）

> If you use Visual Studio (Not Visual Studio Code), you don't need to install Libman CLI and Entity Framework CLI.

Install Libman CLI：

```shell
dotnet tool install -g Microsoft.Web.LibraryManager.Cli
```

Install Entity Framework Core CLI

```shell
dotnet tool install -g dotnet-ef
```

Clone source code

```shell
git clone https://github.com/lixinyang123/CoreHome.git
```

Configuration 

You can refer to [this](https://www.lllxy.net/Blog/Detail/b73acc42-ec42-4151-b108-a680bd1e0c87) blog to configure.

- CoreHome
	- CoreHome.HomePage
		- appsettings.json
		- wwwroot/SiteMap.txt
		- wwwroot/favicon.ico
	- CoreHome.Admin
		- appsettings.json
		- wwwroot/favicon.ico
	- CoreHome.ReverseProxy
		- appsettings.json

> The content of appsettings.json in `CoreHome.HomePage` and `CoreHome.Admin` is exactly the same, just copy and paste.

#### Configure database:

Both CoreHome.HomePage and CoreHome.Admin's `application.json` files should be configured.

```
  "CoreHome": "server=[host];user id=[user];password=[password];database=corehome"
```
	
#### Dependencies

- Visual Studio
	- Backend：Click Restore Nuget Packages in Solution Explorer.
		- CoreHome.Infrastructure
		- CoreHome.Data
		- CoreHome.HomePage
		- CoreHome.Admin
		- CoreHome.ReverseProxy
	- Frontend：Click Restore Client Libraries in Solution Explorer.
		- CoreHome.HomePage/libman.json
		- CoreHome.Admin/libman.json

- Visual Studio Code or CLI
	- Backend：Execute `dotnet restore` in the following directory.
		- CoreHome.HomePage
		- CoreHome.Admin
	- Frontend：Execute `libman restore` in the following directory.
		- CoreHome.HomePage
		- CoreHome.Admin

#### Migrate Database

- Visual Studio

Tools \-\> Nuget Package Manager \-\> Package Manager Console

```shell
Update-Database
```

- Visual Studio Code or CLI

Execute the following commands in the `CoreHome.HomePage` and `CoreHome.Admin` directory.

```shell
dotnet-ef database update -p ..\CoreHome.Data
```

#### Startup

- Visual Studio or Visual Studio Code

Click `Startup` in Solution Explorer or `Ctrl+F5`.

- CLI 

Execute the following commands in the `CoreHome.HomePage` and `CoreHome.Admin` directory.

```shell
dotnet run
```

#### Build Dockerfile

- Visual Studio

Click `Build Dockerfile` in Solution Explorer.

- Visual Studio Code or CLI

Execute the following command in the project root directory.

```shell
docker build --file ./CoreHome.Admin/Dockerfile --tag lixinyang/corehome-admin:latest .
docker build --file ./CoreHome.HomePage/Dockerfile --tag lixinyang/corehome-homepage:latest .
docker build --file ./CoreHome.ReverseProxy/Dockerfile --tag lixinyang/corehome-reverseproxy:latest .
```

### Deploy

You can use `DockerHome` to deploy CoreHome, or you can deploy it manually.

[![ReadMe Card](https://github-readme-stats.vercel.app/api/pin/?username=lixinyang123&repo=DockerHome)](https://github.com/lixinyang123/DockerHome)

> You can refer to [this](https://www.lllxy.net/Blog/Detail/b73acc42-ec42-4151-b108-a680bd1e0c87) blog to use DockerHome.