3步搭建专业仓库管理系统：ModernWMS中小企业跨平台部署方案

开源仓库管理系统ModernWMS是专为中小企业打造的免费解决方案，源自多年ERP项目实施经验，提供完整的收货管理、库存管理、发货管理和仓内作业功能。本指南将帮助您通过跨平台方案快速部署这套系统，实现仓库管理数字化转型。

一、认识ModernWMS价值

ModernWMS是一套基于.NET 7后端和Vue 3前端技术栈构建的开源仓库管理系统，具有以下核心价值：

功能价值

收货管理模块
提供到货通知管理、收货确认和商品信息核对功能，支持扫码操作和批量处理，确保入库数据准确性。

图1：ModernWMS收货管理界面，显示到货通知列表和操作选项

库存管理模块
实时跟踪库存变动，支持库存冻结、调整和盘点，提供多维度库存查询和预警功能，避免库存积压或短缺。

发货管理模块
完整覆盖发货单创建、拣货管理、包装确认和称重管理流程，支持批次管理和物流跟踪，提升发货效率。

图2：ModernWMS发货管理界面，展示多状态发货单列表

二、部署前准备

部署决策树

请根据您的实际情况选择合适的部署方式：

• 若您熟悉Docker且追求快速部署 → 选择Docker部署
• 若您需要定制化开发或已有.NET环境 → 选择源码编译部署
• 若您使用Windows服务器且偏好图形化操作 → 选择Windows部署

部署矩阵

部署方式	适用环境	技术要求	部署时间
Docker部署	所有支持Docker的Linux/Windows系统	基础Docker知识	10分钟
源码编译部署	Linux系统	.NET SDK、NodeJS、Nginx	30分钟
Windows部署	Windows 10/11或Windows Server	PowerShell、IIS	25分钟

部署预检清单

检查项	要求	状态
硬件配置	CPU≥2核，内存≥4GB，硬盘≥20GB	□已满足 □未满足
网络环境	可访问互联网（用于下载依赖）	□已满足 □未满足
端口可用性	80端口和20011端口未被占用	□已满足 □未满足
权限要求	具有管理员/root权限	□已满足 □未满足

⚠️注意：部署前请确保服务器时间同步，避免因时间偏差导致的认证问题。

三、部署操作步骤

方法一：Docker快速部署（推荐）

Docker部署是最简单高效的方式，适合大多数用户：

1. 安装Docker环境

   # Ubuntu/Debian系统
   sudo apt update && sudo apt install -y docker.io docker-compose
   sudo systemctl start docker && sudo systemctl enable docker
   
   # CentOS/RHEL系统
   sudo yum install -y docker-ce docker-ce-cli containerd.io
   sudo systemctl start docker && sudo systemctl enable docker
   

   💡提示：执行完上述命令后，可通过docker --version验证Docker是否安装成功。

2. 获取源码并构建镜像

   git clone https://gitcode.com/GitHub_Trending/mo/ModernWMS
   cd ModernWMS/docker
   docker build -t modernwms:latest .
   

   输出结果示例：

   Successfully built a1b2c3d4e5f6
   Successfully tagged modernwms:latest
   

3. 启动容器

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

   💡提示：参数说明：

   • -d：后台运行容器
   • -p 80:80：映射Web前端端口
   • -p 20011:20011：映射API服务端口
   • --name modernwms：指定容器名称

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

适合需要定制化开发或已有.NET环境的用户：

1. 安装依赖环境

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

2. 获取源码并编译

   git clone https://gitcode.com/GitHub_Trending/mo/ModernWMS
   cd ModernWMS
   
   # 编译前端
   cd frontend
   yarn install
   yarn build
   
   # 编译后端
   cd ../backend
   dotnet publish -c Release -o ./publish
   

3. 配置Nginx并启动服务

   # 安装Nginx
   sudo apt install -y nginx
   
   # 配置Nginx（此处省略具体配置步骤，需将前端编译文件部署到Nginx根目录）
   
   # 启动后端服务
   cd publish
   nohup dotnet ModernWMS.dll &
   

四、部署验证与系统配置

访问系统

打开浏览器，输入服务器IP地址或域名，即可访问ModernWMS系统：

• 默认账号：admin
• 默认密码：1

首次登录后请立即修改密码，确保系统安全。

图3：ModernWMS系统首页，展示主要功能模块导航

基础配置检查

登录系统后，请完成以下基础配置：

1. 进入"基础设置" → "仓库设置"，添加您的仓库信息
2. 配置商品类别和商品信息
3. 设置用户角色和权限
4. 根据业务需求配置收货和发货流程

⚠️注意：系统默认使用SQLite数据库，适合小型部署。如需使用MySQL或SQL Server，请修改appsettings.json中的数据库连接字符串。

五、常见问题解决

端口冲突问题

若启动时报错"端口已被占用"，可使用以下命令查找占用进程：

# 查找80端口占用情况
sudo lsof -i :80
# 终止占用进程（将PID替换为实际进程ID）
sudo kill -9 PID

服务启动失败

检查日志文件定位问题：

# Docker部署查看日志
docker logs modernwms

# 源码部署查看日志
cat nohup.out

数据库连接问题

确保数据库服务正常运行，连接字符串格式正确：

"ConnectionStrings": {
  "DefaultConnection": "Data Source=wms.db"
}

附录：技术架构说明

ModernWMS采用前后端分离架构：

• 后端：基于.NET 7的Web API，提供RESTful接口
• 前端：Vue 3 + Vuetify + TypeScript，构建响应式界面
• 数据库：默认使用SQLite，支持MySQL、PostgreSQL、SQL Server等关系型数据库
• 部署：支持Docker容器化部署和传统服务器部署

性能优化参数建议

对于中大型仓库，建议调整以下参数提升性能：

• 数据库连接池大小：根据并发量设置为10-50
• 缓存配置：启用Redis缓存减轻数据库压力
• 应用池设置：.NET进程数设置为CPU核心数的1.5倍
• Nginx配置：启用gzip压缩，设置合理的缓存策略

通过以上步骤，您已成功部署ModernWMS仓库管理系统。系统的模块化设计使后续维护和功能扩展变得简单，帮助您的企业实现高效的仓库管理。