shridh0r/erpnext

ERPNext Docker镜像文档

镜像概述和主要用途

ERPNext Docker镜像是将ERPNext（企业资源规划系统）容器化的解决方案，旨在简化生产环境中的部署流程。通过Docker和docker-compose，用户可以快速搭建ERPNext服务，支持自定义配置、站点管理和版本控制，适用于各类企业的资源规划系统部署需求。

核心功能和特性

• 快速部署：通过docker-compose一键启动，简化部署流程
• 灵活配置：支持替换默认启动命令（如使用gunicorn代替bench start）
• 站点管理：可在容器内创建和管理多个站点
• 版本控制：支持通过构建参数指定ERPNext分支和版本
• 生产就绪：适用于生产环境，提供稳定的运行环境

使用场景和适用范围

适用于需要部署ERPNext系统的企业或组织，尤其是希望通过容器化技术简化部署、管理和版本控制的场景。无论是小型企业的内部资源规划，还是大型组织的多站点管理，均能满足需求。

详细使用方法和配置说明

快速启动

1. 克隆仓库

   bash
   git clone https://github.com/shridarpatil/erpnext-docker.git
   cd erpnext-docker
   

2. 启动容器

   bash
   docker-compose up
   

3. 初始化系统 进入容器执行初始化命令：

   bash
   docker exec -it erpnext-docker_web-app_1 /bin/sh
   bench reinstall --admin-password r00t --mariadb-root-username root --mariadb-root-password root
   bench build
   

4. 访问服务 打开浏览器访问：http://localhost:8005

自定义配置

拉取镜像

bash
docker pull shridh0r/erpnext:tagname

修改启动命令

默认使用bench start启动，可修改docker-compose.yml中web-app服务的命令为gunicorn：

yaml
command: /home/frappe/frappe-bench/env/bin/gunicorn -b 0.0.0.0:8000 --workers 4 --threads 4 -t 120 frappe.app:application --preload

然后启动：

bash
docker-compose up

创建站点

进入容器创建新站点：

bash
# 进入容器
docker exec -it [容器ID或名称] /bin/sh

# 创建站点（PostgreSQL数据库）
bench new-site site1.local --force --db-type postgres

# 安装ERPNext应用
bench install-app erpnext

访问站点：http://localhost:8000

自定义构建

默认构建拉取ERPNext的master分支，可通过构建参数自定义：

bash
docker build . -t shridh0r/erpnext:v12 --build-arg BRANCH=version-12 --build-arg IMAGE_VERSION=v12

构建参数说明

• IMAGE_VERSION：Frappe镜像标签，可在https://hub.docker.com/r/shridh0r/erpnext/tags%E6%9F%A5%E7%9C%8B%E5%8F%AF%E7%94%A8%E6%A0%87%E7%AD%BE
• BRANCH：ERPNext分支名称（如version-12）
• APP_PATH：ERPNext应用路径