5 分钟跑起来:ERPNext 免费开源 ERP 完整上手
2026/9/9 21:10:49 网站建设 项目流程

5 分钟跑起来:ERPNext 免费开源 ERP 完整上手

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

ERPNext 是一款完全免费的开源 ERP 系统,一套覆盖财务、采购、销售、库存与制造,不按人头收授权费。本文带你完整跑一遍 ERPNext 部署:先用 Docker 五分钟起服务,再顺着采购入库到财务记账走一遍业务线,最后给你初始化清单和踩坑问答。

🐳 一、5 分钟跑起来:Docker 快速部署

前提很简单:本机装好 Docker 和 Docker Compose v2。然后执行:

git clone https://gitcode.com/GitHub_Trending/er/erpnext cd erpnext docker compose -f pwd.yml up -d

等 2 到 3 分钟。期间可以盯着create-site容器的日志,看到站点建好就可以打开浏览器。

访问http://localhost:8080,用户名Administrator,密码admin。登录后你会看到一屏应用图标:Accounts、Buying、Selling、Stock、Manufacturing、POS 等模块一字排开,右上角红色角标是未读提醒。

有一点要先说清楚:这套 Docker 环境是「用完即弃」的体验环境,装不了自定义应用,数据丢了也不心疼。想认真用起来,看第三节。

📦 二、跟着一条业务线走一圈:从采购到财务

不按模块介绍,按你公司真实的一天来串。

  1. 采购入库。在 Buying 里开采购单,货到后录收货。库存当场增加,应付账款自动挂上供应商的账。
  2. 库存管理。Stock 支持多仓库、批次和序列号追踪,出入库全程留痕。开实体店的,门店 POS 收银用的是同一本账,卖一件减一件。
  3. 销售发货。Selling 里开 Sales Invoice,货物发出后库存扣减、收入确认、应收账款入账,一次完成。
  4. 生产排产。Manufacturing 里先定义 BOM,再跑生产计划,系统自动拆出工单和作业卡,每道工序领料、耗时都记录在案。电商订单自动同步扣库存、制造按 BOM 算材料消耗,走的都是这几条链路。
  5. 财务记账。以上每步单据都自动写进 erpnext/accounts/ 下的总账,月底不用手工抄凭证。点进利润表,收入、费用、净利润按月排开,还能按季度看趋势:

🛤️ 三、部署路径怎么选:体验 / 二次开发 / 生产

路径适用人群工具特点
Docker 快速体验想先看效果的人Docker Compose一条命令起服务,仅试水用,装不了自定义应用
Bench 二次开发要改流程、做定制的团队Bench(pip 装 frappe-bench)bench get-app 拉代码、bench new-site 建站点、再 install-app 安装,代码可改,开发端口 8000
云端生产真正日常使用的业务云服务器或托管平台数据持久、可升级可备份,支持多公司多账簿

建议:只是看看,走 Docker;要动业务逻辑,上 Bench;数据开始值钱时,再迁到云上生产部署。

✅ 四、上线后的初始化清单

  1. 公司信息:设置里建公司,填好名称、地址、默认币种,后面所有单据都挂在它下面。
  2. 科目表:选一套标准科目表导入,再按行业补明细科目,别上来就手工造科目。
  3. 角色权限:财务、仓库、销售分角色授权,每个人只看到自己那屏。
  4. 审批流:给采购、销售单据定义审批工作流,超过一定金额自动往上送审。
  5. 基础参数:会计期间、税务类别在 erpnext/accounts/doctype/accounts_settings/ 里配,库存策略在 erpnext/stock/doctype/stock_settings/ 里调。

🩺 五、踩坑问答:部署与运行常见报错

Q:打开浏览器提示 8080 端口连不上,或端口已被占用?A:先查 8080 被谁占着,停掉占用进程,或改 compose 里的端口映射。再确认 create-site 容器日志跑完了,站点没建好时端口通了也打不开页面。

Q:数据库连接失败,报认证错误?A:先看 MariaDB 容器是否健康,再看连接参数。开发环境用安装脚本装的话,脚本会生成新密码并存到~/frappe_passwords.txt,别拿旧密码试。

Q:启动报文件权限错误?A:检查工作目录的所有者。运行用户没有读写权限时,站点初始化会卡住,把目录权限给到运行账号即可。

Q:页面转圈慢、容器频繁重启,像内存不够?A:加内存最直接;机器不动的话,先调小并发、把长耗时报表按期间拆开跑。

顺手的性能优化有两处:给常用查询字段加数据库索引,静态资源开 Gzip。并发上量后,用多节点加负载均衡。

📚 六、资料去哪儿找:文档与社区

搜「ERPNext 安装教程」会出来一堆第三方文章,但建议以官方文档为准,版本跟进最紧。可用的资源:

  • 官方文档:安装、各模块配置、升级说明都有,部署前值得翻一遍
  • API 参考:Frappe 框架暴露了完整 REST API,任何单据都能直接读写,做对接先看它
  • 讨论论坛与 Telegram 群:用户和服务商都在这,报错原文贴上去通常很快有人接
  • Frappe School:官方维护的免费视频课程,从框架讲到 ERPNext

仓库内部也有值得看的位置:erpnext/accounts/ 是财务模块的全部单据,erpnext/hooks.py 是应用入口配置,改开发环境时绕不开它。


ERPNext 适合想把账本握在自己手里、又不想按人头买授权的中小企业。建议先用第一节的 Docker 环境走完整条业务线,熟悉手感后,再决定上 Bench 做定制还是迁往生产部署。

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

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询