本教程适用于以下操作系统版本
- Debian 12 (Bookworm)
- Debian 11 (Bullseye)
- Debian 9 (Stretch)
本页内容
- 先决条件
- 创建新用户
- 安装 Python 3.10
- 安装 Nginx 和 Supervisor
- 安装 Redis 和 Fail2ban
- 安装并配置 MariaDB Server
- 安装 Wkhtmltopdf 软件包
- 安装 Nodejs 16 和 Yarn
- 安装 frappe 框架和 frappe-bench
- 在 Frappeframework 中创建新站点/项目
- 通过 frappe-bench 安装 ERPNext
- 为生产环境部署 ERPNext
- 配置 ERPNext 安装
- 通过 Certbot 和 Letsencrypt 使用 SSL/TLS 证书进行保护
- 结论
ERPNext 是一个开源的企业 ERP(Enterprise Resource Planning,企业资源计划)系统,可以在你的业务中实施。ERPNext 可应用于多个行业,例如制造业、分销、零售、贸易、服务业、教育、非营利组织和医疗健康。此外,它还提供会计、CRM、销售、采购、网站、电子商务、销售点(POS)、制造、仓储、项目管理、库存和服务等模块。
ERPNext 是一个基于 GNU General Public Licence v3 许可的企业 ERP 平台。它主要使用 Python 和 JavaScript 编写,由 Frappe Technologies Pvt. 开发。ERPNext 是基于 Frappe 框架编写的应用程序,Frappe 是一个使用 Python 和 JavaScript 的开源 Web 框架。
ERPNext 是 Oracle 的 NetSuite、QAD、Tython、OpenBrave 和 Odoo 等服务的替代方案。在功能上,ERPNext 与 Odoo(前身为 OpenERP)类似。
在本教程中,你将在 Debian 11 服务器上安装 ERPNext,然后通过 Certbot 和 Letsencrypt 使用 SSL/TLS 证书来保护 ERPNext。你还将学习如何安装 ERPNext 的依赖项,例如 Python 3.10、Redis、Nginx、Supervisor、Fail2ban、MariaDB Server、Node.js 和 Yarn,以及 Frappe Web Framework。
先决条件
要完成本教程,你需要满足以下一些要求:
- 一台 Debian 11 服务器——本示例使用主机名为 ' erpnext-server ' 的 Debian 服务器。
- 一个具有 sudo/root 管理员权限的非 root 用户。本指南中的所有命令都将以非 root 用户身份运行。
- 一个指向服务器 IP 地址的域名。
现在让我们开始安装。
创建新用户
本教程的第一步是创建一个新用户,用于运行 ERPNext 应用程序。此外,你还需要将新用户添加到 'sudo' 组,并允许该用户以 root 权限运行命令。
运行以下命令创建新用户并为新用户设置密码。在本示例中,你将创建一个名为 ' frappe ' 的新用户,用于运行 ERPNext。
sudo useradd -m -s /bin/bash frappe
sudo passwd frappe
现在通过以下命令将用户 ' frappe ' 添加到 'sudo' 组。
sudo usermod -aG sudo frappe
最后,通过执行以下命令验证新用户。你将登录为用户 ' frappe ',并通过 ' sudo su ' 命令获取 root 权限。
su - frappe
sudo su
你的终端提示符应变为类似 'root@hostname:/home/frappe..' 的形式。现在输入 'exit' 退出 root shell。

至此,你已为 ERPNext 创建了新用户。接下来的步骤中,你将通过从源码编译的方式手动安装 Python 3.10。
安装 Python 3.10
ERPNext 是一个基于 Python 的 frappeframework 创建的 Web 应用程序。在撰写本文时,最新版本的 frappeframework 和 ERPNext 至少需要 Python 3.10。
在此步骤中,你将通过源码手动安装 Python 3.10。因为当前 Debian 11 软件仓库尚未提供 Python 3.10 软件包。
在开始之前,请确保你以新用户 ' frappe ' 的身份登录到 Debian 服务器。
su - frappe
首先,运行以下命令更新你的 Debian 软件包索引。
sudo apt update
现在运行以下 apt 命令来安装编译 Python 所需的依赖项。
sudo apt install wget build-essential libncursesw5-dev libssl-dev \
libsqlite3-dev tk-dev libgdbm-dev libc6-dev libbz2-dev libffi-dev zlib1g-dev
在提示时输入 y 并按 ENTER 继续。

