ERPNext 自动化部署终极指南一个脚本 3 步装好 v13 到 v16 全版本【免费下载链接】erpnext_quick_installUnattended install script for ERPNext Versions, 13 to 16项目地址: https://gitcode.com/gh_mirrors/er/erpnext_quick_install上周有位朋友跟我诉苦公司要上 ERP 系统他选了开源的 ERPNext结果光是装环境就耗了整整三天——先被 Python 版本卡住好不容易搞定Node 版本又对不上接着 Redis 端口冲突、wkhtmltopdf 缺依赖、MariaDB 字符集乱码……最后他崩溃地说早知道就买商业软件了。其实这件事本可以 5 分钟结束。erpnext_quick_install就是一个专为此场景打造的无人值守安装脚本它把 ERPNext v13、v14、v15、v16 乃至 develop 分支的整套部署流程封装成了几个简单的交互式问答。你只需要回答版本号、密码这类问题剩下的系统检测、依赖安装、数据库加固、生产环境上线全部交给脚本自动完成。这个脚本到底能帮你省下什么一句话概括erpnext_quick_install 是覆盖 ERPNext v13 到 v16 全部主流版本、支持生产与开发双环境、内置 50 扩展应用市场的全自动安装工具。相比手工部署动辄数小时的依赖排查它把整个过程压缩到一次source命令里。我实测下来的直观感受是以前要记十几条命令、踩五六个坑才能跑起来的 ERPNext现在真的像填表一样简单。不同身份的人能从这里得到什么这个脚本的价值不是单一的按使用场景拆开看更清楚你的身份你能得到什么运维/管理员全版本覆盖、已有安装冲突检测、MariaDB 安全加固、可选 SSL 证书自动签发开发者一键进入开发模式bench start即可访问、develop 分支尝鲜、完整的 bench 工具链业务/选型者内置 50 精选 Frappe 应用HRMS、CRM、LMS、Helpdesk 等勾选即装自动校验兼容性其中我最喜欢的是智能分支检测脚本会用git ls-remote探测每个应用仓库的实际分支优先挑选与你的 ERPNext 版本匹配的分支而不是盲目拉默认分支从根源上减少了版本不匹配这类最常见的安装失败。动手前先对照这份检查清单安装前请花两分钟核对下面几项能避免 90% 的坑✅ 系统版本脚本只认 Ubuntu 与 Debian。具体版本要求如下Ubuntu 24.04 / 23.04 / 22.04 / 20.04Debian 12 / 11 / 10✅ 版本与系统匹配这步最容易错务必对号入座v16仅支持 Ubuntu 22.04 或 Debian 12要求 Python 3.14、Node.js 24v15 / develop仅支持 Ubuntu 22.04 或 Debian 12要求 Python 3.10、Node.js 18/20v13 / v14仅支持 Ubuntu 22.04 及以下、Debian 11 及以下要求 Node.js 16✅ 非 root 用户脚本在创建站点时会因为权限问题失败绝不能用 root 直接跑。如果服务器默认就是 root先建个普通用户sudo adduser frappeuser usermod -aG sudo frappeuser su frappeuser cd /home/frappeuser✅ 硬件底线建议至少 4GB 内存、20GB 磁盘空间如需后续配置 SSL提前把域名解析到服务器 IP。一个版本一台机器脚本会自动检测服务器上已有的 ERPNext 安装并给出警告。因为不同版本对 Node、Redis 端口develop 用 11000/12000/13000标准版用 6379、数据库模式的要求都不同混装极易引发服务冲突。生产环境建议专机专用。从零到一3 步完成 ERPNext 自动化安装准备工作就绪后整个部署过程只有三步命令第一步获取安装脚本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 注意是source而不是直接执行这样脚本才能把环境变量如 nvm、Python 虚拟环境正确加载到当前会话。脚本启动后你会进入一个循序渐进的问答流程每个问题都有明确提示选择 ERPNext 版本13/14/15/16/develop 五选一选 develop 时会弹出风险警告并要求二次确认设置 SQL root 密码输入两次校验一致命名 bench 目录默认frappe-bench输入站点名称——如果以后要装 SSL这里请填完整域名FQDN设置管理员密码选择生产安装还是开发环境。选生产模式后脚本会依次完成系统依赖安装 → Python 环境版本不够会自动编译安装→ Redis → wkhtmltopdf → MariaDB 安全配置 → NVM/Node/Yarn → bench 初始化 → 创建站点 → 安装 ERPNext 核心 → 配置 supervisor 与调度器 → 重启全部服务。✅ 预期的完成效果脚本结尾会打印祝贺信息。有域名的访问https://你的域名没配 SSL 的访问http://服务器IP就能看到登录页了。整个流程中最贴心的是多重回退策略某个环节失败不会直接中断而是自动尝试替代方案。比如安装应用时会依次尝试从setup.py提取应用名、仓库名、转换名、小写名、目录名等多种方式定位真正的应用标识把装不上的概率降到最低。常见问题排查装挂了先看这里❓ 用 root 跑脚本报错怎么办这是最高频的问题。脚本在bench new-site阶段会因 root 权限导致站点创建失败。解决办法就是回到上文检查清单先建好普通用户再跑一遍。❓ 遇到 Redis 连接错误如 Error 111 connecting to 127.0.0.1:11001v15/v16/develop 需要额外的 Redis 实例。可以这样修复cd /path/to/frappe-bench bench setup socketio bench setup supervisor bench setup redis sudo supervisorctl reload通用排查手段sudo systemctl restart redis-server重启服务再用redis-cli ping确认 Redis 是否响应。❓ 服务器上已经装过别的版本还能装吗脚本会自动检测并给出详细警告包括版本、分支信息。强烈建议要么沿用现有安装要么备份后清理干净要么换台新服务器/容器。硬要混装你可能要面对端口冲突、supervisor 配置互相覆盖、数据库模式不兼容等一系列连锁问题。❓ Python 版本低于要求不用慌脚本检测到版本不足时会自动下载对应版本的 Python 源码并编译安装例如 v16 需要 Python 3.14全程无需手工干预。进阶玩法装好之后还能做什么手动安装额外应用任何时候都可以用 bench 补装应用cd /path/to/frappe-bench bench get-app 应用仓库地址 bench --site 站点名称 install-app 应用名称给站点配置 SSL脚本内置了 Certbot 集成只要域名已解析到服务器安装流程末尾选择是即可自动申请并配置 HTTPS 证书全程无需手工编辑 nginx。开发环境的使用选择开发模式安装后运行bench start即可启动开发服务器访问http://服务器IP:8000进行开发调试。版本选型建议生产环境优先选 v15成熟稳定或 v14久经考验想体验最新特性选 v16纯粹做技术验证再考虑 develop 分支——它的代码每天都在变不建议放任何重要数据。现在就开始吧ERPNext 功能全面、完全开源它缺的从来不是能力而是一把能把它快速装起来的钥匙。erpnext_quick_install 就是这把钥匙一次 clone、一次 source、几个问答你就能拥有一个企业级 ERP 系统。如果你想深入研究脚本的每个细节项目里附带的 README.md 和 erpnext_install.sh 本身就是最好的教材——脚本里的注释把每一步的意图都写得清清楚楚读完你甚至能自己改造出专属的安装流程。工具已经备好剩下的就等你动手了。【免费下载链接】erpnext_quick_installUnattended install script for ERPNext Versions, 13 to 16项目地址: https://gitcode.com/gh_mirrors/er/erpnext_quick_install创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考