GrandNode部署指南：从本地开发到生产环境的完整流程

【免费下载链接】grandnode Open source, headless, multi-tenant eCommerce platform built with .NET Core, MongoDB, AWS DocumentDB, Azure CosmosDB, Vue.js. 项目地址: https://gitcode.com/gh_mirrors/gr/grandnode

GrandNode是一款开源的无头多租户电子商务平台，基于.NET Core、MongoDB、AWS DocumentDB、Azure CosmosDB和Vue.js构建。本指南将带你完成从本地开发环境搭建到生产环境部署的完整流程，帮助你快速启动自己的电子商务网站。

一、准备工作：环境与工具要求

在开始部署GrandNode之前，请确保你的系统满足以下要求：

• 操作系统：Windows、macOS或Linux
• 运行环境：.NET Core 3.1 SDK
• 数据库：MongoDB 4.0+ 或兼容的文档数据库（如AWS DocumentDB、Azure CosmosDB）
• 容器工具：Docker和Docker Compose（用于容器化部署）
• 版本控制：Git

1.1 获取项目代码

首先，通过Git克隆GrandNode仓库到本地：

git clone https://gitcode.com/gh_mirrors/gr/grandnode
cd grandnode

二、本地开发环境搭建

2.1 配置数据库

GrandNode默认使用MongoDB作为数据库。你可以选择：

• 本地MongoDB：安装并启动MongoDB服务，默认端口27017
• 云数据库：AWS DocumentDB、Azure CosmosDB或其他MongoDB兼容服务

2.2 构建与运行项目

使用.NET Core CLI构建并运行Web项目：

# 还原依赖包
dotnet restore GrandNode.sln

# 构建项目
dotnet build GrandNode.sln -c Release

# 运行Web应用（默认端口5000）
dotnet run --project Grand.Web/Grand.Web.csproj

访问 http://localhost:5000 即可看到GrandNode的默认主题界面：

GrandNode默认主题界面，展示了响应式设计和直观的购物体验

三、Docker容器化部署

3.1 构建Docker镜像

项目中已包含Dockerfile，可直接构建镜像：

# 构建Web应用镜像
docker build -t grandnode-web -f Grand.Web/Dockerfile .

Dockerfile使用官方.NET Core镜像作为基础：

FROM mcr.microsoft.com/dotnet/core/aspnet:3.1-buster-slim AS base
WORKDIR /app
EXPOSE 80

3.2 使用Docker Compose编排服务

项目提供了docker-compose.yml文件，可一键启动所有服务：

docker-compose up -d

docker-compose.yml定义了服务版本和依赖关系：

version: '3.4'
services:
  grandnode.web:
    image: grandnode-web
    ports:
      - "80:80"
    depends_on:
      - mongodb
  mongodb:
    image: mongo:4.4
    ports:
      - "27017:27017"

四、生产环境部署策略

4.1 服务器配置建议

• Web服务器：Nginx或IIS作为反向代理
• 应用服务器：至少2核4GB内存
• 数据库服务器：根据数据量选择合适配置，建议开启副本集确保高可用

4.2 安全配置

• HTTPS：配置SSL证书，修改配置文件强制HTTPS
• 环境变量：敏感信息（如数据库连接字符串）通过环境变量注入
• 防火墙：只开放必要端口（80/443）

4.3 性能优化

• 静态资源：使用CDN加速静态文件（位于Grand.Web/wwwroot/目录）
• 缓存策略：配置Redis缓存提升性能
• 数据库索引：为常用查询字段创建索引

GrandNode Vue主题界面，基于Vue.js构建的现代化前端体验

五、常见问题解决

5.1 数据库连接问题

确保MongoDB服务正常运行，检查连接字符串配置：

// Grand.Web/appsettings.json
"ConnectionStrings": {
  "MongoDB": "mongodb://localhost:27017/grandnode"
}

5.2 端口占用

如果80端口被占用，可修改Dockerfile中的EXPOSE端口或Docker Compose映射：

EXPOSE 8080

5.3 主题切换

GrandNode支持多主题，可在管理后台切换：

1. 登录管理后台（/Admin）
2. 导航到配置 > 外观
3. 选择主题并保存

六、扩展与定制

6.1 安装插件

GrandNode提供丰富的插件生态，可通过以下步骤安装：

1. 下载插件到Plugins目录
2. 在管理后台启用插件
3. 配置插件参数

例如，安装滑块插件后可展示产品横幅：

使用滑块插件展示智能手表产品横幅

6.2 自定义主题

主题文件位于Grand.Web/Themes/目录，可通过修改CSS、JavaScript和视图文件定制外观。

七、总结

通过本指南，你已掌握GrandNode从本地开发到生产环境的完整部署流程。无论是小型电商网站还是大型多租户平台，GrandNode都能提供灵活可靠的解决方案。开始你的电商之旅，体验构建现代电子商务平台的乐趣吧！

如需更多帮助，请参考项目中的Deploying.Readme.txt文件或探索Grand.Web/Areas/Admin目录下的管理功能源码。

【免费下载链接】grandnode Open source, headless, multi-tenant eCommerce platform built with .NET Core, MongoDB, AWS DocumentDB, Azure CosmosDB, Vue.js. 项目地址: https://gitcode.com/gh_mirrors/gr/grandnode