ERPNext一键安装保姆级指南:4步搞定全版本自动化部署
ERPNext一键安装保姆级指南:4步搞定全版本自动化部署
【免费下载链接】erpnext_quick_installUnattended install script for ERPNext Versions, 13 to 16项目地址: https://gitcode.com/gh_mirrors/er/erpnext_quick_install
凌晨一点,你盯着终端里滚过的报错日志,第 N 次怀疑自己是不是该放弃自建 ERP。装依赖、配数据库、调 Redis,每一步都像拆盲盒——直到有人塞给你一个脚本。先说结论:ERPNext一键安装脚本(erpnext_install.sh)能把整套流程压缩成一条命令,支持 v13 到 v16 全版本,开发环境和生产环境自动适配,普通用户照着点确认就能跑通。这篇文章就带你把这条命令真正落地。
先认识它:这个脚本到底帮你省了什么
ERPNext 是全球流行的开源 ERP,功能全面还免费,但手动装一次少说要折腾大半天:Python 环境、Node.js、MariaDB、bench 初始化、站点创建……版本不同依赖还不同,一个环节出错就前功尽弃。
这个仓库只干一件事:把上述流程打包成无人值守脚本。它替你做了这些事:
- 自动检测系统,只认支持的 Ubuntu/Debian 版本,不对就直接停,不让你白跑
- 自动装依赖、初始化 bench、创建站点,全程有进度提示和日志
- 内置 50+ 精选 Frappe 应用市场,HRMS 人事、CRM 客户、LMS 教学等一键勾选
- 生产环境自动配好 nginx、supervisor、SSL;开发环境一条命令就能起服务
| 人群 | 为什么适合你 |
|---|---|
| 中小企业主/管理员 | 不懂代码也能装出可用的 ERP |
| 想先试水的个人 | 开发环境几分钟跑起来,先玩再说 |
| 运维/开发 | 省掉重复劳动,把精力留给业务配置 |
动手前先排雷:4项检查一个都不能少
| 检查项 | 具体要求 |
|---|---|
| 操作系统 | Ubuntu 24.04/23.04/22.04/20.04,或 Debian 12/11/10 |
| 运行账号 | 必须是普通用户,严禁 root 直接跑 |
| 磁盘/内存 | 建议至少 20GB 磁盘、4GB 内存 |
| 版本隔离 | 一台服务器只装一个 ERPNext 版本 |
敲重点:新手第一步最容易栽在 root 上。如果你的 VPS 默认就是 root,先建一个普通用户再继续:
sudo adduser frappeuser sudo usermod -aG sudo frappeuser su frappeuser cd /home/frappeuser三步完成 ERPNext 自动化部署
第一步:取回脚本并做好前置更新
先用系统自带的包管理器把基础环境刷新一遍,这一步别偷懒,跳过的话后面装依赖很容易撞上版本不一致:
sudo apt update && sudo apt -y upgrade重启机器后,取回脚本并赋权:
git clone https://gitcode.com/gh_mirrors/er/erpnext_quick_install cd erpnext_quick_install chmod +x erpnext_install.sh第二步:用 source 启动安装(记住不是 ./)
source erpnext_install.sh脚本会先做系统体检、检测是否已有 ERPNext 安装,然后让你选版本和运行模式。版本对照如下:
| 版本 | 系统要求 | 适合场景 |
|---|---|---|
| v16 | Ubuntu 22.04+ / Debian 12+,Python 3.14+,Node 24 | 尝鲜最新特性 |
| v15 | Ubuntu 22.04+ / Debian 12+,Python 3.10+,Node 18/20 | 生产环境首选 |
| v14 | Ubuntu 22.04 及以下、Debian 11 及以下 | 成熟企业版 |
| v13 | 同上 | 经典兼容版 |
| develop | 与 v15 类似 | 纯技术测试,别碰正式数据 |
选完版本会问你要开发还是生产模式:开发模式装完直接bench start,浏览器访问http://你的IP:8000;生产模式会配好 nginx、supervisor、socketio、redis,一路确认即可。
第三步:收尾验证
装完别急着关终端,按模式做一次确认:
- 生产模式:检查 nginx 与 supervisor 状态,按提示配置 SSL 证书
- 开发模式:
bench start后访问 IP:8000,能看到登录页就算成了
sudo systemctl status nginx sudo supervisorctl status玩出花样:三个进阶用法提升部署上限
1. 应用市场一键加装。安装过程中可以直接勾选 50+ 精选应用,脚本会自动做兼容性校验、为每个应用挑选合适的分支,装失败还有多套兜底策略,最后输出完整的成功/失败报告——相当于把社区里值得装的应用替你筛好了一遍。
2. 版本随心换。同一套脚本覆盖 v13~v16 和 develop 分支,内置"智能分支检测":官方应用自动匹配版本分支,第三方应用走默认分支,你不用记任何分支名。
3. 装完再手动补应用。以后想加新模块,不用重跑整个脚本:
cd /path/to/frappe-bench bench get-app <应用地址> bench --site <站点名> install-app <应用名>ERPNext 安装避坑指南:5个高频坑与解法
| 坑 | 现象 | 解法 |
|---|---|---|
| 用 root 跑脚本 | 建站点阶段直接失败 | 先建普通用户再执行 |
| 一台机器装多个版本 | Redis、Node、supervisor 冲突,服务起不来 | 一机一版本,测试用 Docker 隔离 |
| 装完 Redis 连接报错 | Error 111 connecting to 127.0.0.1 | 重跑bench setup redis并重启服务 |
| 选了 develop 分支 | 功能异常、数据损坏风险 | 正式环境选 v15/v16,develop 只拿来测试 |
| 跳过系统更新直接装 | 依赖冲突、中途报错 | 先apt update && apt upgrade再跑 |
如果已经撞上 Redis 连接问题,用这套通用处理顺序:
sudo systemctl restart redis-server sudo supervisorctl restart all redis-cli ping活跃度与社区生态:有人维护才敢放心用
这个脚本一直跟着 ERPNext 迭代走:从最初支持 v13~v15,到 2.0 加入 develop 分支和应用市场,再到 2.1 补上 v16 支持,每次大版本更新都会同步修正兼容性问题。应用市场的数据来自 awesome-frappe 社区维护的精选清单,等于给你做了层人工过滤。想参与贡献很简单:用出问题先翻仓库里的 README 和脚本注释,有想法直接去项目 Issues 反馈即可。
现在就动手:给你的企业装上第一套 ERP
回到开头那个深夜——与其继续和报错死磕,不如把安装交给人写好的脚本,把时间留给真正的业务配置。现在就去 clone 仓库,按上面的三步走一遍;装完先建个测试站点练手,熟悉了再上生产。祝你一次跑通,顺利上线。
【免费下载链接】erpnext_quick_installUnattended install script for ERPNext Versions, 13 to 16项目地址: https://gitcode.com/gh_mirrors/er/erpnext_quick_install
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
