5分钟部署免费开源ERP：ERPNext上手指南-开发者社区

5分钟部署免费开源ERP：ERPNext上手指南

【免费下载链接】erpnextFree and Open Source Enterprise Resource Planning (ERP)项目地址: https://gitcode.com/GitHub_Trending/er/erpnext

ERPNext是一款免费开源的ERP系统，总账、采购、销售、库存、生产都在里面，不收授权费、不限用户数。这篇文章用最短路把它在本地跑起来，再用三个真实场景讲清楚月末结账、盘点和生产进度怎么落地，最后说五个最常踩的坑，新手照着做十来分钟能跑通。

先聊聊要解决什么

小公司常见的两个头疼事：一是月底对账，银行流水、客户回款、采购发票散在好几张Excel里，总账怎么拉都拉不平；二是仓库盘点，实物和账面对不上，要一笔一笔翻单据找原因。

商业ERP按用户数收费，几十人的公司一年就是一笔不小开支；自己从零写，更不现实。ERPNext的定位就是补上这个空档：一个基于Python的免费开源ERP，把财务、供应链、生产放进同一套系统，数据互通，部署在自己的服务器上，账目和库存都落在自己手里。

🏃 5分钟跑通：用bench本地部署ERPNext

先装bench（Frappe官方的环境管理工具，装的时候会自动装MariaDB、Redis这些依赖），然后开一个新站点、把ERPNext装进去：

bench new-site mycompany.localhost bench get-app erpnext https://gitcode.com/GitHub_Trending/er/erpnext bench --site mycompany.localhost install-app erpnext bench start

浏览器打开http://mycompany.localhost:8000，账号Administrator、密码admin。第一次登录走一遍建公司向导：公司名、币种、科目表，两三分钟的事。完成后是这样一个工作台首页，财务、采购、销售、库存、生产都是图标入口：

登录后的工作台首页，右上角红点是各模块待办数量，点图标进入对应模块

📋 三个场景看懂系统

场景一：月末结账，凭证不用手工做

平时开销售发票、录采购发票，系统按科目表自动生成借贷分录，总账始终平衡。月末做两件事：先用期间锁定（相关逻辑在erpnext/accounts/doctype/period_closing_voucher/）把上一期间封住，防止旧账被改；然后直接看利润表，收入、费用、净利润都在页面上。

利润表顶部直接给出总收入、总支出和净利润，下方按科目逐行展开，可切年度/季度视图

场景二：库存对不上，多仓库加批次来查

盘点差异大时，不用翻纸质单：入库、发货、采购收货都过库存台账，按仓库、批次甚至序列号筛，几分钟定位到是哪张单据的问题。盘点相关的策略——比如允不允许负库存——在erpnext/stock/doctype/stock_settings/里提前配好，到时候不会出意外。

场景三：生产进度，老板不用下车间问

生产工单一建，系统按BOM算出要哪些原料、仓库够不够；工人领料、完工扫码报工，卡在哪个工序、哪个订单延期，管理端一眼看到。工单入口在erpnext/manufacturing/doctype/work_order/，对应界面上的Manufacturing模块。

🧩 团队情况不同，部署怎么选

只想快速体验：不想碰bench的话，官方有frappe_docker部署仓库，一条docker compose -f pwd.yml up -d，两三分钟后访问8080端口，账号同样是Administrator/admin。注意官方README里写明这是可抛弃的演示环境，别往里放真数据。
要二次开发：bench本身就是开发环境，改完erpnext/目录下的代码，bench reload加重启就能生效，加自定义单据、报表都在这套环境里做。
上生产：MariaDB、Redis、应用分开部署，每天bench backup备份站点，对外用Nginx反代加HTTPS，是社区里最稳的组合。

⚠️ 最容易踩的5个坑

页面打不开、提示拒绝连接：站点还没建完或端口被占。等两三分钟刷新；端口冲突就换个端口重启。
登录后提示没有公司、一片空白：建了站点但没建公司。走一遍右上角的setup向导，或bench --site mycompany.localhost create-company补上。
界面全是英文：new-site时没指定语言。进个人设置（Me → Language）选中文，整个界面就切过来了。
忘了Administrator密码：别重建站点，一条命令重置：bench --site mycompany.localhost set-password Administrator 新密码。
装完报模块缺失、日志一堆异常：常见于只get-app没install-app。补跑bench --site mycompany.localhost install-app erpnext，然后bench restart。