Frappe和ERPNext安装部署

20 Jun 2021

本文主要整理说明安装ERPNext v13的主要流程，以Ubuntu 20.04基础系统为例。

系统环境准备

安装基础依赖包：

apt install git mariadb-server redis-server wkhtmltopdf

安装Python库相关依赖包：

apt install libmysqlclient-dev python3-dev python3-pip

安装JavaScript库相关依赖包：
```
apt install phantomjs python2 xvfb
```

安装v12版本Node.js环境：

wget https://nodejs.org/dist/v12.22.1/node-v12.22.1-linux-x64.tar.xz
tar xf node-v12.22.1-linux-x64.tar.xz
ln -s $PWD/node-v12.22.1-linux-x64/bin/node $HOME/.local/bin/
ln -s $PWD/node-v12.22.1-linux-x64/bin/npm $HOME/.local/bin/
npm install -g yarn

数据库初始化配置

调整MariaDB配置文件/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服务：
```
service mysql start
```
运行mysql_secure_installation初始化MariaDB。

调整MariaDB的root访问权限：

UPDATE mysql.user SET plugin = '' WHERE user = 'root' AND plugin = 'unix_socket';
FLUSH PRIVILEGES;

Frappe和ERPNext安装

Frappe安装（之后所有命令在frappe-bench目录中执行）：

bench init --verbose --frappe-branch version-13 --skip-assets frappe-bench

ERPNext安装：

bench get-app --branch version-13 --skip-assets https://github.com/frappe/erpnext.git

编译资源文件：
```
bench build --force
```

创建初始站点：

bench new-site example.com
bench --site example.com install-app erpnext

微调

在/etc/hosts添加以下条目，限制后台访问Gravatar服务（感觉可以建议官方在sites/common_site_config.json中添加enable_gravatar配置项）：
```
127.0.0.1 secure.gravatar.com
```
解决创建用户失败的问题，修改Procfile（详见这里的讨论）：
```
web: bench serve --port 8000 --noreload
```