三亩地 三亩地SAN MU DI · CODE DIARY
ARTICLE DETAIL

日记详情

真实记录编程学习的某一天,欢迎挑你感兴趣的翻一翻。

不懂服务器也能装ERPNext?这款免费自动化脚本让v13到v16全版本5分钟跑通

不懂服务器也能装ERPNext?这款免费自动化脚本让v13到v16全版本5分钟跑通

不懂服务器也能装ERPNext?这款免费自动化脚本让v13到v16全版本5分钟跑通

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

上周我还在帮朋友的公司手动部署ERPNext,从Python版本折腾到Redis端口,一个周末就这么泡汤了。直到翻到这个开源的ERPNext自动化安装脚本erpnext_quick_install,才发现原来企业级ERP部署可以简单到只敲几行命令——不用通宵看文档,不用逐条敲apt install,剩下的交给脚本就行。

先看它到底能干什么

一句话定位:这是一个能把ERPNext v13、v14、v15、v16 乃至 develop 分支全流程自动装好的无人值守安装脚本,生产环境、开发环境都能选。

关键指标具体数据
支持的版本v13 / v14 / v15 / v16 / develop
兼容系统Ubuntu 20.04~24.04、Debian 10~12
内置应用50+ 精选 Frappe 应用可选
自动化环节环境检测、依赖安装、建站、SSL、应用市场

看完这张卡片你应该有数了:它不只是一个"安装器",更像一个会帮你把关、兜底、出报告的部署管家。🚀

四个最常见的问题,逐个拆给你听

Q1:我该装哪个版本,脚本会帮我判断吗?

会。启动后会弹出版本选择菜单,你按数字选就行。更贴心的是,脚本会根据你选的版本自动校验系统:比如选 v16 要求 Ubuntu 22.04 以上和 Python 3.14+,选 v13/v14 则只支持 Ubuntu 22.04 以下。版本和系统不匹配,它会直接拦下来并告诉你原因,而不是让你装到一半才炸。

Q2:生产环境和开发环境到底差在哪?

选生产环境,脚本会走完整流程:配置 MariaDB 数据库、用 supervisor 托管服务、可选的 Certbot SSL 证书,装完直接访问域名就能用;选开发环境,则自动切换到bench start模式,适合本地调试和二次开发。一句话:要上线选生产,要写代码选开发。

Q3:那 50 多个附加应用是怎么装上去的?

这是我最喜欢的设计。脚本会拉取社区维护的应用清单,用图形化勾选界面让你挑(比如 HRMS 人事、CRM 客户、LMS 在线学习),然后逐个做三件事:检测仓库有哪些可用分支、按你的 ERPNext 版本自动选最匹配的分支、用多种策略尝试安装。就算某个应用装失败,它也会把原因写进报告,不会让整个安装前功尽弃。相关的应用清单与分支检测逻辑都在 erpnext_install.sh 里,感兴趣可以翻翻。

Q4:装到一半报错了,脚本会不管我吗?

不会。脚本内置了trap错误捕获机制,任何一步出问题都会打印出错行号和退出码;遇到版本不兼容的依赖,它会自动回退到备用安装策略。也就是说,它比你更怕装失败,早就准备了好几套方案。

上手只要四步

准备工作:先给自己开个"普通用户"

脚本明确拒绝 root 运行,因为建站点阶段会因权限问题直接失败。如果你拿到的是 root 服务器,先创建普通用户并加入 sudo 组,切换过去再开始。

基础操作:三行命令开跑

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

注意这里要用source而不是./直接执行,否则环境变量无法正确加载。之后按提示依次选择版本、确认继续、输入 SQL root 密码,剩下的交给脚本就好。

进阶技巧:装完后随时补应用

初始装完后想再加应用?进入 bench 目录手动操作即可:

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

万一遇到 Redis 连不上的报错(比如提示Error 111 connecting to 127.0.0.1),先重启服务再检查端口:

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

新手最容易踩的四个坑

  1. 用 root 直接跑脚本—— 建站点阶段必挂。解法:老老实实创建普通用户。
  2. 一台服务器装多个 ERPNext 版本—— 不同版本用的 Redis 端口、Node.js 版本、数据库结构都不同,装在一起轻则端口冲突,重则整机不稳定。脚本会自动检测已有安装并警告,强烈建议一个服务器只装一个版本
  3. 好奇选了 develop 分支—— 那是每天变动的实验代码,可能损坏数据。想尝鲜请选 v16,想在正式环境用请选 v15。
  4. 跳过系统更新直接装—— 干净机器上建议先sudo apt update && sudo apt -y upgrade并重启,否则依赖安装阶段容易踩坑。

不同场景怎么选版本

你的场景推荐版本理由
公司正式上线v15 或 v14稳定成熟,社区验证充分
体验最新功能v16最新稳定版,需较新系统
二次开发调试develop功能最新但有风险
学习入门v15资料多、兼容性好

常见问题快问快答

Q:为什么一定要用 source 运行?A:脚本需要把环境变量注入当前会话,直接执行的话后续步骤可能找不到命令,所以官方明确要求source

Q:对服务器配置有要求吗?A:官方建议至少 4GB 内存、20GB 磁盘,生产环境越大越稳。

Q:装完怎么访问系统?A:配置了域名和 SSL 就访问https://你的域名,否则直接用http://服务器IP即可。

Q:选了应用却装失败,正常吗?A:正常。第三方应用不一定适配你选的版本,脚本会列出成功/失败清单和原因,不影响核心系统使用。

别让部署挡住你的业务

这个脚本的价值不止于"省时间"——它会持续跟随 ERPNext 新版本更新,帮你避开版本兼容的大坑。作为开源项目,它也在欢迎社区的反馈和贡献:用着顺手就给个 star,遇到问题提 issue,大家一起把部署体验打磨得更好。

现在就去克隆仓库,按上面的四步走一遍。从今天起,ERPNext自动化安装不再是运维大神的专利,你也能 5 分钟拥有自己的企业管理系统。💪

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

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

← 返回列表