Ubuntu布署Blazor Server

《1》Ubuntu中配置.NET Core

1.1 在ubuntu.24.04-x64系统中安装安装 ASP.NET Core运行时

1. 安装基础工具​​	sudo apt install -y software-properties-common	确保系统拥有 add-apt-repository命令，用于添加软件源   。
​​2. 添加 Backports 源​​	sudo add-apt-repository ppa:dotnet/backports	添加包含 .NET 9 的官方后移植软件源。
​​3. 更新软件列表​​	sudo apt update	刷新软件包列表，使新添加的源中的包信息生效。
​​4. 安装运行时​​	sudo apt install -y aspnetcore-runtime-9.0	安装 ASP.NET Core运行时（推荐，它包含了基础的 .NET 运行时）。如果你想安装完整的 SDK 进行开发，可以使用 sudo apt install -y dotnet-sdk-9.0。

验证安装是否成功

dotnet --info

如下图所示是安装成功

1.2 把Blazor server发布成Linux-64运行程序，使用WinSCP把发布的程序传送到Ubuntu中，并且修改程序目录的权限

sudo chmod 777 /path/to/your/target_directory

文件传送结束后把当前目录修改成755权限

1.3：进入程序当前的目录执行如下命令

dotnet EnergyConsumCollection.Server.dll

这样网站就可以在本地访问，如下图所示

《2》Nginx代理配置

2.1 安装Nginx

# 安装Nginx
sudo apt install -y nginx

# 启动并设置开机自启
sudo systemctl start nginx
sudo systemctl enable nginx

# 检查状态
sudo systemctl status nginx

2.2 基础防火墙配置

# 启用防火墙（如果使用ufw）
sudo ufw enable
sudo ufw allow 'Nginx Full'
sudo ufw allow ssh
sudo ufw status

2.3 Nginx反向代理配置

创建Nginx站点配置文件

sudo nano /etc/nginx/sites-available/blazor-app

基础配置内容

server {
    listen 80;
    server_name your-domain.com;  # 替换为您的域名或服务器IP
    client_max_body_size 100M;    # 根据需要调整上传文件大小限制

    # 静态文件优化
    location ~* \.(css|js|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot)$ {
        expires 1y;
        add_header Cache-Control "public, immutable";
        proxy_pass http://localhost:5000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection keep-alive;
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }

    # Blazor Server应用代理
    location / {
        proxy_pass http://localhost:5000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_cache_bypass $http_upgrade;
        
        # Blazor Server特定优化
        proxy_connect_timeout 60s;
        proxy_send_timeout 60s;
        proxy_read_timeout 60s;  # 重要：Blazor需要长连接
        
        # 缓冲区设置
        proxy_buffering off;
        proxy_request_buffering off;
    }

    # 健康检查端点（如果应用有健康检查）
    location /health {
        proxy_pass http://localhost:5000/health;
        access_log off;
    }
}

2.4 启用站点配置

# 创建符号链接
sudo ln -s /etc/nginx/sites-available/blazor-app /etc/nginx/sites-enabled/

# 测试配置语法
sudo nginx -t

# 重新加载Nginx
sudo systemctl reload nginx

2.5 创建systemd服务管理Blazor应用

创建服务文件

sudo nano /etc/systemd/system/blazor-app.service

服务配置内容

[Unit]
Description=Blazor Server Application
After=network.target

[Service]
Type=exec
WorkingDirectory=/var/www/blazor-app
ExecStart=/usr/bin/dotnet /var/www/blazor-app/EnergyConsumCollection.Server.dll
Restart=always
RestartSec=10
KillSignal=SIGINT
TimeoutStopSec=90
SyslogIdentifier=blazor-app
User=www-data
Group=www-data
Environment=ASPNETCORE_ENVIRONMENT=Production
Environment=DOTNET_PRINT_TELEMETRY_MESSAGE=false
Environment=ASPNETCORE_URLS=http://localhost:5000

# 安全设置
NoNewPrivileges=true
PrivateTmp=true
ProtectSystem=strict
ProtectHome=true
ReadWritePaths=/var/www/blazor-app

[Install]
WantedBy=multi-user.target

2.6 启动并启用服务

# 重新加载systemd配置
sudo systemctl daemon-reload

# 启动服务
sudo systemctl start blazor-app.service

# 设置开机自启
sudo systemctl enable blazor-app.service

# 检查服务状态
sudo systemctl status blazor-app.service

# 查看实时日志
sudo journalctl -u blazor-app.service -f

 

《3》异常问题处理

3.1出现 Welcome to nginx! If you see this page, 的解决方法

# 检查启用的站点
sudo ls -la /etc/nginx/sites-enabled/

# 检查默认站点是否还存在
sudo ls -la /etc/nginx/sites-enabled/default

下面是存在默认站点情况

 解决方法禁用默认站点后可以解决

# 删除默认站点的启用链接
sudo rm -f /etc/nginx/sites-enabled/default

# 或者重命名
sudo mv /etc/nginx/sites-enabled/default /etc/nginx/sites-enabled/default.disabled

如下图所示中人有一个配置的代理站点，默认的已经没有了，现在可以远程登陆访问站点了。

 

3.2 Blazor 新版本部署后在Ubuntu本地服务器，局域网中访问出现异常

提示如下：

Seems like the connection with the server has been lost. It can be due to poor or broken network. Please hang on while we're trying to reconnect...
Oh snap! Failed to reconnect with the server. This is typically caused by a longer network outage, or if the server has been taken down. You can try to reconnect, but if that does not work, you need to reload the page.
Oh man! The server rejected the attempt to reconnect. The only option now is to reload the page, but be prepared that it won't work, since this is typically caused by a failure on the server.

 后面清理了浏览器缓存和Cookies，后面访问正常

 

《4》Linux环境下Blazor Server应用升级操作

4.1 :停止当前服务，并且备份对应数据

# 停止当前服务
sudo systemctl stop 你的服务名
# 备份当前应用文件，将源路径用单引号 ' 包裹起来。这会阻止 Shell 过早地解析路径，让 sudo 能够在其环境中正确处理命令
sudo mv '/var/www/blazor-app' /var/www/blazor-app_backup_$(date +%Y%m%d)
# 备份systemd服务配置
sudo cp /etc/systemd/system/你的服务名.service /etc/systemd/system/你的服务名_backup_$(date +%Y%m%d).service

4.2 使用WinSCP把发布的程序传送到Ubuntu中，并且修改程序目录的权限为755

sudo chmod 755 /var/www/target_directory

4.3 参照2.6示例操作，重新启动配置和服务。