接下来,通过下面的 wget 命令从 Python 下载页面下载 Python 3.10 源码。在本示例中,你将下载并安装 Python 3.10.9。
wget https://www.python.org/ftp/python/3.10.9/Python-3.10.9.tgz
Python 源码下载完成后,使用 tar 命令解压 Python 源码,并将工作目录切换到其中。
tar xzf Python-3.10.9.tgz
cd Python-*/
现在运行以下命令编译并安装 Python 3.10。
./configure --enable-optimizations
nproc
sudo make -j2
sudo make altinstall

Python 安装完成后,你应该在 ' /usr/local/bin/ ' 目录中找到你的 Python 二进制文件。运行以下命令验证 Python 3.10 的安装。
ls /usr/local/bin
你应该看到 Python 3.10 软件包的二进制文件,例如 ' python3.10 ' 和 ' pip3.10 '。
接下来,为了确保你能够运行新版本的 Python 命令,你应该将 ' /usr/local/bin ' 目录添加到系统 PATH 以及 visudo 的 secure_path 中。
使用以下 nano 编辑器命令创建新文件 '/etc/profile.d/custom-path.sh'。
sudo nano /etc/profile.d/custom-path.sh
将以下行添加到文件中。
export PATH=$PATH:/usr/local/bin/
保存文件并退出编辑器。
现在运行以下命令加载新文件 ' /etc/profile.d/custom-path.sh ' 并验证系统 PATH。
source /etc/profile.d/custom-path.sh
echo $PATH
你应该看到 ' /usr/local/bin ' 目录已添加到系统 PATH 环境变量中。
接下来,运行以下命令编辑 sudoers 配置。
sudo visudo
在 ' Defaults secure_path= ' 这一行,添加新的二进制 secure_path ' /usr/local/bin '。
Defaults secure_path=....:/usr/local/bin
完成后保存并退出编辑器。
至此,你现在可以通过 sudo 命令执行新的 Python 3.10。运行以下命令验证 Python3.10 和 Pip3.10。
sudo python3.10 --version
sudo pip3.10 --version
以下是你将在终端上看到的类似输出。

既然已经安装了 Python 3.10,接下来安装 ERPNext 的依赖项,即 Nginx Web 服务器和 Supervisor。
安装 Nginx 和 Supervisor
要安装 ERPNext,必须安装 Nginx 作为默认 Web 服务器,以及 Supervisor 作为进程管理器。Nginx 和 Supervisor 这两个软件包在 Debian 软件仓库中均可用,你可以通过 APT 轻松安装这两个软件包。
运行以下 apt 命令安装 Nginx 和 Supervisor 软件包。
sudo apt install git nginx supervisor
在提示时输入 y 并按 ENTER 继续。

接下来,运行以下 systemctl 命令实用程序来验证 Nginx 和 Supervisor 这两个服务。这将确保 Nginx 和 Supervisor 这两个服务都已运行并启用,也就是说这两个服务应在系统启动时自动运行。
检查 Nginx 服务。
sudo systemctl is-enabled nginx
sudo systemctl status nginx
输出:

检查 Supervisor 服务。
sudo systemctl is-enabled supervisor
sudo systemctl status supervisor
输出:

随着 Nginx 和 Supervisor 安装并运行,接下来安装 Redis Server 和 Fail2ban。
安装 Redis 和 Fail2ban
Redis 是一个键值数据库,可用于存储会话等临时数据。Fail2ban 是一个安全工具,用于阻止针对你的 ERPNext 应用程序的暴力破解攻击。
ERPNext 需要 Redis 作为会话管理器,并需要 Fail2ban 来阻止对 ERPNext 用户登录页面的暴力破解攻击。
运行以下 apt 命令将 Redis 和 Fail2ban 安装到你的 Debian 服务器。
sudo apt install redis-server fail2ban
在提示确认时输入 y,然后按 ENTER 继续。


Redis 和 Fail2ban 安装完成后,运行以下 systemctl 命令验证这两个服务。
sudo systemctl is-enabled redis-server
sudo systemctl status redis-server
sudo systemctl is-enabled fail2ban
sudo systemctl status fail2ban
对于 Redis 服务,你应该看到类似以下的输出——Redis 服务已启用,并将在系统启动时自动运行。且 Redis 当前状态为运行中。

