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 环境是「用完即弃」的体验环境,装不了自定义应用,数据丢了也不心疼。想认真用起来,看第三节。
📦 二、跟着一条业务线走一圈:从采购到财务
不按模块介绍,按你公司真实的一天来串。
- 采购入库。在 Buying 里开采购单,货到后录收货。库存当场增加,应付账款自动挂上供应商的账。
- 库存管理。Stock 支持多仓库、批次和序列号追踪,出入库全程留痕。开实体店的,门店 POS 收银用的是同一本账,卖一件减一件。
- 销售发货。Selling 里开 Sales Invoice,货物发出后库存扣减、收入确认、应收账款入账,一次完成。
- 生产排产。Manufacturing 里先定义 BOM,再跑生产计划,系统自动拆出工单和作业卡,每道工序领料、耗时都记录在案。电商订单自动同步扣库存、制造按 BOM 算材料消耗,走的都是这几条链路。
- 财务记账。以上每步单据都自动写进 erpnext/accounts/ 下的总账,月底不用手工抄凭证。点进利润表,收入、费用、净利润按月排开,还能按季度看趋势:
🛤️ 三、部署路径怎么选:体验 / 二次开发 / 生产
| 路径 | 适用人群 | 工具 | 特点 |
|---|---|---|---|
| Docker 快速体验 | 想先看效果的人 | Docker Compose | 一条命令起服务,仅试水用,装不了自定义应用 |
| Bench 二次开发 | 要改流程、做定制的团队 | Bench(pip 装 frappe-bench) | bench get-app 拉代码、bench new-site 建站点、再 install-app 安装,代码可改,开发端口 8000 |
| 云端生产 | 真正日常使用的业务 | 云服务器或托管平台 | 数据持久、可升级可备份,支持多公司多账簿 |
建议:只是看看,走 Docker;要动业务逻辑,上 Bench;数据开始值钱时,再迁到云上生产部署。
✅ 四、上线后的初始化清单
- 公司信息:设置里建公司,填好名称、地址、默认币种,后面所有单据都挂在它下面。
- 科目表:选一套标准科目表导入,再按行业补明细科目,别上来就手工造科目。
- 角色权限:财务、仓库、销售分角色授权,每个人只看到自己那屏。
- 审批流:给采购、销售单据定义审批工作流,超过一定金额自动往上送审。
- 基础参数:会计期间、税务类别在 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),仅供参考