零成本部署开源仓库管理系统 ModernWMS 中小企业适用指南

在数字化时代，中小企业也需要高效的仓库管理系统来提升运营效率，但高昂的商业软件成本往往让人却步。ModernWMS 作为一款开源仓库管理系统，不仅完全免费，还支持跨平台部署，能够帮助中小企业轻松实现仓库管理的数字化转型。本指南将带你从零开始，一步步完成 ModernWMS 的部署与使用，让你的仓库管理变得简单高效。

价值主张：为什么选择 ModernWMS

ModernWMS 源自多年 ERP 项目实施经验，专为中小企业量身打造。它就像一个贴心的仓库管家，能够帮你处理收货、库存、发货等一系列仓库管理事务。与其他仓库管理系统相比，ModernWMS 具有以下独特优势：

• 完全免费：开源项目，无任何使用费用，为中小企业节省成本。
• 功能完整：覆盖仓库管理全流程，从收货到发货，一应俱全。
• 技术先进：基于 .NET 7 和 Vue 3 构建，性能稳定，界面友好。
• 跨平台支持：无论是 Linux 还是 Windows 系统，都能轻松部署使用。

环境清单：软硬件最低配置要求

在部署 ModernWMS 之前，我们需要确保你的电脑或服务器满足以下最低配置要求，就像盖房子需要打好地基一样，合适的环境是系统稳定运行的基础。

硬件配置

硬件类型	最低配置	推荐配置
处理器	双核 CPU	四核 CPU
内存	4GB RAM	8GB RAM
硬盘	50GB 可用空间	100GB 可用空间
网络	稳定的网络连接	稳定的网络连接

软件环境

软件名称	版本要求
操作系统	Linux（Ubuntu 18.04/20.04/22.04、CentOS Stream 8/9 等）或 Windows 10/11、Windows Server 2012+
.NET SDK	7.0
NodeJS	16.13.1
Yarn	最新版本
Docker（可选）	最新版本
Nginx（可选）	最新版本

部署方案：3 种方式任你选

部署 ModernWMS 就像选择不同的交通方式去目的地，每种方式都有其特点，你可以根据自己的实际情况选择最适合的一种。

部署难度对比矩阵

部署方式	难度	耗时	适合人群
源码编译部署	中等	30-60 分钟	有一定技术基础的用户
Docker 快速部署	简单	10-15 分钟	所有用户，尤其是技术小白
Windows 环境部署	中等	20-40 分钟	Windows 系统用户

方式一：Docker 快速部署（推荐技术小白）

Docker 就像一个集装箱，把 ModernWMS 及其所需的环境都打包在一起，让部署变得非常简单。

1. 安装 Docker 如果你还没有安装 Docker，可以根据你的操作系统到 Docker 官网下载并安装。

2. 拉取镜像并运行 打开终端或命令提示符，输入以下命令：

   docker pull modernwms/modernwms:1.0  # 从 Docker Hub 拉取 ModernWMS 镜像
   docker run -d -p 20011:20011 -p 80:80 modernwms/modernwms:1.0  # 运行容器，将容器的 20011 和 80 端口映射到主机
   

   💡 提示：-d 表示后台运行容器，-p 用于端口映射，左边是主机端口，右边是容器端口。

3. 访问系统 打开浏览器，输入 http://localhost 或 http://你的服务器IP，即可访问 ModernWMS 系统。

方式二：源码编译部署（Linux）

如果你喜欢自己动手，体验从源码到运行的全过程，那么源码编译部署适合你。

1. 下载源码

   cd /tmp/ && wget https://gitcode.com/GitHub_Trending/mo/ModernWMS/archive/master.zip  # 下载源码压缩包到 tmp 目录
   unzip master.zip  # 解压压缩包
   cd ModernWMS-master  # 进入源码目录
   

2. 安装运行环境 安装 .NET SDK 7.0、NodeJS 16.13.1 和 Yarn 包管理器。你可以通过各自的官方网站获取安装方法。

3. 编译前后端

   # 编译前端
   cd frontend/ && yarn  # 安装前端依赖
   yarn build  # 构建前端项目，生成静态文件
   
   # 编译后端
   cd ../backend/ && dotnet publish  # 发布后端项目
   

