开源企业资源规划ERPNext的安装

往常节假日,都是呆在家里看别人堵,这回老苏也出门凑了个热闹,28号早上 7 点半出的门

开源企业资源规划ERPNext的安装_第1张图片

2 点半往回走的

开源企业资源规划ERPNext的安装_第2张图片

一天啥也没干,就开了 7 个小时的车去舅舅家蹭了顿饭。还别说,那个田园鸡味道是真不错。

车很久没开了,但这回起码两个月不用遛了。


本文是应网友 潇雨 的要求折腾的。

什么是 ERPNext ?

ERPNext 是一种免费的、开源的企业资源规划(ERP)软件,它提供了一套完整的企业解决方案,包括会计、采购、销售、库存、制造、CRM 等功能。ERPNext 旨在为中小型企业提供一种简单、易用、灵活的 ERP 系统,以帮助企业管理业务流程、优化运营效率、提高生产力和盈利能力。ERPNext 建立在 Frappe 框架之上,这是一个使用 PythonJavaScript 构建的全栈 web 应用程序框架。

前期准备

在网友提出要求之前,老苏也曾经尝试过安装 ERPNext,但都以失败告终。

首先尝试了英文版,但由于涉及多个容器,可能有些地方改漏了、改错了,导致出现了错误,因为工作原因,也没有太多的时间去深入研究。

之后又尝试了中文版,这是一个All in one 的版本,安装相对简单。但遗憾的是,老苏一直遇到数据库出错的问题。由于老苏的机器内存较小,初步怀疑这可能是导致问题的原因。此外,由于容器内反复启动,导致机器的 CPU 占用率也急剧上升,最终只能放弃了。

docker-compose.yml

这次老苏牺牲了几个晚上,认真把 docker-compose.yml 好好整理了一下。如果你不知道什么含义,不建议你直接改这个文件,老苏已经把需要修改的内容,单独拎了出来放在了env.txt

docker-compose.yml 是基于官网 https://github.com/frappe/frappe_docker/blob/main/pwd.yml 修改

version: "3"

