ERPNext 一键自动化安装完整指南：零基础 5 分钟部署 v13 至 v16 全版本

ERPNext 一键自动化安装完整指南：零基础 5 分钟部署 v13 至 v16 全版本

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

提起 ERPNext 的部署，很多人的第一反应是"强大但难装"。依赖环境繁杂、版本兼容敏感、数据库配置易错，手动安装动辄折腾大半天，稍有不慎就前功尽弃。好在开源社区早有解药——ERPNext 自动化安装脚本 erpnext_quick_install，它把从系统检测到生产环境上线的全部流程封装成一条命令，支持 v13、v14、v15、v16 及 develop 全版本，让技术新手也能在几分钟内拥有一套可用的企业级 ERP 系统。

手动部署 ERPNext，到底难在哪里？

没有踩过坑的人，很难理解 ERPNext 安装的"劝退指数"。拆开来看，痛点几乎集中在四个环节：

• 依赖链太长：Python、Node.js、Redis、MariaDB、wkhtmltopdf、yarn、bench……任何一个版本不对，后面全部白搭；
• 版本匹配严格：不同 ERPNext 版本对 Python 和 Node.js 的最低要求各不相同，选错组合直接编译失败；
• 数据库安全配置繁琐：root 密码、字符集、权限清理，一步不到位就埋下隐患；
• 生产环境上线复杂：supervisor、nginx、Redis 多进程协同，配置错一处，服务起不来还找不到原因。

这些坑，恰恰是 erpnext_quick_install 这个开源脚本存在的意义。

一条命令，替你包办整条安装链路

erpnext_quick_install 是一个无人值守的交互式安装脚本，面向 Ubuntu 与 Debian 系服务器设计。它会自动完成系统兼容性校验、依赖安装、MariaDB 安全加固、bench 初始化、站点创建、ERPNext 核心部署，以及可选的生产环境（nginx + supervisor + Redis）或开发环境配置。你只需要回答几个简单的选择题，剩下的交给脚本。

核心能力一：v13 到 v16 全版本覆盖

脚本内置版本选择菜单，从经典稳定的 v13 到最新的 v16，甚至包括每日变动的 develop 开发分支，一应俱全。每个版本对应的 Python、Node.js 版本都会被自动匹配并安装，无需手动干预。

核心能力二：环境智能适配

脚本会自动识别你是在 Ubuntu 还是 Debian 上运行，并检查系统版本是否满足所选 ERPNext 版本的最低要求。比如选择 v16 时，系统版本低于 Ubuntu 22.04 或 Debian 12 会直接被拦截并给出明确提示，避免在错误的环境上浪费时间。

核心能力三：内置 50+ Frappe 应用市场

安装完 ERPNext 核心后，脚本会拉取社区维护的 awesome-frappe 应用清单，通过可视化勾选界面让你自由挑选额外应用。HRMS 人力资源管理、CRM 客户关系、LMS 学习管理系统等 50 多个应用一键可选。更贴心的是，脚本会自动检测每个应用与当前版本的兼容性（校验 pyproject.toml），并智能挑选最合适的分支。

核心能力四：多重防错与回退机制

安装第三方应用是翻车高发区。脚本为此设计了多层安装策略：先从 setup.py 提取真实应用名，失败后依次尝试仓库名、变形名、小写名、目录名，层层兜底。每个步骤都输出明确的成功/失败报告，即使某个应用装不上，也绝不会拖垮整体安装。

核心能力五：安全与 SSL 一步到位

脚本会为 MariaDB 设置 root 密码、清理匿名用户和测试库、配置 utf8mb4 字符集；如果你有域名，还可以直接调用 Certbot 一键签发并配置免费 SSL 证书，让系统以 HTTPS 安全上线。

动手实操：三步完成 ERPNext 自动化安装

在开始之前，请先确认你的服务器系统属于支持范围：

第一步：更新系统并重启

sudo apt update && sudo apt -y upgrade sudo reboot

全新服务器建议先做这一步，避免旧包版本干扰后续安装。

第二步：准备非 root 用户

脚本在创建站点环节必须使用普通用户，切勿以 root 身份运行。如果你的服务器默认就是 root，请按下面的方式创建专用用户：

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

提示：用户名可以换成你喜欢的任意名称，只需保证该用户拥有 sudo 权限。

第三步：拉取脚本并启动安装

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

运行后，脚本会以清晰的彩色菜单引导你完成版本选择、数据库密码设置、站点命名等步骤，全程有进度提示，不会让你对着黑屏干等。

脚本在你背后做了什么？

把脚本的运行过程摊开来看，大致包含以下阶段：

值得留意的是，脚本针对 Ubuntu 24.04 等新系统还内置了多处专项修复，例如 supervisor 默认配置生成、nginx vhosts 条件补丁、Redis 多端口实例（11000/12000/13000）启动等，这些都是在老版本系统上不会踩、但在新系统上必然踩的坑，脚本都已提前填平。

版本选择与避坑指南

不同 ERPNext 版本对系统环境的要求差异很大，选错版本容易引发连锁故障。下面这张表请务必收好：

最重要的一条铁律：一台服务器只装一个版本

不同版本混装在同一台服务器上，会引发 Redis 端口冲突、Node.js 版本冲突、supervisor 配置冲突、数据库结构不兼容等一系列问题。脚本虽然会自动检测已有安装并给出警告，但最稳妥的做法仍然是：生产环境与开发环境分开服务器，每个实例独占一台机器或容器。

develop 分支：只可远观

develop 是每日更新的实验性分支，代码不稳定，可能引发数据损坏或系统崩溃，社区支持也有限。脚本在选择该版本时会弹出红色警告并要求二次确认。普通用户请优先选择 v15（成熟稳定）或 v14（久经考验）。

常见问题排查方法

即使自动化程度再高，网络波动或环境差异仍可能导致个别环节出问题。以下是两个最高频的故障及处理方法。

Redis 连接报错（Error 111 connecting to 127.0.0.1:11001）

多出现在 v15/v16/develop 版本上，先执行一次标准修复流程：

cd /path/to/frappe-bench bench setup socketio bench setup supervisor bench setup redis sudo supervisorctl reload

如果仍未解决，再尝试重启服务并检查端口：

sudo systemctl restart redis-server sudo supervisorctl restart all redis-cli ping

redis-cli ping能正常返回PONG，说明 Redis 服务本身健康。

安装后想补装应用

脚本安装完的应用列表并非全部，你随时可以手动补充：

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

注意第三方应用与 ERPNext 版本之间可能存在兼容性差异，v16 下非官方应用目前尚未经过充分测试，安装前请自行评估风险。

开始你的企业数字化之旅

回到开头的问题：部署 ERPNext 究竟需要多久？有了 erpnext_quick_install，答案是——从执行脚本到系统跑起来，全程自动化、无人值守，多数场景下几分钟即可完成核心部署，剩下的只是喝杯咖啡等它收尾。

这个脚本解决的不只是"装得上"的问题，更解决了"装得对、装得稳"的问题：版本自动匹配、依赖自动补齐、冲突自动预警、失败自动兜底。无论你是想快速搭建一套生产 ERP，还是准备一个开发环境研究 Frappe 框架，它都是目前最省心的起点。

现在，就按本文的三步流程动手吧。克隆脚本、选择版本、回答问题，几分钟后，你就能在浏览器里打开属于你自己的 ERPNext 系统了。

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