ERPNEXT安装部署教程

# 创建frappe系统账号
sudo useradd frappe
# 设置frappe的密码
sudo passwd frappe
# 输入密码
# 给frappe设置超级权限
sudo usermod -aG sudo frappe

#如果没有/home/frappe文件夹要手工添加
sudo mkdir /home/frappe
sudo chown frappe:frappe /home/frappe

sudo timedatectl set-timezone Asia/Shanghai
 timedatectl

sudo apt update
sudo apt install git redis-server libmariadb-dev mariadb-client pkg-config nginx ansible supervisor xvfb libfontconfig

sudo systemctl start supervisor
sudo systemctl enable supervisor
# 安装完组件最好重启下
sudo systemctl status supervisor 如果输出显示 active (running)，就说明服务状态完全正常。

sudo apt-get install nodejs npm -y
sudo npm install -g n
#切换版本到24
sudo n 24
#查看版本
node -v

sudo npm install -g yarn

# 设置国内镜像
npm set registry https://registry.npmmirror.com/

# 把这个包提前安上，避免后续报错
yarn add https://gitee.com/sonic3k/air-datepicker.git

sudo apt install -y mariadb-server

sudo nano /etc/mysql/my.cnf

将光标移动到最后空白行，复制以下文本内容，粘贴后注意格式和换行要同下方，ctrl + X返回命令行，保存cy.cnf。
   
[mysqld]
character-set-client-handshake = FALSE 
character-set-server = utf8mb4 
collation-server = utf8mb4_unicode_ci
bind-address = 0.0.0.0

[mysql]
default-character-set = utf8mb4

#重启
sudo systemctl restart mysql
#开启自动启动
sudo systemctl enable mysql
#看状态
sudo systemctl status mysql

   sudo mysql_secure_installation   

   第一个输入数据库密码对话框出来的时候，直接敲回车代表没有密码，剩下的按照下面选择：
  
   # 注：运行结果用 ··· 代替
   Enter current password for root (enter for none):  # 输入root(mysql)的密码，初次安装默认没有，直接回车 
    ... 
   Switch to unix_socket authentication [Y/n] n # 是否切换到unix套接字身份验证[Y/n]
    ... 
   Change the root password? [Y/n] y #是否设置root用户密码
   New password: # 新密码
   Re-enter new password:  # 再次输入密码
    ... 
   Remove anonymous users? [Y/n] y # 是否删除匿名用户，建议删除
    ... 
   Disallow root login remotely? [Y/n] n # 是否禁止root远程登录，建议不开启
    ... 
   Remove test database and access to it? [Y/n] n # 是否删除test数据库，可以保留
   ...
   Reload privilege tables now? [Y/n] y # 是否重新加载权限表，也可以直接回车
    ... 
   Thanks for using MariaDB! # 看到这句话证明设置成功   

mysql -u root -p
# 给root用户授权远程访问
GRANT ALL PRIVILEGES ON *.* TO 'root'@'%' IDENTIFIED BY '你的密码' WITH GRANT OPTION;
GRANT ALL PRIVILEGES ON *.* TO 'root'@'localhost' IDENTIFIED BY '你的密码' WITH GRANT OPTION;
exit #退出

curl -LsSf https://astral.sh/uv/install.sh | sh
source ~/.bashrc

#看版本
uv --version
如果网络不行就使用pipx
sudo apt update
sudo apt install -y pipx
# 用 pipx 安装 uv
pipx install uv uv
安装完成后，刷新环境变量：
source ~/.bashrc
uv python install 3.14 --default

# 编辑文件
nano ~/.config/uv/uv.toml

# 粘贴下面的内容进去
python-install-mirror = "https://registry.npmmirror.com/-/binary/python-build-standalone/"
[[index]]
url = "https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple/"
default = true

uv tool install frappe-bench

bench init frappe-bench \
  --frappe-branch version-16 \
  --frappe-path=https://gitee.com/mirrors/frappe.git \
  --verbose
# 设置权限
chmod -R o+rx /home/chen/frappe-bench
把bench路径加到sudo里,/home/frappe/.local/bin这个路径可以通过which bench查一下
sudo visudo
加到path里
Defaults    secure_path = "/sbin:/bin:/usr/sbin:/usr/bin:/home/chen/.local/bin"
ctrl+O 回车
ctrl+X 回车

cd /home/chen/frappe-bench
bench new-site erpnext16
#这里要输入mariadb的密码，administrator的密码也要记录下来
bench use erpnext16

cd /home/chen/frappe-bench
#安装erpnext
bench get-app --branch version-16 erpnext https://gitcode.com/phipsoft/erpnext
bench install-app erpnext
# 选装会计科目表
bench get-app https://gitee.com/sonic3k/accounting_cn.git
bench install-app accounting_cn
# 建议强制build一下
bench build --force --verbose

cd /home/chen/frappe-bench
bench start
# 通过http://ip:8000访问
进行初始化配置

# CTRL+C结束掉上面的命令，执行下面的命令
sudo bench setup production frappe

安装生产模式后有bug，nginx无法启动
这个时候要编辑/home/frappe/frappe-bench/config/下的nginx.conf
把log相关路径后面多余的 main 字符删除，保存
再重启下服务器就行了