services:
  backend:
    image: frappe/erpnext:${APP_VERSION}
    container_name: ${APP_NAME}-backend
    deploy:
      restart_policy:
        condition: on-failure
    volumes:
      - sites:/home/frappe/frappe-bench/sites
      - logs:/home/frappe/frappe-bench/logs
      
  configurator:
    image: frappe/erpnext:${APP_VERSION}
    container_name: ${APP_NAME}-configurator
    deploy:
      restart_policy:
        condition: none
    entrypoint:
      - bash
      - -c
    depends_on:
      - db
    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_SOCKETIO";
        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
      REDIS_SOCKETIO: redis-socketio:6379
      SOCKETIO_PORT: "9000"
    volumes:
      - sites:/home/frappe/frappe-bench/sites
      - logs:/home/frappe/frappe-bench/logs
      
  create-site:
    image: frappe/erpnext:${APP_VERSION}
    container_name: ${APP_NAME}-create-site
    depends_on:
      - configurator
    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 240 db:3306;
        wait-for-it -t 120 redis-cache:6379;
        wait-for-it -t 120 redis-queue:6379;
        wait-for-it -t 120 redis-socketio: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=${APP_PASSWORD} --db-root-password=${DB_ROOT_PASSWORD} --install-app erpnext --set-default;

  db:
    image: mariadb:10.6
    container_name: ${APP_NAME}-db
    healthcheck:
      test: mysqladmin ping -h localhost --password=${DB_PASSWORD}
      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: ${DB_ROOT_PASSWORD}
    volumes:
      - ./data:/var/lib/mysql
    #ports:
    #  - "${DB_PORT}:3306"

  frontend:
    image: frappe/erpnext:${APP_VERSION}
    container_name: ${APP_NAME}-frontend
    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: ${APP_HTTP_IP}
      UPSTREAM_REAL_IP_HEADER: X-Forwarded-For
      UPSTREAM_REAL_IP_RECURSIVE: "off"
      PROXY_READ_TIMOUT: 120
      CLIENT_MAX_BODY_SIZE: 50m
    volumes:
      - sites:/home/frappe/frappe-bench/sites
      - logs:/home/frappe/frappe-bench/logs
    ports:
      - "${APP_HTTP_PORT}:8080"

  queue-default:
    image: frappe/erpnext:${APP_VERSION}
    container_name: ${APP_NAME}-queue-default
    deploy:
      restart_policy:
        condition: on-failure
    command:
      - bench
      - worker
      - --queue
      - default
    volumes:
      - sites:/home/frappe/frappe-bench/sites
      - logs:/home/frappe/frappe-bench/logs

  queue-long:
    image: frappe/erpnext:${APP_VERSION}
    container_name: ${APP_NAME}-queue-long
    deploy:
      restart_policy:
        condition: on-failure
    command:
      - bench
      - worker
      - --queue
      - long
    volumes:
      - sites:/home/frappe/frappe-bench/sites
      - logs:/home/frappe/frappe-bench/logs

  queue-short:
    image: frappe/erpnext:${APP_VERSION}
    container_name: ${APP_NAME}-queue-short
    deploy:
      restart_policy:
        condition: on-failure
    command:
      - bench
      - worker
      - --queue
      - short
    volumes:
      - sites:/home/frappe/frappe-bench/sites
      - logs:/home/frappe/frappe-bench/logs

  redis-queue:
    image: redis:6.2-alpine
    container_name: ${APP_NAME}-redis-queue
    deploy:
      restart_policy:
        condition: on-failure
    volumes:
      - ./redis-queue-data:/data

  redis-cache:
    image: redis:6.2-alpine
    container_name: ${APP_NAME}-redis-cache
    deploy:
      restart_policy:
        condition: on-failure
    volumes:
      - ./redis-cache-data:/data

  redis-socketio:
    image: redis:6.2-alpine
    container_name: ${APP_NAME}-redis-socketio
    deploy:
      restart_policy:
        condition: on-failure
    volumes:
      - ./redis-socketio-data:/data

  scheduler:
    image: frappe/erpnext:${APP_VERSION}
    container_name: ${APP_NAME}-scheduler
    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:${APP_VERSION}
    container_name: ${APP_NAME}-websocket
    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:
  logs:
  sites:

env.txt

下面是 env.txt 的内容,之所以没用 .env 是为了方便在 File Station 中方便修改,但是带来的不方便之处是启动时需要指定 --env-file,当然在 docker-compose.yml 中指定也是可以的

# ERPNext config
APP_NAME=erp
APP_VERSION=v14.23.0
APP_HTTP_IP=192.168.0.197
APP_HTTP_PORT=6380
APP_PASSWORD=admin

# MariaDB config
DB_HOST=db
DB_PASSWORD=twj9nwyoutRei9C4VV
DB_ROOT_PASSWORD=4aixKdghP3j56hPB8k
DB_PORT=3336
  • APP_NAME: 主要影响生成的容器名称的前缀

开源企业资源规划ERPNext的安装_第3张图片

  • APP_VERSIONERPNext 的版本, 老苏测试过v14.22.3v14.23.0,其他版本没试过;
  • APP_HTTP_IP:主机 IP,要根据你自己的群晖主机 IP 修改;
  • APP_HTTP_PORT:这是访问 ERPNext 服务的的本地端口,不冲突就行;
  • APP_PASSWORD:管理员密码,建议登录成功之后再改;
  • DB_HOST:数据库主机,不要改;
  • DB_PASSWORD:数据库密码,建议改;
  • DB_ROOT_PASSWORD:数据库管理员密码,建议改;
  • DB_PORT:数据库本地端口,不冲突就行,默认老苏在 docker-compose.yml 中已经注释掉了端口;

上面两个文件,老苏放在了 https://github.com/wbsu2003/synology/tree/main/ERPNext

安装

采用 docker-compose 方式运行

# 新建文件夹 erpnext 和 子目录
mkdir -p /volume2/docker/erpnext/{data,redis-cache-data,redis-queue-data,redis-socketio-data}

