安装环境：ubuntu22.04

一、创建frappe用户

adduser frappe
usermod -aG sudo frappe
su frappe

二、安装依赖包

1、安装

curl -sL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install -y python3.10-dev python3-setuptools python3-pip python3-distutils python3.10-venv software-properties-common mariadb-server mariadb-client redis-server nodejs xvfb libfontconfig libmysqlclient-dev nginx git ansible pkg-config libcairo2-dev libjpeg-dev libgif-dev librsvg2-dev

2、配置mariadb

sudo nano /etc/mysql/my.cnf

添加以下部分

[mysqld]
character-set-client-handshake = FALSE 
character-set-server = utf8mb4 
collation-server = utf8mb4_unicode_ci 

[mysql]
default-character-set = utf8mb4

重启mariadb

sudo service mysql restart

3、mysql初始化安全配置

sudo mysql_secure_installation

# 注：运行结果用 ··· 代替
Enter current password for root (enter for none):  # 输入root(mysql)的密码，初次安装默认没有，直接回车 
 ... 
Switch to unix_socket authentication [Y/n] n # 是否切换到unix套接字身份验证[Y/n]
 ... 
Change the root password? [Y/n] y #是否设置root用户密码
New password: # 新密码
Re-enter new password:  # 再次输入密码
 ... 
Remove anonymous users? [Y/n] y # 是否删除匿名用户，建议删除
 ... 
Disallow root login remotely? [Y/n] n # 是否禁止root远程登录，建议不开启
 ... 
Remove test database and access to it? [Y/n] n # 是否删除test数据库，可以保留
...
Reload privilege tables now? [Y/n] y # 是否重新加载权限表，也可以直接回车
 ... 
Thanks for using MariaDB! # 看到这句话证明设置成功

4、修改redis端口为11000

sudo nano /etc/redis/redis.conf

port 11000

sudo systemctl restart redis

5、将Python的pip源改成国内源，有助于后面安装frappe时提高速度和成功率

pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/
pip config set install.trusted-host mirrors.aliyun.com

6、安装yarn

sudo npm install -g yarn

#yarn config get registry查看源, 如果官方源请设置为以下国内源，如有报错信息，请忽略。

yarn config set registry https://registry.npmmirror.com/ --global  && \
yarn config set disturl https://npmmirror.com/package/dist --global && \
yarn config set sass_binary_site https://cdn.npmmirror.com/binaries/node-sass --global  && \
yarn config set electron_mirror https://registry.npmmirror.com/binary.html?path=electron/ --global  && \
yarn config set puppeteer_download_host https://registry.npmmirror.com/binary.html --global  && \
yarn config set chromedriver_cdnurl https://cdn.npmmirror.com/binaries/chromedriver --global  && \
yarn config set operadriver_cdnurl https://cdn.npmmirror.com/binaries/operadriver --global  && \
yarn config set phantomjs_cdnurl https://cdn.npmmirror.com/binaries/phantomjs --global  && \
yarn config set selenium_cdnurl https://cdn.npmmirror.com/binaries/selenium --global  && \
yarn config set node_inspector_cdnurl https://cdn.npmmirror.com/binaries/node-inspector --global


npm config set canvas_binary_host_mirror=https://registry.npmmirror.com/-/binary/canvas/ && \
npm config set registry https://registry.npmmirror.com/ && \
npm set registry https://registry.npmmirror.com/ && \
npm set disturl https://npmmirror.com/package/dist && \
npm set sass_binary_site https://cdn.npmmirror.com/binaries/node-sass && \
npm set electron_mirror https://registry.npmmirror.com/binary.html?path=electron/ && \
npm set puppeteer_download_host https://registry.npmmirror.com/binary.html && \
npm set chromedriver_cdnurl https://cdn.npmmirror.com/binaries/chromedriver && \
npm set operadriver_cdnurl https://cdn.npmmirror.com/binaries/operadriver && \
npm set phantomjs_cdnurl https://cdn.npmmirror.com/binaries/phantomjs && \
npm set selenium_cdnurl https://cdn.npmmirror.com/binaries/selenium && \
npm set node_inspector_cdnurl https://cdn.npmmirror.com/binaries/node-inspector

三、安装bench，erpnext系统的命令行管理工具

sudo -H pip3 install frappe-bench

四、安装frappe框架

bench init --frappe-branch version-15 frappe-bench --verbose

sudo chmod -R o+rx /home/frappe

五、安装erpnext

1、进入bench目录

cd frappe-bench

2、新建站点

bench new-site erpnext

3、下载APP

bench get-app --branch version-15 erpnext
bench get-app --branch version-15 hrms

4、查看下载的APP

bench version --format table

5、安装APP

bench --site erpnext install-app erpnext
bench --site erpnext install-app hrms

6、启动bench

bench start

7、Enable Scheduler

bench --site erpnext enable-scheduler

8、关闭维护模式

bench --site erpnext set-maintenance-mode off

9、安装supervisor

sudo apt install supervisor

10、设置nginx

bench setup nginx

11、重启supervisor

sudo supervisorctl restart all

12、开启生产模式

sudo bench setup production frappe

13、访问页面

六、常用命令

1、查看已安装APP

bench version

2、重启服务

sudo bench restart

这将重启 ERPNext 的所有组件，包括数据库、Web 服务器、Celery 等；

在生产环境中使用 Supervisor 来管理 ERPNext 服务，可以运行以下命令来重启所有服务：

sudo supervisorctl restart all

• 这将重启 Supervisor 管理的所有进程，包括 ERPNext。

3、APP升级

bench update

4、修改端口号

bench set-nginx-port site_name port_number
sudo service nginx reload