企业官网建设流程全解析

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项目落地经验提炼而来，基于.NET 7.0与Vue 3技术栈，免费帮助预算有限的中小企业管好入库、库存与出库。

ModernWMS面向中小企业的仓库管理系统，覆盖从收货通知到发货的完整链路

⚡ 最快部署路径：三步跑通ModernWMS

想先看效果？用Docker最快。以下三条命令，把前端、后端、Nginx一次性打包启动。

先克隆源码并进入Docker构建目录：

git clone https://gitcode.com/GitHub_Trending/mo/ModernWMS && cd ModernWMS/docker

构建镜像并以端口映射方式启动，前端走80端口：

docker build -t modernwms:latest . docker run -d -p 80:80 --name modernwms modernwms:latest

浏览器访问http://服务器IP，输入默认账号即可登录。5分钟后，你看到的就是一个能建的仓、能录单的完整WMS。

🗂️ 系统能力全景：一笔货从进仓到发出去的旅程

不按模块罗列，跟着"一笔业务"走一遍，你就知道这套WMS给了你什么。

ModernWMS收货管理界面：到货通知单创建、审核与明细查询

• 到货通知与收货- 供应商还没发货，你先建好到货通知单；货到了按"待卸货→待分拣→待上架"逐步推进，每一步都有操作记录可追溯。
• 上架与库位绑定- 货物按SKU落到具体库位，库存数据从这一刻开始实时可信。
• 仓内作业- 库存移动、冻结、调整、加工、盘点五类高频作业独立成模块，账实差异有正式流程去处理，而不是改库了事。
• 出库发货- 从新建出库单开始，经历拣货、复核打包、称重、运费、签收等状态流转，一单货走到哪一步，列表里一目了然。
• 基础资料管理- 仓库、库区库位、货主、客户、供应商、SKU、运费模板全部可视化维护，支持Excel批量导入。

📋 环境与技术栈要求

• 后端- .NET 7.0（SDK用于编译，运行时即可运行生产环境）
• 前端- Vue 3.2 + TypeScript 4.1，Vite构建，Node.js 16.x + yarn编译
• 数据库- SQLite（内置零配置）、MySQL 8.0+、SQL Server 2017+、PostgreSQL 12，由 backend/ModernWMS/appsettings.json 中的Database.db项切换
• 操作系统- Ubuntu 18.04+/20.04/22.04、CentOS Stream 8/9、Debian 10/11、Windows 10(1607+)及Windows Server 2012+
• 硬件门槛- 1GB内存即可流畅运行，单机部署足够中小企业日常单量

🖥️ 分平台部署详解

方案一：Linux脚本流（适合生产服务器）

步骤1：安装.NET SDK 7.0与Node.js 16（Ubuntu/Debian为例）：

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 update && sudo apt install -y dotnet-sdk-7.0 curl -fsSL https://deb.nodesource.com/setup_16.x | sudo -E bash - sudo apt install -y nodejs && sudo npm install -g yarn

步骤2：编译前端，并把API地址改成你的服务器IP（生产环境前端会直连后端20011端口）：

cd frontend sed -i 's#http://127.0.0.1#http://你的服务器IP#g' .env.production yarn && yarn build

步骤3：发布后端，并确认wms.db（SQLite库文件）已随发布目录一起拷贝：

cd ../backend dotnet publish -c Release -o ./publish

步骤4：部署Nginx托管前端静态文件，然后把frontend/dist产物拷入站点目录，启动后端：

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

方案二：Windows图形化流程（适合本地验证）

步骤1：安装.NET 7.0 SDK、Node.js 16.x与Nginx for Windows，均为官方安装包一路下一步。

步骤2：命令行编译前后端：

cd frontend yarn && yarn build cd ..\backend dotnet publish -c Release

步骤3：把frontend/dist产物拷入Nginx的html目录并修改.env.production中VITE_BASE_PATH，先yarn build再拷贝。

步骤4：启动Nginx与后端，浏览器访问本机IP即可：

cd backend\ModernWMS\bin\Release\net7.0\publish dotnet ModernWMS.dll --urls http://0.0.0.0:20011

方案三：Docker容器化（推荐新手）

见上文"最快部署路径"。镜像定义见 docker/ 目录，内部已预装aspnetcore-runtime-7.0与Nginx，构建后即可跨机器迁移，适合"装一次，到处跑"。

🔑 初始化登录与核心操作体验

部署完成后，记住这几个关键信息：

• 访问地址-http://服务器IP（前端，Nginx 80端口）
• 默认管理员- 账号admin，密码1
• API接口文档-http://服务器IP:20011/swagger
• 后端端口- 20011（Docker容器内为21011，见docker/run.sh）

登录后的首页是全局工作台，左侧导航按"基础设置/收货管理/库存管理/仓内作业/发货管理"分组，结构清晰：

ModernWMS首页：按收货、库存、仓内作业、发货分组的完整WMS功能导航

日常操作建议从三件事入手：先在基础设置里建好仓库、库区库位和SKU；再到收货管理创建第一张到货通知单并走完收货流程；最后在发货管理建出库单体验状态流转：

ModernWMS发货管理：出库单按新发货、已签收、出库等状态分栏跟踪

📊 数据统计与报表能力

业务跑起来后，统计模块直接基于库存与出入库流水出数：

• 库存统计- 按SKU、仓库、货主维度汇总数量与体积，支持导出
• 呆滞库存分析- 找出长期未动的SKU，为清库和补货提供依据
• 出入库统计- 按时间与单据类型分析作业量，评估仓库产能
• 安全库存预警- SKU级安全库存上下限设置，低于阈值自动提示补货
• 大屏看板- 内置可视化大屏页面，适合挂在仓库现场做实时作业展示

报表均支持Excel导出，可以直接进经营分析会。

🔧 常见问题速查

• 数据库连接失败- 打开backend/ModernWMS/appsettings.json，核对Database.db与对应连接串；不想装数据库时，把db改为Sqlite并把wms.db放到后端发布目录即可。
• 前端页面打开但接口全404- 生产构建时会把API地址打进包里，确认frontend/.env.production的VITE_BASE_PATH是服务器真实IP，然后重新yarn build。
• 前端样式显示异常- 清浏览器缓存，或重新执行cd frontend && yarn build后再拷贝产物。
• 20011端口被占用- 换端口启动：dotnet ModernWMS.dll --urls http://0.0.0.0:20012，同时同步修改前端的VITE_SERVER_PORT并重新构建。
• 登录后数据很"假"- 系统内置演示数据方便上手，正式投产前在各基础资料列表里清空即可。

💡 进阶技巧

• 多仓库协同- 基础设置中维护多个仓库，库存查询与调拨天然支持跨仓视角，适合"中心仓+分仓"的布局。
• 权限精细到按钮- 角色菜单模块可把权限配置到具体操作按钮，仓管员、财务、管理层各给一个角色，数据安全不用额外开发。
• 对接自有业务- Swagger文档里每个接口都有说明，拣货PDA、ERP对接都可以直接基于REST接口开发，无需碰核心代码。

ModernWMS把商业WMS里中小企业真正需要的功能抽出来、开源出来：入库有流程、库存有账、出库有跟踪，1GB内存的机器就能跑起来，Apache-2.0协议可自由商用。建议先按本文跑通一个环境，熟悉功能后清空演示数据正式投产；对接开发需求时，从http://服务器IP:20011/swagger开始看接口是最高效的路径。更多细节可参考 README.zh_CN.md。

提示：正式投产前，请在appsettings.json中改掉TokenSettings的默认签名密钥，并给 admin 账户设置强密码——这两处是部署后最容易被忽视的安全点。

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