可视化安装ERPNext

原创作品，转载请注明出处。

作者：王永建，联系方式：blog@wangyongjian.cn，博客地址:blog.wangyongjian.cn

ERPNext是一个功能齐全的企业业务管理解决方案，可帮助企业在一个系统中记录日常的业务交易。ERPNext是全开源的企业ERP解决方案，不像ODOO和国内的一些开源系统分社区版和企业版，社区版用着各种限制，想好用就得交钱升级，ERPNext代码、数据可以全部自己掌控，技术实力好的可以自行修改代码或定制插件实现个性功能，不过大多数下ERPNext是可以直接配置实现常见业务的，个别业务其实也是可以调整自身的业务来通过适应ERPNext来实现的。由于在安装过程中遇到过一些问题，为此还专门写过一遍不成熟的如何安装的文章，在国内的网络环境中手动安装ERPNext多多少少都需要经历些折磨，网络超时、换源、版本不匹配等问题时常是会遇到的。

我也在尝试探索新的安装方式，降低安装难度已经降低对网络的要求，毕竟官方使用的Github在国内访问不是不很友好，改用国内源也出现过更新时报错等问题，解决此类错误往往比较耗时，就软件而言我们仅仅是使用者，时间最好花在业务上。

本次可视化安装方案采用了1Panel作为交互工具，采用Docker实现可视化方案，告别指令操作。

1Panel 是新一代的 Linux 服务器运维管理面板，更详细的介绍及Demo演示，请到https://1panel.cn/官方网站。

docker是一个用Go语言实现的开源项目，其将应用程序以及应用程序所有的依赖都打包到一个容器中，也就是说应用程序包含了自身运行环境，可以在任何环境都会有一致的表现，也不受外接软件环境的影响。就好比买了一个电水壶，打开包装就能用，不像买了一个组合床开箱后还得组装。有关docker的更多使用信息请到https://www.docker.com/官方网站

1.准备主机平台

在开始安装以前，最好准备一台全新安装的主机，可以是物理机也可以是虚拟机，当然也可以买一个云主机，常见的基于Linux的系统都可以被支持，我是在腾讯云上安装了Ubuntu22.04.3 LTS系统。我的配置很垃圾的，2C4G，2个CPU核心，4G内存，5Mbps的外网带宽。

主机准备好后先把系统更新到最新

sudo apt update
sudo apt upgrade

2.安装1Panel

通过SSH工具登录到准备好的主机平台，我用的WindTerm，很顺手的一个终端工具。

Ubuntu系统执行下面的指令后自动安装，更多安装方式请参考官方在线安装 - 1Panel 文档

curl -sSL https://resource.fit2cloud.com/1panel/package/quick_start.sh -o quick_start.sh && sudo bash quick_start.sh

根据提示设置目录和端口，其他的都是自动完成。完成后参考日志登录1Panel系统。

在浏览器中输入面板地址即可访问，输入安装日志中的用户名和密码即可登录

3.安装OpenResty

在这里通过OpenResty实现反向代理。OpenResty 是一个基于 Nginx 的高性能 Web 应用服务器，更多信息请浏览官网OpenResty® - 开源官方站。在1Panel的应用商店找到OpenResty，点击安装即可。

4、部署ERPNext

4.1新建编排

通过下图新创建一个编排文件。在1Panel里是编码，而在Portainer成为Stack（栈），应该是一样的，对docker研究不深，仅会几个指令而已。

设置配置信息，可以直接在WEB中编辑，也可以执行配置文件的路径，我直接在WEB编辑器里编辑了。编辑完成后，点击右下角的确认按钮，自动开始部署。

配置信息如下，根据需要自行修改。可参考https://github.com/frappe/frappe_docker中文档内容。

version: "3"

