准备工作
您应该运行 Debian 12+ 或 Ubuntu 22.04+,否则您的某些软件包可能会遇到问题。
更新系统的软件包索引
sudo apt update
安装chsrc 全平台通用换源工具 官网 github gitee
curl https://chsrc.run/posix | sudo bash
更换系统源,pypi源,npm,yarn源等
先决条件
MariaDB 10.6.6+
Python 3.10/11/12
Node 18or20
Redis 6 +
yarn 1.12+
pip 20+
wkhtmltopdf (version 0.12.5 with patched qt)
1.1安装git python redis
sudo apt install git python-is-python3 python3-dev python3-pip redis-server
1.2安装 MariaDB
sudo apt install mariadb-server mariadb-client
在此安装过程中,系统将提示您设置 MySQL root 密码。如果未提示您,则必须自行初始化 MySQL 服务器设置。您可以通过运行以下命令来执行此操作:
mariadb-secure-installation
请记住:只有在设置过程中没有提示输入密码时,才运行它。
记住这个密码真的很重要,因为它以后会很有用。
现在,编辑 MariaDB 配置文件(Frappe v15.21.0 或更高版本不需要此步骤)。
nano /etc/mysql/my.cnf
并添加此配置
[mysqld]
character-set-client-handshake =FALSEcharacter-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci
[mysql]
default-character-set= utf8mb4
现在,只需重新启动 MariaDB 服务,您就可以开始了。
sudo systemctl restart mariadb
安装 Node
我们建议使用 nvm 安装 node
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
安装 nvm 后,您可能必须关闭终端并打开另一个终端。现在运行以下命令来安装 node。
nvm install 18
通过运行以下命令来验证已安装的版本:
$ node -v
v18.20.4
最后,使用yarnnpm
npm install -g yarn
安装 wkhtmltopdf
sudo apt install xvfb libfontconfig
从 https://wkhtmltopdf.org/downloads.html 下载并安装 wkhtmltopdf 包,然后运行此命令以安装包。
sudo dpkg -i wkhtmltox_file.deb
安装 Bench CLI
通过 pip3 安装 Bench
pip install frappe-bench
根据您的操作系统版本和 python/pip 版本,您可能会在此处收到有关externally-managed-environment
您现在可以通过运行或使用 virtualenv 来解决此问题
pip install frappe-bench --break-system-packages
通过检查版本确认工作台安装
$ bench --version
5.22.9
创建您的第一个长凳。
cd~
bench init
恭喜,您已在系统上安装了 bench。
提示正在升级中:
bench --site your-sitename.com set-maintenance-mode off
V16切换中文:
右上角搜索 language 出来结果 language list 点进去,启用中文,再晕系统设置里选择中文,重新登录系统。