如何用 ModernWMS 这套开源仓库管理系统，把中小企业的仓库存档成本降下来

【免费下载链接】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

月底对账，仓管员把 Excel 里的库存数和系统数摆在一起，对不上的那几行谁也说不清是哪天出的差错。收货、上架、发货全靠手写单，谁在哪个环节经手过，翻记录要花半天。而市面上成体系的仓库管理系统，实施费动辄几十万，预算有限的中小企业往往只能绕着走。ModernWMS 就是冲着这个空隙来的：它是一套开源、功能完整的仓库管理系统，从多年商业 ERP 项目中剥离出 WMS 部分免费放出，适合中小企业和想练手仓储业务的开发者。下面按"跑通系统、拆开核心模块、参与共建"的顺序讲，5 分钟能看完。

项目速览——它到底能帮你做什么

• 收货管理：到货通知、卸货、分拣、上架全流程跟进
• 库存管理：查询、调整、移动、冻结、盘点一套工具
• 发货管理：从下单到签收的订单全流程跟踪
• 基础资料：仓库、库位、货主、供应商、客户、角色权限

ModernWMS 主界面，左侧导航列出收货管理、库存管理、仓内作业、发货管理等全部模块

小贴士：项目采用 Apache 2.0 协议，免费使用、可修改、可商用，适合单仓到多仓的中小企业规模；界面支持中、英、繁切换。

从零跑通——最小可用路径

①环境确认：需要 .NET SDK 7.0+ 和 NodeJS 16.13.1+（Linux 建议 Ubuntu 18.04+，Windows 10 或 Server 2012+ 均可），技术栈是 .NET 7 后端加 Vue 3 前端。

②拉代码，然后把数据库切成本地 SQLite（免装数据库服务）：

git clone https://gitcode.com/GitHub_Trending/mo/ModernWMS

"Database": { "db": "SqlLite" }

这个配置项在 appsettings.json，改成上面这行后启动：

cd backend/ModernWMS && dotnet run

③前端目录frontend/执行yarn装依赖，再yarn dev起开发服务；浏览器打开http://localhost:5173，用初始账号 admin / 密码 1 登录，看到首页即跑通。后端默认监听 5555 端口，自带 Swagger 接口文档。

核心能力拆解

收货管理：一单货的六个阶段

它把收货拆成到货通知、待卸货、待分拣、待上架、待上架、收货明细六个状态，每一单从通知到入位独立流转，卡在哪一步一眼可见。对仓管意味着"这批货卡在哪"不用再口头追问，页面里直接查。

到货通知页签：登记商品编码、货主、供应商、数量、体积，支持按供应商和规格筛选

仓内作业：五种库存动作各归其位

仓库日常变动集中在五个模块：加工、移动、冻结、调整、盘点（见 Stock 服务实现）。货位间挪货走移动单，数量对不上走调整单，临时不动的货走冻结，周期清点走盘点。每个动作都有单据记录，月底盘点差异可以逐单回查。

发货管理：订单生命周期一张表

它按订单阶段分标签页：预发货、新发货、待拣货、已拣货、待打包、已打包、待称重、已称重、待签收、已签收（见 Dispatchlist 服务）。每个订单记录状态、数量、重量、体积、客户和制单人，客服问"那单发出去没有"，按单号一搜就有答案。

发货管理页：从 New Shipment 到 Signed In 的订单状态一目了然，可按单号和状态筛选

基础设置与权限：小团队够用

基础设置里管仓库、库位、货主、供应商、客户；角色设置支持按角色分配账号和菜单，谁能动哪个模块由角色决定。界面内置中、英、繁三语切换，后端支持 SQLite、MySQL、SQL Server、PostgreSQL 四种数据库任选，小团队够用，上规模也不卡。

参与与共建

项目欢迎外部贡献，方向不挑人：

• 提 issue：用中文描述现象，附界面截图
• 提 PR：改 bug 或补功能，前后端都可以动手
• 文档与翻译：完善 README，或往 语言文件 里加新语言
• 界面反馈：表格、表单的交互细节都值得提

分支建议feature/功能名或bugfix/问题描述，提交信息写成[Feature] xxx这类格式，方便 review。

新手可以从标注为 good first issue 的 issue 开始，先跑通最小可用路径再动手。

高频问题

Q: 部署需要哪些环境？A: .NET SDK 7.0+、NodeJS 16.13.1+；Linux 支持 Ubuntu 18.04+、Debian 10+ 等，Windows 10 / Server 2012+ 均可，仓库也提供 Docker 部署脚本。

Q: 二次开发入口在哪？A: 业务逻辑集中在 业务服务层，前端页面在 页面组件，接口定义在 api 目录；通用认证、中间件在 Core 模块，改业务基本只动 WMS 层。

Q: 数据安全怎么保障？A: JWT 认证加按角色的菜单权限，敏感操作有权限校验；生产环境建议配置 HTTPS，并定期备份 wms.db 或对应数据库文件。

Q: License 边界在哪？A: Apache 2.0，可免费使用、修改、商用；再分发时保留原始许可声明即可，详见 LICENSE。

下一步

1. 克隆仓库，按上面的路径把前后端跑起来，用 admin/1 登录
2. 在收货管理里建一张到货通知，走一遍到货通知→卸货→分拣→上架，再建一单发货走完发货流程
3. 打开仓内作业建一个盘点单，熟悉库存变动工具，顺手把用到的菜单按角色分好

项目还在持续演进，仓库里每一次功能补齐、每一处 bug 修复，都是在把这套开源的仓库管理系统打磨得更接近中小企业的真实用法。

【免费下载链接】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