blazordevlab/cleanarchitectureblazorserver

Clean Architecture With Blazor Server

镜像概述和主要用途

本镜像基于Clean Architecture原则构建Blazor Server应用，具备复杂用户界面和高效代码生成器，支持多种数据库和身份验证方式，旨在帮助开发者快速创建基于.NET Blazor技术的Web应用。

核心功能和特性

• Clean Architecture设计：遵循分层架构原则，确保代码可维护性和可扩展性
• 丰富UI界面：提供现代化、直观的用户界面
• 高效代码生成：内置代码生成工具，加速开发流程
• 多数据库支持：兼容PostgreSQL、Microsoft SQL Server和SQLite
• 多身份验证集成：支持Microsoft、Google、***等第三方登录
• Docker化部署：提供完整的Docker配置，支持开发和生产环境部署

使用场景和适用范围

适用于需要快速开发企业级Web应用的团队，特别是需要遵循Clean Architecture设计模式、要求多数据库支持或第三方身份验证集成的项目。可用于内部管理系统、数据仪表盘、业务应用等场景。

详细使用方法和配置说明

开发环境要求

• Microsoft Visual Studio Community 2022（64位）
• Docker
• .NET 8.0
• 单元测试工具

在线演示

可通过以下链接体验应用功能：

• architecture.blazorserver.com
• architecture.blazors.app

Docker部署

拉取镜像

bash
docker pull blazordevlab/cleanarchitectureblazorserver:latest

运行容器

开发模式（内存数据库）：

bash
docker run -p 8443:443 -e UseInMemoryDatabase=true -e ASPNETCORE_ENVIRONMENT=Development -e ASPNETCORE_HTTPS_PORTS=443 blazordevlab/cleanarchitectureblazorserver:latest

生产模式（持久化数据库和SMTP配置）：

bash
docker run -d -p 8443:443 \
-e UseInMemoryDatabase=false \
-e ASPNETCORE_ENVIRONMENT=Development \
-e ASPNETCORE_HTTP_PORTS=80 \
-e ASPNETCORE_HTTPS_PORTS=443 \
-e DatabaseSettings__DBProvider=mssql \
-e DatabaseSettings__ConnectionString="Server=127.0.0.1;Database=BlazorDashboardDb;User Id=sa;Password=<YourPassword>;MultipleActiveResultSets=true;Encrypt=false;TrustServerCertificate=false" \
-e SmtpClientOptions__User=<YourSMTPUser> \
-e SmtpClientOptions__Port=25 \
-e SmtpClientOptions__Server=<YourSMTPServer> \
-e SmtpClientOptions__Password=<YourSMTPPassword> \
-e Authentication__Microsoft__ClientId=<YourMicrosoftClientId> \
-e Authentication__Microsoft__ClientSecret=<YourMicrosoftClientSecret> \
-e Authentication__Google__ClientId=<YourGoogleClientId> \
-e Authentication__Google__ClientSecret=<YourGoogleClientSecret> \
-e Authentication__Facebook__AppId=<YourFacebookAppId> \
-e Authentication__Facebook__AppSecret=<YourFacebookAppSecret> \
blazordevlab/cleanarchitectureblazorserver:latest

替换<Your...>占位符为实际配置值

Docker Compose配置

创建docker-compose.yml文件进行更便捷的管理：

yaml
version: '3.8'
services:
  blazorserverapp:
    image: blazordevlab/cleanarchitectureblazorserver:latest
    environment:
      - UseInMemoryDatabase=false
      - ASPNETCORE_ENVIRONMENT=Development
      - ASPNETCORE_URLS=http://+:80;https://+:443
      - ASPNETCORE_HTTP_PORTS=80
      - ASPNETCORE_HTTPS_PORTS=443
      - DatabaseSettings__DBProvider=mssql
      - DatabaseSettings__ConnectionString=Server=sqlserver;Database=BlazorDashboardDb;User Id=sa;Password=YourStrongPassword!;MultipleActiveResultSets=true;Encrypt=false;TrustServerCertificate=false
      - SmtpClientOptions__User=<YourSMTPUser>
      - SmtpClientOptions__Port=25
      - SmtpClientOptions__Server=<YourSMTPServer>
      - SmtpClientOptions__Password=<YourSMTPPassword>
      - Authentication__Microsoft__ClientId=<YourMicrosoftClientId>
      - Authentication__Microsoft__ClientSecret=<YourMicrosoftClientSecret>
      - Authentication__Google__ClientId=<YourGoogleClientId>
      - Authentication__Google__ClientSecret=<YourGoogleClientSecret>
      - Authentication__Facebook__AppId=<YourFacebookAppId>
      - Authentication__Facebook__AppSecret=<YourFacebookAppSecret>
    ports:
      - "8443:443"
    volumes:
      - files_volume:/app/Files
    depends_on:
      - sqlserver

  sqlserver:
    image: mcr.microsoft.com/mssql/server:2022-latest
    environment:
      - ACCEPT_EULA=Y
      - MSSQL_SA_PASSWORD=YourStrongPassword!
    ports:
      - "1433:1433"
    volumes:
      - sql_volume:/var/opt/mssql

volumes:
  files_volume:
  sql_volume:

files_volume用于持久化存储应用文件，可根据需求调整或扩展卷配置

多身份验证提供商配置

配置第三方身份验证提供商，请参考以下官方文档：

• ***登录
• ***登录
• Google登录
• Microsoft登录
• 其他提供商

支持的数据库

• PostgreSQL（提供商名称: postgresql）
• Microsoft SQL Server（提供商名称: mssql）
• SQLite（提供商名称: sqlite）

选择特定数据库的方法

1. 打开Server.UI项目src目录下的appsettings.json文件
2. 将DBProvider设置为所需的提供商名称（见上述支持的数据库）
3. 将ConnectionString修改为适用于所选数据库提供商的连接字符串

Docker Compose HTTPS部署

1. 创建自签名开发证书：

   bash
   dotnet dev-certs https -ep $env:USERPROFILE\.aspnet\https\CleanArchitecture.Blazor.Server.UI.pfx -p Password@123
   dotnet dev-certs https --trust
   

2. 管理用户密钥以保存密码：

   bash
   dotnet user-secrets init
   dotnet user-secrets -p Server.UI.csproj set "Kestrel:Certificates:Development:Password" "Password@123"