如何快速部署开源仓库管理系统ModernWMS：中小企业的完整指南 🚀

ModernWMS是一款源自多年ERP项目实施经验的开源仓库管理系统，专为中小企业打造，支持跨平台运行且完全免费。系统采用.NET SDK和Vue.js技术栈，提供简洁高效的仓储管理解决方案，帮助企业轻松应对库存、入库、出库等核心业务流程。

📋 系统需求与环境准备

支持的操作系统

• Linux：Ubuntu 18.04+/CentOS Stream 8+/Debian 10+
• Windows：Windows 10(1607+)/Windows Server 2012+

核心技术栈

• 后端：.NET 7.0、SQL Server/MySQL/PostgreSQL
• 前端：Vue 3.2、TypeScript 4.1、Vuetify 3.0
• 工具链：Node.js 16.13+、Yarn、Docker（可选）

⚡ 三种快速安装方法

方法1：Linux系统一键部署步骤

1. 获取源码

   git clone https://gitcode.com/gh_mirrors/mo/ModernWMS
   cd ModernWMS
   

2. 安装依赖环境

   # 安装.NET SDK
   wget https://packages.microsoft.com/config/ubuntu/20.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
   sudo dpkg -i packages-microsoft-prod.deb
   sudo apt-get update && sudo apt-get install -y dotnet-sdk-7.0
   
   # 安装Node.js和Yarn
   curl -fsSL https://deb.nodesource.com/setup_16.x | sudo -E bash -
   sudo apt install -y nodejs
   sudo npm install -g yarn
   

3. 编译前后端代码

   # 编译前端
   cd frontend
   yarn && yarn build
   
   # 编译后端
   cd ../backend
   dotnet publish -c Release -o ./publish
   

4. 配置Nginx服务

   sudo apt install nginx
   # 配置文件路径：/etc/nginx/nginx.conf
   sudo systemctl restart nginx
   

方法2：Windows系统图形化安装

1. 下载并安装依赖：

   • .NET 7.0 SDK
   • Node.js 16.x
   • Nginx for Windows

2. 通过Git Bash执行编译命令：

   # 编译前端
   cd frontend
   yarn install
   yarn build
   
   # 编译后端
   cd ../backend
   dotnet publish -c Release -o ./publish
   

3. 将编译结果复制到部署目录：

   • 前端文件：frontend/dist → C:\nginx\html
   • 后端文件：backend/publish → C:\ModernWMS\backend

方法3：Docker容器化部署（推荐）

🐳 容器化部署可避免环境依赖问题，适合新手快速上手

1. 构建镜像

   cd docker
   docker build -t modernwms:latest .
   

2. 启动容器

   docker run -d -p 80:80 -p 20011:20011 --name modernwms modernwms:latest
   

3. 初始化配置

   docker exec -it modernwms /bin/bash
   # 容器内配置文件路径：/app/backend/appsettings.json
   

🖥️ 系统初始化与使用

首次登录

1. 访问地址：http://服务器IP地址
2. 默认账号：admin
3. 默认密码：1

核心功能模块

• 入库管理：backend/ModernWMS.WMS/Controllers/Asn/
• 库存查询：backend/ModernWMS.WMS/Controllers/Stock/
• 出库操作：backend/ModernWMS.WMS/Controllers/Dispatchlist/
• 报表统计：frontend/src/view/statisticAnalysis/

系统界面展示

图1：ModernWMS库存管理主界面，支持多维度筛选与批量操作

图2：入库单创建与审核流程，支持条码扫描录入

图3：库存统计分析报表，支持导出Excel格式

🔧 常见问题解决

数据库连接失败

检查配置文件：backend/ModernWMS/appsettings.json中的连接字符串设置，支持MySQL、SQL Server和PostgreSQL数据库。

前端样式错乱

清除浏览器缓存或重新编译前端资源：

cd frontend
yarn build

端口占用问题

修改后端启动端口：

dotnet ModernWMS.dll --urls http://0.0.0.0:20012

📚 进阶学习资源

• 项目结构解析：

  • 核心框架：backend/ModernWMS.Core/
  • 业务模块：backend/ModernWMS.WMS/
  • 前端组件：frontend/src/components/

• API文档：部署后访问 http://IP地址/swagger 查看接口文档

🎯 为什么选择ModernWMS？

✅ 完全开源免费：基于Apache-2.0协议，无功能限制
✅ 跨平台运行：支持Linux/Windows服务器部署
✅ 轻量化设计：单文件数据库支持，最低1G内存即可运行
✅ 丰富功能：涵盖仓储管理全流程，支持多仓库、多货主管理

提示：系统默认包含演示数据，可通过后台【数据管理】模块清空测试数据后正式使用。