往常节假日,都是呆在家里看别人堵,这回老苏也出门凑了个热闹,
28
号早上
7
点半出的门
2
点半往回走的
一天啥也没干,就开了
7
个小时的车去舅舅家蹭了顿饭。还别说,那个田园鸡味道是真不错。
车很久没开了,但这回起码两个月不用遛了。
本文是应网友
潇雨
的要求折腾的。
**什么是
ERPNext
?**
ERPNext
是一种免费的、开源的企业资源规划(
ERP
)软件,它提供了一套完整的企业解决方案,包括会计、采购、销售、库存、制造、
CRM
等功能。
ERPNext
旨在为中小型企业提供一种简单、易用、灵活的
ERP
系统,以帮助企业管理业务流程、优化运营效率、提高生产力和盈利能力。
ERPNext
建立在
Frappe
框架之上,这是一个使用
Python
和
JavaScript
构建的全栈
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:6379REDIS_QUEUE: redis-queue:6379REDIS_SOCKETIO: redis-socketio:6379SOCKETIO_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.6container_name: ${APP_NAME}-db
healthcheck:test: mysqladmin ping -h localhost --password=${DB_PASSWORD}interval: 1s
retries:15deploy: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.6environment: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:8000FRAPPE_SITE_NAME_HEADER: frontend
SOCKETIO: websocket:9000UPSTREAM_REAL_IP_ADDRESS: ${APP_HTTP_IP}UPSTREAM_REAL_IP_HEADER: X-Forwarded-For
UPSTREAM_REAL_IP_RECURSIVE:"off"PROXY_READ_TIMOUT:120CLIENT_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
: 主要影响生成的容器名称的前缀
APP_VERSION
:ERPNext
的版本, 老苏测试过v14.22.3
和v14.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
软件启动后,正常情况下,
erp-configurator
和
erp-create-site
会停掉,因为它们已经完成了自己的使命
但如果出现👇的错误
在老苏的机器上还是会有一定的几率发生,不要慌,我们还有补救措施,请往下看
则还需要执行一次下面的命令
参考文档:
# 设置新站点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
其中:
<site-name>
对应于docker-compose.yml
中前端的service name
的名称frontend
,这个在nginx
的设置中也用到了;<管理员密码>
对应前面env.txt
中的APP_PASSWORD
的值;<数据库root账户的密码>
对应前面env.txt
中的DB_ROOT_PASSWORD
的值;
之所以会出现这样的情况,应该还是容器编排的启动顺序上有问题,这些命令按道理在
erp-create-site
容器中应该是要被执行的
之后,如果容器停止了,再启动也是需要时间的,你太快打开网址,会看到下面这样的界面
登录成功后,第一次还需要设置
语言有时候能弹出下拉,但是有时候又不行,不过可以直接输入,现在已经支持
简体中文
了
国家支持下拉,但可能输入更快
设置用户
设置公司
设置组织
设置完成
现在可以开始使用了
至于反代,老苏试过
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/
版权归原作者 杨浦老苏 所有, 如有侵权,请联系我们删除。