4. 配置 Nginx 将编译好的前端静态文件复制到 Nginx 的网站根目录，然后配置 Nginx 反向代理后端服务。 📌 注意：Nginx 配置文件的具体内容可以参考 ModernWMS 项目中的相关文档或示例。

5. 启动服务 启动 Nginx 服务和后端服务，然后通过浏览器访问。

方式三：Windows 环境部署

Windows 用户可以通过 PowerShell 完成部署步骤。

1. 下载源码 在浏览器中访问 https://gitcode.com/GitHub_Trending/mo/ModernWMS，下载源码压缩包并解压。

2. 安装运行环境 安装 .NET SDK 7.0、NodeJS 16.13.1 和 Yarn 包管理器，按照官方指引进行安装。

3. 编译前后端 打开 PowerShell，进入源码目录，分别编译前端和后端：

   # 编译前端
   cd frontend
   yarn
   yarn build
   
   # 编译后端
   cd ../backend
   dotnet publish
   

4. 运行服务 后端可以通过 dotnet ModernWMS.dll 命令运行，前端可以部署到 IIS 或其他 Web 服务器。

功能导览：场景化使用流程图

ModernWMS 提供了丰富的功能模块，下面通过场景化的流程图来了解各个模块的使用流程。

收货管理模块

收货管理就像给仓库进货，流程如下：

1. 收到到货通知（对应界面中的“到货通知”标签）。
2. 进行到货确认，核对商品信息（“待到货”标签）。
3. 卸货并确认（“待卸货”标签）。
4. 上架存储（“待上架”标签）。
5. 查看收货明细（“收货明细”标签）。

发货管理模块

发货管理如同给客户发货，步骤如下：

1. 创建发货单（“NEW SHIPMENT”标签）。
2. 拣货准备（“GOODS TO BE PICKED”标签）。
3. 拣货完成（“PICKED”标签）。
4. 包装确认（“TO BE PACKAGED”、“PACKAGED”标签）。
5. 称重管理（“TO BE WEIGHED”、“WEIGHED”标签）。
6. 发货完成（后续标签）。

使用指南：从登录到日常操作

登录系统

部署完成后，打开浏览器访问系统，使用默认账号：admin，默认密码：1 进行登录。登录后建议及时修改密码，保障系统安全。

日常操作示例：添加商品

1. 登录系统后，点击左侧菜单中的“基础设置”→“商品管理”。
2. 点击“+”按钮，填写商品信息，如商品编码、名称、规格等。
3. 点击“保存”按钮，完成商品添加。

你可能需要→添加新商品到系统中进行管理→操作路径：基础设置→商品管理→添加商品。

问题解决：常见问题“症状-病因-药方”

在使用 ModernWMS 的过程中，可能会遇到一些问题，下面为你提供常见问题的解决方法。

症状	病因	药方
无法访问系统	端口冲突	检查 20011 和 80 端口是否被占用，关闭占用端口的程序或修改 ModernWMS 的端口配置。
数据库连接失败	数据库配置错误或 SQLite 数据库文件权限问题	检查后端配置文件中的数据库连接字符串，确保路径正确；对于 SQLite 数据库文件，确保应用程序有读写权限。
功能操作无响应	网络问题或系统 bug	检查网络连接是否正常；如果是系统 bug，可以到项目的 Gitcode 仓库提交 issue 反馈。

技术栈积木图

ModernWMS 采用前后端分离架构，就像用不同的积木搭建房子一样，各部分协同工作。

• 后端：基于 .NET 7 的 Web API，提供数据处理和业务逻辑支持。
• 前端：Vue 3 + Vuetify + TypeScript，构建美观且交互友好的用户界面。
• 数据库：默认使用 SQLite，也支持 MySQL、PostgreSQL、SQL Server 等多种数据库。

部署进度检查清单

• [ ] 环境准备完成（硬件和软件满足要求）
• [ ] 选择并完成部署方式（Docker/源码编译/Windows 部署）
• [ ] 成功访问系统并登录
• [ ] 熟悉系统主要功能模块
• [ ] 完成至少一项日常操作（如添加商品、创建收货单等）
• [ ] 了解常见问题解决方法

通过本指南，相信你已经对 ModernWMS 的部署和使用有了全面的了解。现在，就开始你的仓库数字化管理之旅吧！