ERPNext 一键自动安装完整指南从零部署到生产环境【免费下载链接】erpnext_quick_installUnattended install script for ERPNext Versions, 13 to 16项目地址: https://gitcode.com/gh_mirrors/er/erpnext_quick_install手动部署一套 ERPNext 是什么体验你要先配置 Python 和 Node.js 环境再装 MariaDB 数据库接着手工处理 Redis、Supervisor、Nginx 的层层关联中途任何一个版本号对不上整个安装就可能功亏一篑。对于没有专职运维的中小企业和技术新手来说这条路常常一走就是一整天。如果你正在寻找一种把安装交给脚本、把精力留给业务的方案那么 ERPNext 自动化安装脚本就是为你准备的。它能在几分钟内完成从系统检测到站点创建的全过程支持 ERPNext v13 到 v16 全部版本以及 develop 开发分支还能自动识别开发或生产环境并内置了 50 多个 Frappe 应用供你按需选择。本文会从它是什么讲起带你完成一次完整的安装再告诉你版本怎么选、出了问题怎么排查。这套脚本到底解决了什么问题ERPNext 是全球知名的开源 ERP 系统覆盖销售、采购、库存、会计、人力资源等企业管理核心模块功能全面且免费。但它的安装门槛一直很高——依赖链长、版本约束多、配置项繁琐稍有疏漏就会报错。这款无人值守安装脚本erpnext_quick_install把上述复杂度全部封装起来它自动检测你的操作系统、自动安装依赖软件包、自动配置数据库和 Web 服务、自动检测最适合的应用分支并内置多套安装策略一套失败会自动回退到备用方案。你只需要回答几个交互问题剩下的事情交给脚本处理。对比维度传统手动安装使用本脚本准备时间数小时到数天约 5 分钟版本选择需自行确认依赖兼容性内置各版本兼容性校验环境配置手动装 Python、Node、MariaDB、Redis自动安装与配置应用扩展逐个手动获取、安装内置 50 应用市场勾选即装出错处理报错后自行搜索排查多重策略回退 详细日志如果你符合下面任一情况这套工具尤其值得一试第一次部署 ERP 系统的新手、需要快速搭建演示环境的顾问、想在不同服务器上分别部署测试与生产环境的团队。安装前的三项准备确认操作系统受支持脚本仅支持 Debian 系发行版具体如下Ubuntu24.04 / 23.04 / 22.04 / 20.04Debian12 / 11 / 10如果你使用的是 CentOS、AlmaLinux 等 Red Hat 系系统脚本会在启动时直接给出不兼容提示并退出这是它的自我保护机制无需强行绕过。检查服务器资源为了保证安装顺利和后续运行流畅建议至少满足以下配置磁盘空间20GB 以上ERPNext 及其依赖占用较大内存4GB 以上内存不足是安装失败的常见原因先更新系统包在全新的机器上运行前建议先做一次系统更新并重启避免旧包版本引发兼容问题# 更新全部系统软件包到最新版本 sudo apt update sudo apt -y upgrade# 更新完成后重启机器让内核和库文件生效 sudo reboot安全提示千万不要用 root 运行重要警告本脚本禁止以 root 用户运行否则在创建站点环节会直接失败。如果你的云服务器默认登录用户就是 root请先创建普通用户并切换过去。创建普通用户的过程如下# 1. 创建新用户其余提问可以直接回车跳过 sudo adduser frappeuser # 2. 把新用户加入 sudo 组获得管理员权限 usermod -aG sudo frappeuser # 3. 切换到新用户 su frappeuser # 4. 进入该用户的主目录 cd /home/frappeuser脚本强制使用普通用户运行是为了让 frappe-bench 目录、站点文件和服务进程都归属到独立用户下这既是安装成功的前提也是生产环境安全性的基本保障。四条命令完成部署整个安装过程可以浓缩为四步全程在普通用户下执行# 第一步获取安装脚本 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注意最后一步必须使用source而非直接执行因为脚本中的环境变量和 shell 函数需要在当前会话中生效后续 bench 命令才能正常工作。启动后脚本会先校验操作系统然后引导你完成以下流程选择要安装的 ERPNext 版本选择开发环境还是生产环境输入数据库密码等必要参数自动安装依赖并部署系统核心询问是否从应用市场安装额外应用整个过程带有进度提示和彩色输出你随时能知道当前进行到哪一步。安装结束后脚本会给出站点地址和访问信息浏览器打开即可开始使用。版本那么多到底该选哪个脚本支持 ERPNext v13、v14、v15、v16 以及 develop 分支不同版本对系统和运行时有不同要求选错版本是新手最常见的坑。各版本对系统的要求版本系统要求PythonNode.jsv16Ubuntu 22.04 或 Debian 123.1424v15 / developUbuntu 22.04 或 Debian 123.1018 / 20v13 / v14Ubuntu 22.04 及以下、Debian 11 及以下3.1016按使用场景推荐你的用途推荐版本理由生产环境v15 或 v14经过充分测试稳定性优先测试新功能v16最新稳定版提前体验与升级准备技术尝鲜develop每日更新仅限开发验证学习上手v15文档完善社区支持最好这里特别提醒develop 分支包含每日更新的实验性代码可能不稳定存在数据损坏或系统崩溃的风险社区支持也有限。它只适合有经验的开发者在隔离环境中测试切勿用于生产或存放重要数据。如果你只是想要新特性优先选择稳定的 v16。内置应用市场50 多个应用随选随装脚本在安装核心系统后会询问你是否需要安装额外应用这些应用来自社区维护的 awesome-frappe 精选列表覆盖常见业务场景人力资源HRMS 完整人事方案、员工档案与考勤、薪资计算模块销售与客户CRM 客户管理、销售订单与发票、商机跟踪教育培训LMS 学习管理系统、课程与学员管理、在线考试项目管理任务跟踪、工时管理其他领域电商集成、财务扩展、协同通讯等选择应用时脚本会做三件事先校验应用与当前 ERPNext 版本的兼容性读取 pyproject.toml 要求再自动探测应用仓库的最佳分支官方应用匹配版本分支第三方应用使用默认分支最后按多套安装策略依次尝试并给出详细的成功或失败报告。需要注意第三方应用的质量参差不齐部分应用可能因版本不匹配或依赖缺失而安装失败这属于正常现象。尤其是 v16 下未经 Frappe 官方测试的第三方应用请自行评估风险。常见问题与避坑指南问一台服务器能装多个 ERPNext 版本吗不建议这是最容易踩的坑。同一服务器上安装多个版本会引发一系列冲突Redis 端口冲突develop 分支使用 11000/12000/13000标准版使用 6379Node.js 版本冲突v13/v14 用 Node 16v15/develop 用 Node 18/20v16 用 Node 24Supervisor 服务配置互相干扰数据库模式不兼容、Python 依赖包版本互相打架正确做法是一台服务器只装一个版本生产与开发环境分开部署需要测试其他版本时使用 Docker 容器隔离。脚本本身会自动检测已有安装并给出冲突警告但最终的隔离责任在你。问安装后连接 Redis 报错怎么办如果遇到类似 Error 111 connecting to 127.0.0.1:11001 的错误可以按顺序尝试以下方案。针对 ERPNext v15/v16先重建 bench 相关配置cd /path/to/frappe-bench bench setup socketio bench setup supervisor bench setup redis sudo supervisorctl reload如果问题依旧检查 Redis 服务本身的状态# 重启 Redis 服务 sudo systemctl restart redis-server # 重启所有 supervisor 服务 sudo supervisorctl restart all # 查看 Redis 服务状态 sudo systemctl status redis-server再进一步确认端口和连通性# 验证 Redis 是否在默认端口响应 redis-cli ping # 查看 Redis 实际监听端口 sudo netstat -tlnp | grep redis问安装完成后还想加装应用怎么办无需重新安装随时可以手动添加应用# 进入 bench 目录获取应用源码 cd /path/to/frappe-bench bench get-app 应用仓库地址 # 将应用安装到指定站点 bench --site 站点名称 install-app 应用名称安装完成后的检查清单部署结束后建议按下面的清单快速验证一遍确保系统处于健康状态浏览器能正常打开站点地址登录页可访问用初始账号登录后台能进入工作台界面运行bench doctor检查各服务状态是否正常确认 Nginx 与 Supervisor 服务在系统重启后会自动拉起生产环境记得及时修改默认密码并配置 HTTPS 证书如果你在安装过程中选择了生产环境脚本会自动完成 Nginx 与 SSL 证书Certbot的配置开发环境则会保留更便于调试的默认设置。两种模式各有侧重按你的实际用途选择即可。写在最后从手动折腾一整天到回答问题后坐等系统就绪这是 ERPNext 部署体验上的一次质变。这套自动化安装脚本把版本兼容校验、环境配置、依赖安装、应用扩展这些复杂环节全部打包让中小企业和技术新手也能快速拥有自己的企业管理系统。如果你正准备在 Linux 服务器上部署 ERP 系统不妨直接按文中的四条命令走一遍。记得提前确认系统版本、预留足够资源、使用普通用户运行——做到这三点安装过程基本不会出意外。部署过程中遇到问题优先检查 Redis 状态和版本隔离情况大多数故障都能在这两步内找到答案。安装脚本erpnext_install.sh项目文档README.md好的开始是成功的一半现在就去给你的服务器一个一键 ERP的机会吧。【免费下载链接】erpnext_quick_installUnattended install script for ERPNext Versions, 13 to 16项目地址: https://gitcode.com/gh_mirrors/er/erpnext_quick_install创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考