对于 Fail2ban 服务,你应该看到类似以下的输出——Fail2ban 服务已启用,并将在系统启动时自动运行。且 Fail2ban 当前状态为运行中。

现在你已经安装并运行了 Redis Server 和 Fail2ban。接下来的步骤中,你将安装并配置 MariaDB 数据库服务器。
安装并配置 MariaDB Server
在默认安装中,ERPNext 将使用 MySQL/MariaDB 作为数据库服务器。ERPNext 的安装需要特定版本的 MySQL/MariaDB。
在此步骤中,你将通过官方 MariaDB 软件仓库安装 MariaDB Server 10.6。然后,你将添加 MariaDB Server 的配置并保护 MariaDB Server 部署。
运行以下命令添加 MariaDB Server v10.6 软件仓库。
sudo curl -LsS https://r.mariadb.com/downloads/mariadb_repo_setup | sudo bash -s -- --mariadb-server-version="mariadb-10.6"
你将收到类似以下的输出。

现在运行以下 apt 命令安装 MariaDB 软件包。
sudo apt install mariadb-server mariadb-client default-libmysqlclient-dev
在提示安装时输入 y 并按 ENTER 继续。

MariaDB Server 安装完成后,运行以下 systemctl 命令验证 MariaDB 服务,并确保该服务已启用并处于运行状态。
sudo systemctl is-enabled mariadb
sudo systemctl status mariadb
你现在应该得到类似以下的输出——MariaDB 服务已启用,并将在系统启动时自动运行。且 MariaDB 服务当前状态为运行中。