# 进入 erpnext 目录
cd /volume2/docker/erpnext

# 将 docker-compose.yml 和 env.txt 两个文件放入当前目录
  
# 一键运行
docker-compose --env-file env.txt up -d

如果一键启动总是超时,可以加个 timeout 参数

# 超时设置
docker-compose --env-file env.txt up -d --timeout 120

运行

如果你没有修改 APP_HTTP_PORT的值,你可以在浏览器中打开 http://群晖IP:6380来访问 ERPNext.

第一次启动的过程是比较长的,因为脚本中使用了 wait-for-it,好几处都是 -t 120,老苏甚至把数据库的改为了 wait-for-it -t 240 db:3306;,如果能看到登录界面,说明安装成功了

  • 默认的账号是 Administrator,密码就是前面设置的 APP_PASSWORD 的值,如果你没改的话,那就是 admin

开源企业资源规划ERPNext的安装_第4张图片

软件启动后,正常情况下,erp-configuratorerp-create-site 会停掉,因为它们已经完成了自己的使命

开源企业资源规划ERPNext的安装_第5张图片

但如果出现的错误

在老苏的机器上还是会有一定的几率发生,不要慌,我们还有补救措施,请往下看

开源企业资源规划ERPNext的安装_第6张图片

则还需要执行一次下面的命令

参考文档:

  • https://github.com/frappe/frappe_docker/blob/main/docs/site-operations.md
  • https://github.com/frappe/frappe_docker/issues/711
# 设置新站点
docker-compose --env-file env.txt exec backend bench new-site <site-name> --no-mariadb-socket --admin-password=<管理员密码> --db-root-password=<数据库root账户的密码> --install-app erpnext --set-default

# 示例
docker-compose --env-file env.txt exec backend bench new-site frontend --no-mariadb-socket --admin-password=admin --db-root-password=4aixKdghP3j56hPB8k --install-app erpnext --set-default

其中:

  • 对应于 docker-compose.yml 中前端的 service name 的名称 frontend,这个在 nginx 的设置中也用到了;
  • <管理员密码> 对应前面 env.txt 中的 APP_PASSWORD 的值;
  • <数据库root账户的密码> 对应前面 env.txt 中的 DB_ROOT_PASSWORD 的值;

开源企业资源规划ERPNext的安装_第7张图片

之所以会出现这样的情况,应该还是容器编排的启动顺序上有问题,这些命令按道理在 erp-create-site 容器中应该是要被执行的

之后,如果容器停止了,再启动也是需要时间的,你太快打开网址,会看到下面这样的界面

开源企业资源规划ERPNext的安装_第8张图片

登录成功后,第一次还需要设置

开源企业资源规划ERPNext的安装_第9张图片

语言有时候能弹出下拉,但是有时候又不行,不过可以直接输入,现在已经支持 简体中文

开源企业资源规划ERPNext的安装_第10张图片

国家支持下拉,但可能输入更快

开源企业资源规划ERPNext的安装_第11张图片

设置用户

开源企业资源规划ERPNext的安装_第12张图片

设置公司

开源企业资源规划ERPNext的安装_第13张图片

设置组织

开源企业资源规划ERPNext的安装_第14张图片

设置完成

开源企业资源规划ERPNext的安装_第15张图片

现在可以开始使用了

开源企业资源规划ERPNext的安装_第16张图片

至于反代,老苏试过 npm ,正常设置就可以,无论你的域名有没有端口,都是可以正常访问的。

参考文档

ERPNext: Free and Open Source Cloud ERP Software
地址:https://erpnext.com/

frappe/erpnext: Free and Open Source Enterprise Resource Planning (ERP)
地址:https://github.com/frappe/erpnext

frappe/frappe_docker: Docker images for production and development setups of the Frappe framework and ERPNext
地址:https://github.com/frappe/frappe_docker
Home
地址:https://docs.erpnext.com/

你可能感兴趣的:(群晖,docker,ERP)