Umbraco建站教程：.NET平台开源企业级CMS安装配置指南

Umbraco是一款基于.NET平台开发的开源企业级内容管理系统，以MIT协议开源，完全免费商用。Umbraco诞生于2000年，是全球最流行的.NET CMS，以灵活的内容建模、优雅的编辑界面、强大的扩展性著称。Umbraco采用C#和ASP.NET Core开发，支持自定义内容类型、多语言、多站点、表单、会员系统，适合搭建企业官网、媒体网站、电商平台、政府门户、大型内容平台。

核心优势：基于.NET平台（企业级性能和稳定性）、灵活的内容建模、优雅直观的编辑界面、强大的模板引擎（Razor）、丰富的插件生态、多语言多站点支持、内置表单生成器、会员系统、完全免费商用、微软技术栈集成。Umbraco是.NET开发者和企业用户首选的CMS。

环境要求

• 操作系统：Windows Server 2019+ / Linux（Ubuntu 20.04+/Debian 11+）/ macOS

\\li>.NET版本：.NET 8.0（Umbraco 13推荐.NET 8）

• 数据库：SQL Server 2019+ / Azure SQL / SQLite（开发环境）
• 内存：最低1GB，推荐2GB以上（企业站点建议4GB+）
• 磁盘：至少1GB可用空间
• Web服务器：IIS（Windows）/ Nginx + Kestrel（Linux）
• 开发工具：Visual Studio 2022 / VS Code + .NET SDK

安装教程

方式一：使用Umbraco模板创建项目（推荐开发者）

步骤1：安装.NET SDK

Windows：从微软官网（https://dotnet.microsoft.com）下载.NET 8.0 SDK安装。

Linux（Ubuntu）：

wget https://dot.net/v1/dotnet-install.sh
chmod +x dotnet-install.sh
./dotnet-install.sh --channel 8.0
export PATH="$PATH:$HOME/.dotnet"
dotnet --version

步骤2：安装Umbraco模板

dotnet new install Umbraco.Templates

步骤3：创建Umbraco项目

dotnet new umbraco -n MyUmbracoSite
cd MyUmbracoSite

步骤4：运行项目

dotnet run

Umbraco默认运行在 https://localhost:44337，首次访问会进入安装向导。

方式二：手动安装（Windows + IIS + SQL Server）

步骤1：安装IIS和.NET Hosting Bundle

# Windows Server 以管理员身份运行PowerShell
Install-WindowsFeature -Name Web-Server -IncludeManagementTools
# 下载安装 .NET 8.0 Hosting Bundle
# https://dotnet.microsoft.com/download/dotnet/8.0

步骤2：安装SQL Server

下载安装SQL Server 2022 Express（免费）或Developer版，启用SQL Server身份验证模式，创建数据库和登录用户。

步骤3：下载Umbraco发布包

从Umbraco官网（https://umbraco.com/download）下载最新版本，解压到网站目录（如C:\\inetpub\\wwwroot\umbraco）。

步骤4：配置IIS站点

1. 打开IIS管理器，右键”网站” → “添加网站”
2. 填写网站名称、物理路径（C:\\inetpub\\wwwroot\umbraco）、端口
3. 应用程序池选择”无托管代码”（.NET Core模式）
4. 设置目录权限，授予IIS_IUSRS用户完全控制权限

步骤5：运行安装向导

浏览器访问站点地址，进入Umbraco安装向导：

1. 填写管理员姓名、邮箱、密码
2. 选择数据库类型（SQL Server）
3. 填写数据库连接信息（服务器名、数据库名、用户名、密码）
4. 点击”安装”，等待安装完成

步骤6：登录后台

访问 http://yourdomain.com/umbraco 登录Umbraco管理后台。Umbraco后台功能包括：内容管理（内容树）、媒体管理、文档类型（内容建模）、模板管理、部分视图、宏、表单、会员管理、用户权限、设置等。

Linux环境部署（Nginx + Kestrel）

1. 安装.NET 8.0 SDK和运行时
2. 安装Nginx
3. 使用dotnet new umbraco创建项目，dotnet publish发布
4. 将发布文件复制到/var/www/umbraco
5. 创建systemd服务管理Kestrel进程
6. 配置Nginx反向代理到Kestrel（默认5000端口）
7. 配置SQL Server或SQLite数据库
8. 浏览器访问域名运行安装向导

宝塔面板安装

1. 安装宝塔面板（Linux版），登录后安装Nginx
2. 在终端安装.NET 8.0 SDK：wget https://dot.net/v1/dotnet-install.sh && chmod +x dotnet-install.sh && ./dotnet-install.sh --channel 8.0
3. 创建项目：dotnet new install Umbraco.Templates && dotnet new umbraco -n umbraco
4. 发布项目：dotnet publish -c Release -o /www/wwwroot/yourdomain.com
5. 创建systemd服务管理Kestrel进程
6. 在宝塔面板添加站点，配置Nginx反向代理到5000端口
7. 配置SQLite数据库（简单）或安装SQL Server
8. 访问域名运行安装向导

服务器配置建议

• 内存：建议2GB以上，Umbraco + SQL Server运行需要约1GB
• .NET：使用.NET 8.0 LTS版本
• 数据库：生产环境推荐SQL Server 2022，配置内存和并行度
• Windows环境：使用IIS + Application Request Routing，配置应用池回收
• Linux环境：使用Nginx + Kestrel，配置systemd管理进程
• 启用响应压缩（Response Compression）
• 配置CDN加速静态资源和媒体文件
• 定期备份SQL Server数据库和media目录
• 生产环境设置ASPNETCORE_ENVIRONMENT=Production
• 关注Umbraco官方安全更新，及时升级

常见问题

Q：安装时提示”无法连接数据库”？
A：确认SQL Server服务运行，检查连接字符串中的服务器名、数据库名、用户名、密码，确认SQL Server启用了TCP/IP协议和SQL Server身份验证。

Q：IIS部署后500错误？
A：确认已安装.NET Hosting Bundle，确认应用程序池设置为”无托管代码”，检查web.config配置，查看Windows事件查看器中的错误日志。

Q：后台页面加载慢？
A：首次加载较慢属于正常（编译Razor视图），后续访问会加快。生产环境使用发布模式（Release），启用响应压缩和缓存。

Q：忘记管理员密码？
A：在数据库中修改umbracoUser表的userPassword字段（使用Umbraco的密码哈希格式），或使用Umbraco的密码重置功能（需配置SMTP邮件）。

官方网址

Umbraco官网地址：https://umbraco.com