接下来,使用以下 nano 编辑器命令打开 MariaDB Server 配置文件 '/etc/alternatives/my.cnf'。
sudo nano /etc/alternatives/my.cnf
将以下行添加到文件中。以下配置将在你的 MariaDB Server 上启用 'barruca' 格式,并设置服务器与客户端的默认字符集为 ' utf8mb4 '。
[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
完成后保存文件并退出编辑器。
现在运行以下 systemctl 命令实用程序重启 MariaDB 服务以应用更改。
sudo systemctl restart mariadb
接下来,你将保护你的 MariaDB 部署。
运行以下命令 ' mariadb-secure-installation ' 来保护你的 MariaDB 部署。随后系统将要求你配置 MariaDB root 密码,因此请务必输入并重复新密码。对于其余配置,输入 Y 确认并按 ENTER。
sudo mariadb-secure-installation
至此,你已经完成了 MariaDB Server 的安装和配置。在下一步中,你将安装 ERPNext 用于生成 PDF 报告的 wkhtmltopdf 软件包。
安装 Wkhtmltopdf 软件包
在此步骤中,你将安装 ERPNext 用于生成 PDF 报告的 Wkhtmltopdf 软件包。Wkhtmltopdf 可以通过 .deb 文件或 .rpm 文件手动下载并安装。但对于 Debian,你可以通过 APT 从官方 Debian 软件仓库安装它。
运行以下命令安装 wkhtmltopdf 软件包。在提示时输入 Y 并按 ENTER 继续。
sudo apt install xvfb libfontconfig wkhtmltopdf

Wkhtmltopdf 安装完成后,运行以下命令进行验证。wkhtmltopdf 命令用于将 HTML 页面转换为 PDF,而 wkhtmltoimage 用于将 HTML 页面转换为各种图像格式。
which wkhtmltopdf
wkhtmltopdf --version
which wkhtmltoimage
wkhtmltoimage --version
你将收到类似以下的输出——Wkhtmltopdf v0.12 已安装在你的 Debian 系统上。

接下来的步骤中,你将安装 Node.js 和 Yarn 包管理器,它们将用于为 ERPNext 生成静态文件。
安装 Nodejs 16 和 Yarn
最新版本的 ERPNext 为 v14,它至少需要 Node.js 16 和 Yarn 包管理器。在此步骤中,你将通过 Nodesource 软件仓库安装 Node.js 16。然后,安装 Yarn 包管理器。
首先,运行以下命令添加 Node.js 16 的 Nodesource 软件仓库。
curl -fsSL https://deb.nodesource.com/setup_16.x | sudo -E bash
你将随后收到类似以下的输出。

接下来,运行以下命令为 Debian-Linux 发行版添加 Yarn 软件仓库。
sudo curl -sL https://dl.yarnpkg.com/debian/pubkey.gpg | gpg --dearmor | sudo tee /usr/share/keyrings/yarnkey.gpg >/dev/null
echo "deb [signed-by=/usr/share/keyrings/yarnkey.gpg] https://dl.yarnpkg.com/debian stable main" | sudo tee /etc/apt/sources.list.d/yarn.list

之后,通过 'apt update' 命令更新并刷新你的 Debian 软件包索引。然后,通过 'apt install' 命令安装 Node.js 和 yarn 包管理器。
sudo apt update
sudo apt install nodejs yarn
现在 Node.js 和 Yarn 包管理器的安装应该开始了。

当 Node.js 和 yarn 安装完成后,你现在已经完成了 Frappe Web Framework 和 ERPNext 应用程序的软件包依赖安装。
安装 frappe 框架和 frappe-bench
ERPNext 是一个使用 frappeframework 创建的开源 ERP 软件,frappeframework 使用 Python 和 JavaScript 编写。要安装 ERPNext,必须在系统上安装 frappeframework,它可以通过 'frappe-bench' 或 'bench' 进行安装。
因此,首先你必须安装 bench。然后,通过 bench 安装 frappeframework。最后,你将在 frappeframework 中安装 ERPNext 应用程序。
要安装 bench,运行以下 pip3.10 命令。
sudo pip3.10 install frappe-bench
在 bench 安装过程中,你将收到类似以下的输出。

bench 安装完成后,运行以下命令进行验证。你将收到二进制路径 ' bench ' 命令以及你所安装的 bench 当前版本。
which bench
bench --version

bench 安装完成后,你将安装 frappeframework。运行以下 'bench' 命令在你当前的工作目录中安装 frappeframework。此外,你将指定使用的 Python 版本为 Python 3.10,指定 frappeframework 版本为 v14,目标安装目录为 ' frappe-bench '。
bench init --python python3.10 --frappe-branch version-14 frappe-bench
在 frappeframework 安装过程中,你将收到类似以下的输出。

frappeframework 安装完成后,你应该在安装结束时收到以下输出。

最后,运行以下命令,允许其他用户读取并执行 frappeframework 安装目录。这是为了让 Nginx Web 服务器能够读取并执行 frappeframework 所必需的。
sudo chmod -R o+rx /home/frappe/frappe-bench
or
sudo chmod -R o+rx /home/frappe
frappeframework 安装完成后,你就可以准备安装并配置 ERPNext 了。
在 Frappeframework 中创建新站点/项目
在安装 ERPNext 之前,你必须在 frappeframework 上创建一个新站点/项目。在此步骤中,你将创建一个新站点/项目,并通过 bench 将环境切换到新项目。
首先,通过 cd 命令将工作目录切换到 ' frappe-bench '。
cd ~/frappe-bench
运行以下 bench 命令为 ERPNext 创建一个新站点/项目。在本示例中,你将创建一个新站点 ' erp.example.local ',即 ERPNext 安装的目标域名。此外,在设置过程中,系统会要求你配置 frappe 项目的 Administrator 密码,因此请输入你的密码并重复。该密码将用于登录你的 ERPNext 应用程序。
bench new-site erp.example.local
最后,运行以下命令切换到新站点/项目 ' erp.example.local '。
bench use erp.example.local
以下是站点/项目创建过程中以及切换到新站点/项目后的输出。

通过 frappe-bench 安装 ERPNext
在 frappeframework 上创建新站点/项目后,运行以下命令下载应用程序 ' payments ' 和 ' erpnext '。在本示例中,你将下载 ERPNexxt v14。
bench get-app payments
bench get-app --branch version-14 erpnext
以下是你在 ' payments ' 下载过程中将收到的类似输出。

以下是 ERPNext 应用程序的下载过程。

接下来,运行以下命令将 ERPNext 应用程序安装到站点/项目 'erp.example.local '。
bench --site erp.example.local install-app erpnext
你将收到类似以下的输出——此外,你应该看到应用程序 ' payments ' 作为 ERPNext 应用程序的依赖项被自动安装。

最后,运行以下 bench 命令,在站点/项目 'erp.example.local' 上启用调度器并禁用维护模式。
bench --site erp.example.local enable-scheduler
bench --site erp.example.local set-maintenance-mode off
至此,ERPNext 安装已完成。但是,如果你在生产环境中运行 ERPNext,接下来应该通过 bench 命令设置并配置 Nginx Web 服务器和 Supervisor。
为生产环境部署 ERPNext
首先,运行以下命令开始为生产环境配置 frappeframework 和 ERPNext。这将安装 Ansible 并通过 Ansible 自动设置 ERPNext 部署。
sudo bench setup production frappe
以下是 Ansible 安装过程中的输出。

以下是配置完成时的输出。

接下来,运行以下 bench 命令为 ERPNext 设置 Nginx 和 Supervisor。当询问是否覆盖当前设置时,输入 y 确认并按 ENTER。
sudo bench setup supervisor
sudo bench setup nginx
之后,再次运行以下 bench 命令以确保 Supervisor 和 Nginx 配置已安装。
sudo bench setup production frappe
输入 y 覆盖当前设置并按 ENTR 继续。

最后,以 sudo 权限运行以下 'supervisorctl' 命令。这将验证 frappeframework 和 ERPNext 所使用的所有进程和服务。
sudo supervisorctl status
如果你的 ERPNext 安装成功,你应该收到类似以下的输出——frappeframework 和 ERPNext 的所有服务都在运行中。

至此,你已经完成了 ERPNext 安装,它正以 Nginx 作为 Web 服务器、Supervisor 作为进程管理器运行。你现在可以通过你的域名和 Web 浏览器访问 ERPNext 安装。
配置 ERPNext 安装
打开你的 Web 浏览器并访问你的 ERPNext 安装域名(即:http://erp.example.local /)。然后你将看到 frappeframework 登录页面。
输入默认用户 ' Administrator ',并输入你在站点/项目创建过程中使用的密码。

现在选择默认语言、时区和货币。然后点击 Next(下一步)。

输入你的 ERPNext 安装的新管理员用户。输入你的全名、电子邮件地址和密码,然后点击 Next(下一步)。

输入公司名称并上传公司徽标,然后点击 Next(下一步)。

输入有关你组织的信息,然后点击 Complete Setup(完成设置)。

你现在应该看到 ERPNext 安装的管理仪表板。

通过 Certbot 和 Letsencrypt 使用 SSL/TLS 证书进行保护
在此步骤中,你将使用 Certbot 工具(来自 Letsencrypt)生成的 SSL/TLS 证书来保护 ERPNext 的部署。开始之前,请确保你的域名已指向你的服务器 IP 地址,并确保你拥有一个将用于注册 Letsencrypt 的电子邮件地址。
运行以下 apt 命令安装 certbot 工具以及适用于 Nginx Web 服务器的 certbot 插件。在提示时,输入 y 确认并按 ENTER 继续。
sudo apt install certbot python3-certbot-nginx
certbot 安装完成后,运行以下 certbot 命令为你的 ERPNext 域名生成 SSL 证书。请务必修改以下命令中的域名和电子邮件地址。
sudo certbot --nginx --agree-tos --no-eff-email --redirect --hsts --staple-ocsp --email
[email protected]
-d erp.example.local
至此,ERPNext 安装已通过 Certbot 和 Letsencrypt 使用 SSL/TLS 证书进行了保护。你还在 ERPNext 域名上配置了 HTTP 到 HTTPS 的自动重定向,这是由 Certbot 自动处理的。
结论
在本教程中,你学习了如何在 Debian 11 服务器上安装开源 ERP 软件 ERPNext。你还学习了如何安装一些依赖项,例如通过编译并安装源码手动安装的 Python 3.10。你在 Debian 服务器上安装了其他依赖项,例如 MariaDB、Nginx、Supervisor、Redis 和 Fail2ban。
你还学习了如何安装 Frappe 框架并在其基础上构建 ERPNext。然后你学习了将 ERPNext 作为 ERP 软件的基本配置。
最后,你通过将 Nginx 配置为 Web 服务器、Supervisor 配置为进程管理器,为生产环境设置了 ERPNext。你还通过 Certbot 和 Letsencrypt 保护了 ERPNext 的使用。