部署 ASP.NET Core 站点到 CentOS：详细步骤与常见问题解答

📚 准备工作

📝 检查系统要求

确保你的 CentOS 版本支持 .NET Core 运行时。建议使用 CentOS 7 或更高版本，因为它们提供了更好的兼容性和安全性。

📄 更新系统包

在开始之前，请确保你的系统是最新的。这可以通过运行以下命令来完成：

sudo yum update -y

🛠️ 安装 .NET Core SDK 和运行时

🖥️ 方法一：使用官方脚本安装

📊 执行安装脚本

最简单的方法是使用 Microsoft 提供的安装脚本来自动完成所有必要的步骤。只需运行下面的命令即可：

sudo rpm -Uvh https://packages.microsoft.com/config/centos/7/packages-microsoft-prod.rpm
sudo yum install dotnet-sdk-6.0 -y

📦 方法二：通过 YUM 包管理器手动安装

📝 添加 Microsoft 仓库

对于更细粒度的控制，可以手动添加 Microsoft 的官方仓库并安装特定版本。以下是操作步骤：

1. 导入 GPG 密钥：

   sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc

2. 注册产品仓库：

   sudo sh -c 'echo -e "[packages-microsoft-prod]\nname=packages-microsoft-prod\nbaseurl=https://packages.microsoft.com/yumrepos/microsoft-rhel7.3-prod\nenabled=1\ngpgcheck=1\ngpgkey=https://packages.microsoft.com/keys/microsoft.asc" > /etc/yum.repos.d/dotnetdev.repo'

3. 安装 .NET Core SDK：

   sudo yum install dotnet-sdk-6.0 -y

📂 部署 ASP.NET Core 应用

📝 准备应用程序文件

确保你已经构建了 ASP.NET Core 应用，并将其打包成发布版。你可以使用 Visual Studio 或者命令行工具 dotnet publish 来生成发布输出。

📄 上传应用到服务器

通过 FTP、SCP 或其他传输方式将打包好的应用程序文件上传到 CentOS 服务器上的指定目录，例如 /var/www/myapp。

📊 设置环境变量

为了使应用程序能够在启动时找到所需的配置文件和依赖项，你需要设置一些环境变量。编辑 /etc/environment 文件，添加如下内容：

ASPNETCORE_ENVIRONMENT=Production
DOTNET_ROOT=/usr/share/dotnet

📄 启动应用程序

进入应用程序目录并执行以下命令启动应用程序：

cd /var/www/myapp
dotnet MyApplication.dll

为了保证应用程序能够在后台持续运行，推荐使用 Systemd 创建服务单元文件来管理进程。

🔍 常见问题及解决方案

📄 问题 1：无法找到 .NET Core SDK

• Q: 在尝试安装或运行 .NET Core 应用时提示找不到 SDK。
• A: 可能是因为仓库配置不正确或者安装过程中出现问题。
• 解决方案：
  • 检查是否正确添加了 Microsoft 仓库。
  • 尝试重新安装 .NET Core SDK，确保所有步骤都成功完成。

📊 问题 2：应用程序无法启动

• Q: 使用 dotnet 命令启动应用程序后没有任何响应。
• A: 这可能是由于缺少依赖库或权限不足导致的。
• 解决方案：
  • 确认应用程序所需的所有依赖项均已安装。
  • 检查文件夹和文件的权限设置，确保当前用户有足够的访问权限。

📄 问题 3：端口被占用

• Q: 当尝试绑定 HTTP 端口时，收到端口已被占用的错误信息。
• A: 其他服务可能正在使用相同的端口。
• 解决方案：
  • 使用 netstat -tuln | grep :<port> 查看哪个进程占用了该端口。
  • 更改应用程序监听的端口号，避免冲突。

📊 问题 4：防火墙阻止外部访问

• Q: 从外部网络无法访问部署的应用程序。
• A: 防火墙规则可能阻止了入站流量。
• 解决方案：
  • 使用 firewall-cmd --zone=public --add-port=<port>/tcp --permanent 命令允许特定端口通过防火墙。
  • 刷新防火墙规则以使更改生效：firewall-cmd --reload

📄 问题 5：如何实现自动重启？

• Q: 应用程序崩溃后不会自动重启，怎样才能让它保持在线？
• A: 使用 Systemd 创建服务单元文件来管理应用程序进程。
• 解决方案：
  • 编写一个简单的 .service 文件，放置于 /etc/systemd/system/ 目录下。例如，创建名为 myapp.service 的文件，内容如下：

[Unit]
Description=My ASP.NET Core Web Application

[Service]
WorkingDirectory=/var/www/myapp
ExecStart=/usr/bin/dotnet /var/www/myapp/MyApplication.dll
Restart=always
RestartSec=10
SyslogIdentifier=myapp
User=apache
Environment=ASPNETCORE_ENVIRONMENT=Production

[Install]
WantedBy=multi-user.target

• 启用并启动服务：

sudo systemctl enable myapp.service
sudo systemctl start myapp.service

📈 总结

通过本文的详细介绍，你应该掌握了如何将 ASP.NET Core 应用部署到 CentOS 的方法，并解决了常见问题。合理利用这些技巧不仅可以提高部署效率，还能增强系统的稳定性和可靠性。希望这篇教程对你有所帮助！🚀✨

---

这篇教程旨在提供实用的信息，帮助读者更好地理解和应用所学知识。如果你有任何疑问或者需要进一步的帮助，请随时留言讨论。😊

请注意，具体的操作步骤可能会因 CentOS 版本更新而有所变化。建议在实际操作前查阅最新的官方文档和技术支持资源。