企业官网建设流程全解析

ERPNext 自动安装实战：从踩坑到 5 分钟跑通企业 ERP 部署

【免费下载链接】erpnext_quick_installUnattended install script for ERPNext Versions, 13 to 16项目地址: https://gitcode.com/gh_mirrors/er/erpnext_quick_install

凌晨一点，小陈盯着满屏报错的终端，第五次重试bench setup。这是他手动安装 ERPNext 的第三天：Python 版本对不上、Node.js 卡在编译、Redis 报 Error 111、supervisor 起不来……每一关都像在拆盲盒。如果你也有过类似的经历，或者正打算给自己公司搭一套 ERP 却迟迟不敢动手，这篇文章就是为你写的——我们用一个小脚本，把"装 ERPNext 这件事"从几天的苦差事，压缩成一杯咖啡的时间。

它到底是什么：一句话讲清楚 ERPNext 自动安装脚本

erpnext_install.sh是 ERPNext 的无人值守自动安装脚本，来自 erpnext_quick_install 这个开源仓库。它支持 ERPNext v13、v14、v15、v16 以及 develop 分支，覆盖 Ubuntu 20.04 到 24.04、Debian 10 到 12。

用大白话说：以前你要手动完成的"装系统依赖 → 配 Python/Node.js → 初始化 bench → 建站点 → 配数据库 → 装 SSL"全套流水线，它替你按顺序自动跑完，中间只问你几个选择题。

它适合三类人：想快速搭生产环境的中小企业 IT、刚接触 Frappe 框架想先跑通再学习的开发者，以及被官方文档劝退、只想尽快看到登录页面的"行动派"。

第一次跑通：跟着脚本走一遍完整流程

整个安装过程分四步，前三步是准备，真正的主角是最后那条命令。

先解决一个关键前提：别用 root。脚本在创建站点阶段需要以普通用户身份运行，root 直接跑会失败。如果你的 VPS 默认就是 root，先建个普通用户：

sudo adduser frappeuser usermod -aG sudo frappeuser su frappeuser cd /home/frappeuser

然后拉取脚本并执行：

git clone https://gitcode.com/gh_mirrors/er/erpnext_quick_install.git cd erpnext_quick_install chmod +x erpnext_install.sh source erpnext_install.sh

接下来就是"回答问题"时间，脚本会用彩色提示一步步引导你：

• 选版本：输入数字从 13/14/15/16/develop 中选一个。这里有个坑要提前知道——版本和系统版本是绑定的，选错了会直接被拦下：

• 设 SQL root 密码：会要求你输入两遍并校验一致，这是 MariaDB 的管理员密码，务必记牢。
• 冲突自检：脚本会扫描常见路径下是否已有 ERPNext 安装，发现后会详细列出版本和分支，并警告可能引发的端口、依赖冲突，让你确认是否继续——这个设计在下面"避坑"部分会重点讲。

之后就是全自动阶段：更新系统包、装 Python/Redis/supervisor、初始化 bench、下载 frappe 与 erpnext 对应分支、建站点、配数据库、装 SSL。期间有进度提示和日志输出，出错时脚本会捕获异常行号，方便你定位问题。跑完看到"安装成功"的绿色提示，再按提示访问服务器 IP 就能看到 ERPNext 登录页了。

进阶玩法：把脚本的隐藏功力用起来

玩法一：内置应用市场，一次装齐业务模块

脚本内置了 50+ 精选 Frappe 应用。安装过程中会询问是否装附加应用，选"是"后它会从 awesome-frappe 仓库拉取应用清单，生成一个交互式勾选界面。HRMS 人力资源、CRM 客户管理、LMS 在线学习、Insight 数据分析、Helpdesk 工单系统……看上哪个勾哪个，还会自动校验该应用与当前 ERPNext 版本是否兼容。

玩法二：智能分支探测，省去手动挑分支的麻烦

很多 Frappe 应用每个版本分支名都不一样。脚本会用git ls-remote探测仓库实际存在的分支，再按"当前 ERPNext 版本优先匹配"的优先级自动挑，比如装 v16 时优先找version-16分支，找不到就降级找version-15、main，最后兜底用第一个可用分支。你不用记任何分支命名规则。

玩法三：事后随时补装应用

安装完成后想再加应用？回到 frappe-bench 目录手动操作即可，跟脚本互不影响：

cd ~/frappe-bench bench get-app <应用仓库地址> bench --site <站点名> install-app <应用名>

过来人的避坑清单

• 一个服务器只装一个版本，是铁律。v16 和 v15 混装，Redis 端口可能冲突；v13/v14 用 Node 16，v15/v16 用 Node 18/20，v16 要 Node 24，混装必然翻车；数据库 schema 也互不兼容。脚本的冲突自检就是在替你挡这些雷，看到警告请认真对待。
• develop 分支是深水区。它每天都在变，可能损坏数据，只适合老手尝鲜。想稳定就用 v15，想体验新特性就用 v16。
• 遇到 Redis 连接报错（Error 111）别慌。依次执行bench setup socketio、bench setup supervisor、bench setup redis，再sudo supervisorctl reload；通用救法是重启 redis-server 和所有 supervisor 服务。
• 服务器配置别太抠。建议至少 4GB 内存、20GB 磁盘，编译阶段吃资源，配置太低会卡到怀疑人生。

写在最后

回头再看小陈那三天的挣扎，其实并不是他笨，而是手动安装的链路实在太长——任何一环出错都要回头排查。而 ERPNext 自动安装脚本把这条链路的每一步都封装、检测、回退好了，你要做的只是回答问题。如果你正站在"要不要自己装 ERPNext"的十字路口，不妨今天就拉下这个脚本试一次：克隆仓库、执行、喝杯咖啡，登录页就在那里等你。相关文档可查阅 ERPNext 官方文档与 Frappe Framework 文档，遇到问题也可以去 ERPNext 社区论坛求助，祝你的企业数字化之旅顺利起步。

【免费下载链接】erpnext_quick_installUnattended install script for ERPNext Versions, 13 to 16项目地址: https://gitcode.com/gh_mirrors/er/erpnext_quick_install