Frappe_docker项目：如何仅安装Frappe框架而不安装ERPNext应用

背景说明

Frappe框架是一个基于Python的全栈Web应用框架，而ERPNext则是构建在该框架之上的知名开源企业管理软件。许多开发者希望单独使用Frappe框架进行二次开发，而不需要安装完整的ERPNext应用。但在使用官方Docker部署方案时，系统默认会同时安装两者，这给只想学习Frappe框架的开发者带来了困扰。

技术原理分析

通过分析Frappe_docker项目的实现机制，我们发现：

1. 官方Docker镜像采用了"一体化打包"策略，基础镜像中已经同时包含了Frappe框架和ERPNext应用的代码
2. 在创建新站点时，默认会安装所有预装应用（包括ERPNext）
3. 环境变量配置只能控制版本号，无法完全移除预装应用

解决方案详解

方法一：创建站点时排除ERPNext

虽然ERPNext代码存在于镜像中，但可以通过以下命令创建仅含Frappe框架的站点：

docker-compose exec backend bench new-site \
--mariadb-user-host-login-scope=% \
--db-root-password admin \
--admin-password admin \
yourdomain.com \
--install-app=frappe

关键参数说明：

• --install-app=frappe 明确指定只安装frappe核心框架
• 必须确保不包含--install-app=erpnext参数

方法二：构建自定义镜像

如需完全移除ERPNext代码，需要自定义Docker镜像构建：

1. 克隆frappe_docker仓库
2. 修改Dockerfile，删除与ERPNext相关的安装步骤
3. 重建镜像并部署

构建步骤示例：

FROM frappe/frappe-worker:latest

# 移除ERPNext相关安装
RUN bench get-app frappe --branch ${FRAPPE_VERSION}

方法三：站点后期清理

对于已创建的站点，可以通过以下命令移除ERPNext：

bench uninstall-app erpnext

注意事项

1. 某些Frappe功能可能依赖ERPNext组件，移除后需自行实现相关功能
2. 生产环境建议使用方法二构建纯净镜像
3. 开发环境下使用方法一更为便捷

最佳实践建议

对于不同场景下的推荐方案：

1. 学习/开发环境：使用方法一创建纯净站点
2. 生产环境：构建自定义镜像确保系统纯净
3. 已有系统迁移：使用方法三进行应用清理

通过以上方法，开发者可以灵活控制Frappe框架的运行环境，专注于框架本身的学习和开发工作。