services:
  backend:
    image: frappe/erpnext:v15.0.0
    deploy:
      restart_policy:
        condition: on-failure
    volumes:
      - sites:/home/frappe/frappe-bench/sites
      - logs:/home/frappe/frappe-bench/logs

  configurator:
    image: frappe/erpnext:v15.0.0
    deploy:
      restart_policy:
        condition: none
    entrypoint:
      - bash
      - -c
    # add redis_socketio for backward compatibility
    command:
      - >
        ls -1 apps > sites/apps.txt;
        bench set-config -g db_host $$DB_HOST;
        bench set-config -gp db_port $$DB_PORT;
        bench set-config -g redis_cache "redis://$$REDIS_CACHE";
        bench set-config -g redis_queue "redis://$$REDIS_QUEUE";
        bench set-config -g redis_socketio "redis://$$REDIS_QUEUE";
        bench set-config -gp socketio_port $$SOCKETIO_PORT;
    environment:
      DB_HOST: db
      DB_PORT: "3306"
      REDIS_CACHE: redis-cache:6379
      REDIS_QUEUE: redis-queue:6379
      SOCKETIO_PORT: "9000"
    volumes:
      - sites:/home/frappe/frappe-bench/sites
      - logs:/home/frappe/frappe-bench/logs

  create-site:
    image: frappe/erpnext:v15.0.0
    deploy:
      restart_policy:
        condition: none
    volumes:
      - sites:/home/frappe/frappe-bench/sites
      - logs:/home/frappe/frappe-bench/logs
    entrypoint:
      - bash
      - -c
    command:
      - >
        wait-for-it -t 120 db:3306;
        wait-for-it -t 120 redis-cache:6379;
        wait-for-it -t 120 redis-queue:6379;
        export start=`date +%s`;
        until [[ -n `grep -hs ^ sites/common_site_config.json | jq -r ".db_host // empty"` ]] && \
          [[ -n `grep -hs ^ sites/common_site_config.json | jq -r ".redis_cache // empty"` ]] && \
          [[ -n `grep -hs ^ sites/common_site_config.json | jq -r ".redis_queue // empty"` ]];
        do
          echo "Waiting for sites/common_site_config.json to be created";
          sleep 5;
          if (( `date +%s`-start > 120 )); then
            echo "could not find sites/common_site_config.json with required keys";
            exit 1
          fi
        done;
        echo "sites/common_site_config.json found";
        bench new-site frontend --no-mariadb-socket --admin-password=admin --db-root-password=admin --install-app erpnext --set-default;

  db:
    image: mariadb:10.6
    healthcheck:
      test: mysqladmin ping -h localhost --password=admin
      interval: 1s
      retries: 15
    deploy:
      restart_policy:
        condition: on-failure
    command:
      - --character-set-server=utf8mb4
      - --collation-server=utf8mb4_unicode_ci
      - --skip-character-set-client-handshake
      - --skip-innodb-read-only-compressed # Temporary fix for MariaDB 10.6
    environment:
      MYSQL_ROOT_PASSWORD: admin
    volumes:
      - db-data:/var/lib/mysql

  frontend:
    image: frappe/erpnext:v15.0.0
    deploy:
      restart_policy:
        condition: on-failure
    command:
      - nginx-entrypoint.sh
    environment:
      BACKEND: backend:8000
      FRAPPE_SITE_NAME_HEADER: frontend
      SOCKETIO: websocket:9000
      UPSTREAM_REAL_IP_ADDRESS: 127.0.0.1
      UPSTREAM_REAL_IP_HEADER: X-Forwarded-For
      UPSTREAM_REAL_IP_RECURSIVE: "off"
      PROXY_READ_TIMEOUT: 120
      CLIENT_MAX_BODY_SIZE: 50m
    volumes:
      - sites:/home/frappe/frappe-bench/sites
      - logs:/home/frappe/frappe-bench/logs
    ports:
      - "8080:8080"

  queue-long:
    image: frappe/erpnext:v15.0.0
    deploy:
      restart_policy:
        condition: on-failure
    command:
      - bench
      - worker
      - --queue
      - long,default,short
    volumes:
      - sites:/home/frappe/frappe-bench/sites
      - logs:/home/frappe/frappe-bench/logs

  queue-short:
    image: frappe/erpnext:v15.0.0
    deploy:
      restart_policy:
        condition: on-failure
    command:
      - bench
      - worker
      - --queue
      - short,default
    volumes:
      - sites:/home/frappe/frappe-bench/sites
      - logs:/home/frappe/frappe-bench/logs

  redis-queue:
    image: redis:6.2-alpine
    deploy:
      restart_policy:
        condition: on-failure
    volumes:
      - redis-queue-data:/data

  redis-cache:
    image: redis:6.2-alpine
    deploy:
      restart_policy:
        condition: on-failure
    volumes:
      - redis-cache-data:/data

  scheduler:
    image: frappe/erpnext:v15.0.0
    deploy:
      restart_policy:
        condition: on-failure
    command:
      - bench
      - schedule
    volumes:
      - sites:/home/frappe/frappe-bench/sites
      - logs:/home/frappe/frappe-bench/logs

  websocket:
    image: frappe/erpnext:v15.0.0
    deploy:
      restart_policy:
        condition: on-failure
    command:
      - node
      - /home/frappe/frappe-bench/apps/frappe/socketio.js
    volumes:
      - sites:/home/frappe/frappe-bench/sites
      - logs:/home/frappe/frappe-bench/logs

volumes:
  db-data:
  redis-queue-data:
  redis-cache-data:
  sites:
  logs:

部署成功后可以在容器中看到若干ERPNext已经运行的容器了。ERPNext已经部署完成了，下面就是登陆了。

4.2发布ERPNext

部署完成后我使用了OpenResty代理发布ERPNext,根据下图设置反向代理，域名替换为自己可用的域名，并做好解析。

启用HTTPS并设置证书，我申请的腾讯云免费的SSL证书。

5.访问ERPNext

完成上述设置后，就可以通过域名来访问新安装的ERPNext了。用户名：Administrator，密码：admin。好了，可用登录系统了。

后面就是如何初始化系统了，网上资料一大把，这里不做重复阐述了。

欢迎把本文转发给你的朋友，也许他们正需要。