免费开源WMS：ModernWMS仓库管理系统5分钟快速上手指南

【免费下载链接】ModernWMSThe open source simple and complete warehouse management system is derived from our many years of experience in implementing erp projects. We stripped the original commercial system wms function and opened it up for free, hoping to help the majority of small and medium-sized enterprises. At present, the system supports cross-platform。项目地址: https://gitcode.com/GitHub_Trending/mo/ModernWMS

ModernWMS 是一款免费且完整的开源仓库管理系统（WMS），从商业 ERP 项目中剥离出仓储核心链路，覆盖收货、库存、发货三个主流程，面向想用低成本方式管好仓库的中小企业。你本地跑起来它只需要 5 分钟。

它解决了什么问题

中小仓库常用 Excel 或纸质单据记库存，账实对不上、操作无留痕是常态。ModernWMS 把收货、库存、发货三条主流程搬进系统，每一步都生成单据可追溯。

• 许可证：Apache-2.0，可自由使用与修改
• 后端：.NET 7.0 + EF Core（三个项目均为 net7.0）
• 前端：Vue 3 + TypeScript + Vuetify 3 + VXETable + Vite
• 数据库：SQLite、MySQL 8、SQL Server、PostgreSQL 可切换
• 部署：跨平台运行，另附 Docker 一键启动脚本

🚀 五分钟跑起来

环境要求：.NET SDK 7.0+，Node.js 16.13.1+（含 yarn）。克隆仓库后前后端分别启动：

git clone https://gitcode.com/GitHub_Trending/mo/ModernWMS cd backend && dotnet run cd frontend && yarn && yarn dev

启动后浏览器打开终端提示的前端地址，用初始账号 admin、密码 1 登录。进入首页后左侧是"首页、基础设置、收货管理、库存管理、仓内作业、发货管理"六组菜单；后端默认打开 Swagger 页面，接口可以直接调试。

🔍 真实场景走一遍

创建并处理一张到货通知单

目标：把供应商的货登记进系统。

1. 进入收货管理 → 到货通知，点 + 新建通知单，填写到货通知书编号、SKU、数量、供应商；
2. 货到仓库后，在待卸货页签做卸货确认，核对商品与数量；
3. 待分拣页签为每个品项安排货位；
4. 待上架页签完成上架确认。

单据按"到货通知 → 待卸货 → 待分拣 → 待上架"五个页签推进，跳步操作会被系统拦截。

查询库存并做一次库存调整

目标：查清货在哪、还有多少，变更数量必留痕。

1. 进入库存管理，按仓库、货位、货主等维度筛选，各货位现存量实时可见；
2. 账实不符时，在仓内作业 → 库存调整新建调整单；
3. 冻结、移动、加工同走单据流程。

任何一次操作都能从单据回溯到人、时间和数量。

发货单从新建推进到签收

目标：让每笔订单的状态全程可追踪。

1. 进入发货管理，在 NEW SHIPMENT 页签新建发货单；
2. 单据沿页签推进：待拣货 → 已拣货 → 待打包 → 已打包 → 待称重 → 已称重 → 待发货 → 已发货；
3. 每步有独立操作页，支持批量确认、打印标签与二维码。

发货确认后库存自动扣减，取消订单则回滚占用。

库存盘点校准账实差异

目标：用实盘数量校准账面。

1. 仓内作业 → 库存盘点，发起盘点单；
2. 录入各 SKU 实盘数量；
3. 确认盘点单。

确认后系统按盘点结果校准账面库存。

🧩 自定义与扩展

改配置基本是"找到文件、改值、刷新"：

• 菜单权限：角色菜单绑定实体在 backend/ModernWMS.WMS/Entities/Models/Rolemenu/，接口实现在 backend/ModernWMS.WMS/Services/Rolemenu/，页面勾选即生效；
• 审批流程：流程条件在 FlowSetService.cs，前端可视化节点编辑在 frontend/src/components/flow/；
• 国际化：前端语言文件在 frontend/src/languages/langsJson/，现有 cn.json、en.json、tw.json，新增一门语言照格式新建 json 即可；
• 新增业务模块：按"Controller + Entity + ViewModel + IService + Service"五件套扩展，参照 backend/ModernWMS.WMS/Services/ 下任一现有模块；
• 生产部署：docker/ 下含 Dockerfile、nginx.conf、run.sh。

常见坑 FAQ

Q：默认数据库能换吗？

可以。修改 appsettings.json 中 Database.db 字段为 Sqlite / MySql / SqlServer / Postgres，四套连接字符串已预置在同文件。想用仓库自带的初始数据文件 wms.db，把它设为 Sqlite。

Q：初始登录账号密码是什么？

admin，密码 1。登录后在"基础设置 → 用户管理"里维护正式账号。

Q：生产部署时前端指向哪个后端地址？

改 frontend/.env.production 里的 VITE_BASE_PATH，后端默认监听 20011 端口，部署文档见 README.zh_CN.md。

Q：没有 .NET 环境怎么部署？

用 docker/Dockerfile 与 docker/run.sh 打包容器启动，宿主机只需 Docker。

先跑起来，再谈下一步

仓库地址：https://gitcode.com/GitHub_Trending/mo/ModernWMS。建议先按上文把登录页跑通，再顺收货、发货两条链路各走一遍。跑起来之后，二次开发的入口就在 Services 目录里。

【免费下载链接】ModernWMSThe open source simple and complete warehouse management system is derived from our many years of experience in implementing erp projects. We stripped the original commercial system wms function and opened it up for free, hoping to help the majority of small and medium-sized enterprises. At present, the system supports cross-platform。项目地址: https://gitcode.com/GitHub_Trending/mo/ModernWMS