ERPNext安装过程中遇到的坑及对应解决方案

一、系统要求

1. MacOS操作系统
2. Debian / Ubuntu

二、先决条件

Version 13:

Python 3.7 or Python 3.8

Node.js 14

MariaDB 10.3+

Version 14:

Python 3.10 or Python 3.11

Node.js 14 or 16

MariaDB 10.6.6+

Version 15/Nightly:

Python 3.10 or Python 3.11

Node.js 18

MariaDB 10.6.6+

Common for all Frappe versions:

Redis 6 (caching and realtime updates)

yarn 1.12+ (js dependency manager)

pip 20+ (py dependency manager)

wkhtmltopdf (version 0.12.5 with patched qt) (for pdf generation)

cron (bench's scheduled jobs: automated certificate renewal, scheduled backups)

NGINX (proxying multitenant sites in production)

三、主要安装步骤(Ubuntu)：

1.首先安装依赖环境

主要安装步骤：

1）安装git python redis

sudo apt install git python-dev python-pip redis-server

2）安装 MariaDB

sudo apt install software-properties-common

如果您使用的是早于 20.04 的 Ubuntu 版本，请在安装 MariaDB 之前运行此版本：

sudo apt-key adv --recv-keys --keyserver hkp://keyserver.ubuntu.com:80 0xF1656F24C74CD1D8
sudo add-apt-repository 'deb [arch=amd64,i386,ppc64el] http://ftp.ubuntu-tw.org/mirror/mariadb/repo/10.3/ubuntu xenial main'

如果您使用的是 Ubuntu 20.04 版本，则 MariaDB 在默认存储库中可用，您可以直接运行以下命令进行安装：

sudo apt-get update
sudo apt-get install mariadb-server

在此安装过程中，系统将提示您设置 MySQL root 密码。如果未出现提示，则必须自行初始化MySQL服务器设置。您可以通过运行以下命令来执行此操作：

mysql_secure_installation

请记住：仅当设置过程中未提示您输入密码时才运行它。

记住这个密码非常重要，因为它以后会很有用。您还需要 MySQL 数据库开发文件。

apt-get install mariadb-client-10.3

现在，编辑 MariaDB 配置文件。

sudo vim /etc/mysql/my.cnf

并添加此配置

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

[mysql]
default-character-set = utf8mb4

注意：需要同时修改50-server.cnf中的

• #bind-address = 127.0.0.1
• collation-server = utf8mb4_unicode_ci。

现在，只需重新启动mysql服务，您就可以开始了。

service mysql restart

3）安装Node

我们建议使用 nvm 安装Node

curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.39.3/install.sh | bash

注意：如果没有代理，可以采用以下命令：

curl -o https://gitee.com/mirrors/nvm/raw/v0.39.3/install.sh | bash

安装 nvm 后，您可能需要关闭终端并打开另一个终端。现在运行以下命令来安装节点。

nvm install 18

通过运行以下命令来验证安装：

node -v
# output
v18.18.2

最后，使用yarn npm

npm install -g yarn

4）安装 wkhtmltopdf

apt-get install xvfb libfontconfig wkhtmltopdf

2.其次安装Bench CLI

1）通过 pip3 安装工作台

pip3 install frappe-bench

2）通过检查版本确认工作台安装

bench --version

# output
5.2.1

3）创建您的第一个工作台文件夹。

cd ~
bench init frappe-bench

4）创建 frappe-bench 文件夹后，将目录更改为该文件夹并运行以下命令

bench start

恭喜，您已将 bench 安装到您的系统上。

3.安装ERPNext应用

1）安装站点

 bench new-site erpnext.local

2）获取ERPNext应用

bench get-app --branch version-14 erpnext https://github.com/frappe/erpnext.git

3）安装ERPNext应用

 bench --site [site-name] install-app [app-name]

4）启动ERPNext应用

bench start

5）访问ERPNext应用

需要在hosts中增加对应的域名绑定

127.0.0.1 erpnext.local

注意：在安装ERPNext应用先不要启动，并访问应用，否则即将不能安装ERPNext应用

4.访问ERPNext应用

http://erpnext.local:8000

详见流氓锈才的相关教程：

1）视频教程：ERPNext V14保姆级安装指南

2）官方教程：https://frappeframework.com/docs/user/en/installation

3）文档教程：https://gitee.com/qinyanwan/erpnext-related-documents/blob/master/%E5%AE%89%E8%A3%85%E6%96%87%E6%A1%A3/ERPNext%20v14%E4%BF%9D%E5%A7%86%E7%BA%A7%E5%AE%89%E8%A3%85%E6%8C%87%E5%8D%97%EF%BC%8820230410%E6%9B%B4%E6%96%B0%EF%BC%89.md

四.汉化及本地化

1.安装余则霖的ERPNext界面汉化，详细可以查看gitee相关项目

bench get-app https://gitee.com/yuzelin/erpnext_chinese.git

2.安装余则霖的ERPNext开箱即用，详细可以查看gitee相关项目（14版本）

bench get-app --branch version-14 https://gitee.com/yuzelin/erpnext_oob.git

3.安装ERPNext开箱即用APP(有多个站点且未设默认站点的请加--site参数）

bench --site erpnext.local install-app erpnext_oob

注意如果报错，请先执行bench update

bench update

4.清除缓存，重新编译

bench clear-cache && bench clear-website-cache

bench build --app erpnext_oob --force

5.重新启动

bench start

五.安装过程可能遇到的问题

1.pymysql.err.ProgrammingError: (1064, “You have an error in your SQL syntax; check the manual that corresponds to your MariaDB server version for the right syntax to use near

解决方案：

bench update

2.Database already exists error in installation of bench

解决方案：

删除对应的数据库_12a7e9d5d6b5d313，重新执行安装过程