在Ubuntu Server 18.04版本安装ERPNEXT(100%成功)

蒋联

2023-12-01

之前参考过许多手册和文档安装开源的ERP，都非常麻烦，而且经常遇到各种问题，经过多次实践，结合了几篇国内文章与国外的文章，编写此教程，相信可一次成功。

建议硬件配置

CPU:2核

内存:2G

硬盘:10G

更新包源为国内源

备份原有软件源文件

cp /etc/apt/sources.list /etc/apt/sources.list.bak

更新源列表

nano /etc/apt/sources.list

内容


deb http://mirrors.aliyun.com/ubuntu/ bionic main restricted universe multiverse
deb http://mirrors.aliyun.com/ubuntu/ bionic-security main restricted universe multiverse
deb http://mirrors.aliyun.com/ubuntu/ bionic-updates main restricted universe multiverse
deb http://mirrors.aliyun.com/ubuntu/ bionic-proposed main restricted universe multiverse
deb http://mirrors.aliyun.com/ubuntu/ bionic-backports main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ bionic main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ bionic-security main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ bionic-updates main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ bionic-proposed main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ bionic-backports main restricted universe multiverse
deb [arch=arm64,ppc64el,amd64] http://mirrors.tuna.tsinghua.edu.cn/mariadb/repo/10.4/ubuntu bionic main

系统更新及软件升级

sudo apt-get update && sudo apt-get upgrade

安装python以及检查python的版本号

sudo apt install python-minimal –y

python -V

安装ERPNext软件所依赖的软件包

sudo apt -y install git build-essential python-setuptools python-dev libffi-dev libssl-dev

安装python的pip包

下载安装包，并运行更新

wget https://bootstrap.pypa.io/get-pip.py

sudo python get-pip.py

检查是否为最新版，如果不为最新版，则进行升级

sudo pip install --upgrade pip setuptools

安装ansible的python框架包

sudo pip install ansible

（在运行中可能存在连接失败的情况，多运行两次即可，如果一直不行，可以开启自己的移动号码的手机热点，再进行安装，如果依旧不行，则需要更改国内源，如sudo pip install ansible -i https://pypi.tuna.tsinghua.edu.cn/simple）

安装yarn构建管理工具

先安装curl软件

sudo apt -y install curl

加入apt中yarn的安装源

curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add -

echo "deb https://dl.yarnpkg.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/yarn.list

成功后，安装yarn构建管理工具

sudo apt -y update && sudo apt -y install yarn

安装MariaDb数据库

由于国外源较慢，因为采用清华大学镜像以下进行Mariadb的安装

加入清华源

sudo apt-get install software-properties-common

sudo apt-key adv --fetch-keys 'https://mariadb.org/mariadb_release_signing_key.asc'

sudo add-apt-repository 'deb [arch=amd64,arm64,ppc64el] http://mirrors.tuna.tsinghua.edu.cn/mariadb/repo/10.4/ubuntu bionic main'

安装数据库

sudo apt update

sudo apt install mariadb-server libmysqlclient-dev

配置数据库配置文件

sudo nano /etc/mysql/my.cnf

在my.cnf中配置相应的数据库启动参数，主要是设置innodb的文件类型以及字符编码集

[mysqld]

innodb-file-format=barracuda

innodb-file-per-table=1

innodb-large-prefix=1

character-set-client-handshake = FALSE

character-set-server = utf8mb4

collation-server = utf8mb4_unicode_ci



[mysql]

default-character-set = utf8mb4

重启Maraidb服务，并配置数据库启动时自动启动

sudo systemctl restart mariadb

sudo systemctl enable mariadb

设置数据库的安全设置

sudo mysql_secure_installation

首先确认是否作用unix_socket连接，选择N

包括设置root的密码以及以下设置

Remove anonymous users? Y
Disallow root login remotely? N
Remove test database and access to it? y
Reload privilege tables now? Y

安装Nginx，Node.js以及Redis

下载Node.js的源

sudo curl --silent --location https://deb.nodesource.com/setup_10.x | sudo bash -

成功后，进行相关服务的安装和运行，并将相关的服务加入到启动项

sudo apt -y install nginx nodejs redis-server

sudo systemctl start nginx

sudo systemctl enable nginx

sudo systemctl start redis-server

sudo systemctl enable redis-server

安装wkhtmltopdf和相关字体，用于网页转PDF和图片

sudo apt -y install libxrender1 libxext6 xfonts-75dpi xfonts-base

sudo apt-get install xvfb

sudo apt install wkhtmltopdf

sudo mv /usr/bin/wkhtmltopdf /usr/bin/wkhtmltopdf.sh

sudo mv /usr/bin/wkhtmltoimage /usr/bin/wkhtmltoimage.sh

echo 'exec xvfb-run -a -s "-screen 0 640x480x16" wkhtmltopdf.sh "$@"' | sudo tee /usr/local/bin/wkhtmltopdf >/dev/null && sudo chmod a+x /usr/local/bin/wkhtmltopdf

echo 'exec xvfb-run -a -s "-screen 0 640x480x16" wkhtmltoimage.sh "$@"' | sudo tee /usr/local/bin/wkhtmltoimage >/dev/null && sudo chmod a+x /usr/local/bin/wkhtmltoimage

检查版本

wkhtmltopdf -V

检查是否可以运行

wkhtmltopdf http://www.baidu.com output.pdf

安装和创建虚拟的python运行环境

首先，创建erpnext目录

mkdir erpnext

cd erpnext/

安装虚拟环境

sudo apt install virtualenv

在erpnext目录下创建erpnext运行环境

virtualenv .

（注意命令中包括.这个字符，表示当前目录）

有可能安装连接超时失败，因此可以参考如下操作

mkdir ~/.pip

nano ~/.pip/pip.conf

内容如下：

[global]

index-url = http://mirrors.aliyun.com/pypi/simple/



[install]

trusted-host=mirrors.aliyun.com

保存后再执行virtualenv .

激活当前的虚拟运行环境

source ./bin/activate

安装bench工具

此文件用于管理多站点，以运行erpnext应用

git clone https://github.com/frappe/bench bench-repo

sudo pip install -e bench-repo

初始化bench

bench init --frappe-branch master --frappe-path https://github.com/frappe/frappe.git frappe-bench

进入frapper-bench目录

cd frappe-bench/

获取erpnext应用程序

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

创建网站

bench new-site testsite

注意你可根据自己的域名，进行变更testsite

在上一步新建的站点上安装erpnext应用

bench --site testsite install-app erpnext

启动应用，并进行测试

bench start

如果出现错误，找不到werkzeug类库

env/bin/pip3.6 install werkzeug==0.9

其中，如果没有外网的指定域名，无法访问刚才建的域名站点，可以在自己的电脑上更改hosts文件，加入域名对应的IP即可以访问。

c:\windows\system32\drivers\etc\hosts

在更改此文件内容时，需要更新此文件安全属性，将此文件的可写可读的权限设置给当前登陆的用户

打开文件根据自己的IP加入对应关系

192.168.56.104 testsite

最后，打开您的web浏览器，打开服务器IP地址并输入8000端口号http://testsite:8000，您将看到ERPNext登录屏幕。在这里，你必须按照你创建新网站时设置的用户名“管理员”和密码登录。