安裝步驟及說明（以下步驟在華為雲耀伺服器1vCPUs | 2GB debian 10 64位 驗證成功，總耗時40分鐘左右）

考慮ubuntu基於debian，命令基本相同，本安裝指南理論上也適用ubuntu.

1. 用root登錄系統，開始安裝

更新、升級作業系統：

apt-get update
apt-get upgrade

2. 安裝sudo，創建安裝帳號並分配root許可權，ubuntu 自帶sudo，不用單獨安裝

修改[user]為你自定義的用戶，依據提示輸入並確認用戶密碼

apt-get install sudo
adduser [USER]
usermod -aG sudo [USER]

3. 安裝一鍵安裝文本中操作系統級依賴庫

apt install git libffi-dev python3-minimal build-essential python3-distutils python3-setuptools python3-pip python3-testresources libssl-dev wkhtmltopdf redis

4. 修改redis 配置

nano /etc/redis/redis.conf

（搜索 127.0.0.1 ：：1這一行，去掉後面的：：1， ctrl + o再回車保存，ctrl + x退回命令行）

5. 重啟系統

reboot

6. 用上述第2步新創建的系統安裝賬號登錄

export LC_ALL=C.UTF-8

7. 下載安裝文稿

wget https://raw.githubusercontent.com/frappe/bench/develop/install.py

8. 執行一鍵安裝腳本，修改 [USER] 為上述安裝帳號，修改[資料庫密碼]，[系統管理員密碼]，以及frappe13（安裝後生成的新目錄）， 視網络下載速度，此步驟耗時較長，如果命令執行過程出錯后，可重複執行。

sudo python3 install.py --verbose --production --user [USER] --mariadb-version 10.5 --frappe-branch version-13 --erpnext-branch version-13 --mysql-root-password [数据库密码] --admin-password [系统管理员密码] --bench-name frappe13 --erpnext-repo-url https://gitee.com/qinyanwan/erpnext --frappe-repo-url https://gitee.com/qinyanwan/frappe

命令行參數說明如下，更多參數請查看 install.py 檔中的parse_commandline_args函數

        --production            指定安装脚本install.py安装当前的稳定版，如果需要安装开发版可以使用--develop参数；
    --user                  安装目录的拥有者用户，后续用此用户账号管理系统维护和升级
    --bench-name            安装目录名
    --mysql-root-password   数据库管理员密码
    --admin-password  自动创建的管理员账号密码
    --verbose   显示详细安装过程
    --overwrite  首次出错后，重复执行命令时覆盖之前生成的目录,一般不用此参数，出错后重复执行命令会利用之前已下载或安装过的部分
    --version 指定安装的系统版本，默认安装当前的稳定版 13，version参数可以安装指定版本，比如version-13-beta
    --site  站点名
        --erpnext-repo-url     erpnext代码源，改为国内码云源可解决github下载速度慢问题
        --frappe-repo-url      frappe代码源

等一段時間後系統返回 「Successfully Installed」即安裝成功

9. 切換到bench目錄後啟動後台任務（可選步驟）

cd frappe13
bench enable-scheduler

10. 切換回官方代碼庫，從官方代碼庫升級（可選步驟）

bench remote-reset-url frappe
bench remote-reset-url erpnext
bench update

附註：安裝本人的ebclocal漢化APP及登錄使用

1. 獲取漢化APP和安裝到網站（可選步驟）

bench get-app --branch master yuzelin/ebclocal
bench install-app ebclocal

2. 用瀏覽器（推薦 Chrome或Firefox）輸入IP或功能變數名稱，使用使用者名administrator，登錄系統

常見問題

1. 列印單據或報表轉PDF時，中文顯示亂碼

原因是沒有相關中文字體，

解決方法：執行以下命令安裝

sudo apt-get install ttf-wqy-zenhei -y

2. 從github代碼託管倉庫下載連接超時 "msg"： "Failed to connect to GitHub： Where the world builds software at port 443： [Errno 110] Connection timed out"，

解決方法：重新執行命令。

參考了官方論壇貼 [Tutorial] Install v13 Production on Debian 10 VPS - Using "Easy Install" script - Now includes setting up SSL certificate！ ，略有修正並增加了國內代碼庫源以解決常見的網络超時問題。

步驟如下

1. 準備一台裝好ubuntu20.04的伺服器，本地虛擬機或者VPS皆可，虛擬機的網路要用橋接模式。 Ubuntu 20.04server安裝會順利些，用ssh 工具，如dos 運行命令 ssh root@伺服器ip，putty， secureCRT， Xshell等登錄伺服器。

2. 設定root密碼，在雲伺服器已設過密碼的可跳過此步驟

sudo passwd root

3. 添加使用者，如果使用現有sudo許可權使用者就可以跳過第3、4步。

adduser USERNAME

#用户名USERNAME换成自己计划使用的用户名

4. 將使用者設定sudo權限：

usermod -aG sudo USERNAME

#记得把命令行里的USERNAME改成自己刚设置的用户名

5. 通過ssh登錄root使用者

#虚拟机、騰訊雲需要先設置將埠22開放才能通過ssh連接

vim /etc/ssh/sshd_config

按i，移動游標到以下內容修改：w

#Port 22

改為

Port 22

#PermitRootLogin prohibit-password

改為

PermitRootLogin yes

修改好按ESC，shift+：，輸入wq回車

重啟服務

/etc/init.d/ssh restart

6. 替換國內鏡像源，下面用的是清華鏡像源，操作如下（root使用者可不輸入sudo）：

1.備份

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

2.修改

sudo vim /etc/apt/sources.list

3.按ggVG進行全選，按d進行刪除

4.將下面源粘貼

5.按esc，再按shift+：，輸入wq回車（這步是保存退出）

# 默认注释了源码镜像以提高 apt update 速度，如有需要可自行取消注释
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal main restricted universe multiverse
# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal main restricted universe multiverse
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal-updates main restricted universe multiverse
# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal-updates main restricted universe multiverse
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal-backports main restricted universe multiverse
# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal-backports main restricted universe multiverse
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal-security main restricted universe multiverse
# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal-security main restricted universe multiverse

# 预发布软件源，不建议启用
# deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal-proposed main restricted universe multiverse
# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal-proposed main restricted universe multiverse

# 預發佈軟體源，不建議啟用

# deb Index of /ubuntu/ focal-proposed main restricted universe multiverse

# deb-src Index of /ubuntu/ focal-proposed main restricted universe multiverse

7. 更新並重啟

apt update && apt upgrade -y && shutdown -r now

8. 重新打開SSH連接，並用root登錄，下載node.js

curl -sL https://deb.nodesource.com/setup_12.x | sudo -E bash -

#有时候运行完没反应，直接跳回命令輸入，這時候要再運行到出現以下提示

## Installing the NodeSource Node.js 12.x repo...

9. 安裝作業系統級依賴

apt install -y nodejs mariadb-server-10.3 redis-server python3-pip nginx python3-testresources

#最新的10.5版本的Mariadb資料庫安裝後會報錯，需要更改預設的資料庫引擎。 建議10.3版本。 ——來自Jason Zhang的文檔，所以我這裡又在Mariadb後面加上了個版本號

10. 用nano編輯my.cnf檔

nano /etc/mysql/my.cnf

將游標移動到最後空白行，複製以下文本內容，ctrl + O，回車確認，ctrl + X返回命令行

[mysqld]
character-set-client-handshake = FALSE 
character-set-server = utf8mb4 
collation-server = utf8mb4_unicode_ci 
[mysql]
default-character-set = utf8mb4

11. 重啟sql

service mysql restart

12. mysql的安全配置

mysql_secure_installation

第一個輸入資料庫密碼對話框出來的時候，直接敲回車代表沒有密碼，剩下的按照下面選擇：

Enter current password for root (enter for none):

#这里直接回车

Set root password? [Y/n] Y
New password:  #输入数据库密码
Re-enter new password: #重复输入数据库密码
Remove anonymous users? [Y/n] Y
Disallow root login remotely? [Y/n] n
Remove test database and access to it? [Y/n] Y
Reload privilege tables now? [Y/n] Y

13. 執行下面命令

mysql -u root -p

輸入上面新設置的資料庫root帳號密碼，進入資料庫命令行，並執行下面的語句

USE mysql; 
UPDATE user SET plugin=' ' WHERE user ='root'; 
FLUSH PRIVILEGES;
exit;

13. 【重要】關閉ssh終端，重新以自己"新創建的使用者名"和密碼登錄

15. 安裝yarn

sudo npm install -g yarn

#保险起见，還需要將剛剛的yarn，node，npm添加運行許可權。 sudo chmod +x /usr/bin/node. 默認有運行許可權。 ——Jason Zhang

#配置Yarn的源：

yarn config get registry  

查看源， 如果不是淘寶的源就切換為淘寶的源

yarn config set registry https://registry.npm.taobao.org
yarn config set sass_binary_site "node-sass Mirror"
yarn config set phantomjs_cdnurl "http://cnpmjs.org/downloads"
yarn config set electron_mirror "electron Mirror"
yarn config set sqlite3_binary_host_mirror "https://foxgis.oss-cn-shanghai.aliyuncs.com/"
yarn config set profiler_binary_host_mirror "node-inspector Mirror"
yarn config set chromedriver_cdnurl "https://cdn.npm.taobao.org/dist/chromedriver"

16. 查看版本，對照一下，這一步不做也行

node -v && npm -v && python3 -V && pip3 -V && yarn -v

17. 安裝bench，即erpnext系統的命令行管理工具，類似windows系統的程式管理器

sudo pip3 install frappe-bench

18. 安裝git，下一步bench init可能會報錯缺少git。

sudo apt install git

19. 使用bench命令安裝frappe框架，記得把frappe-bench（下方的version-13後面的名字）改成自己想要的名字，這一步時間比較長，別著急，代碼庫已經加了碼雲地址參數。 如果網路超時失敗，可重新運行該命令，重新運行之前需使用命令 『rm -r frappe-bench』 刪除之前生成的目錄。

bench init --frappe-branch version-13 frappe-bench --frappe-path=https://gitee.com/qinyanwan/frappe

#下面这段是警告说pip有新版本，可忽略

WARNING: You are using pip version 21.0.1; however, version 21.1 is available.

You should consider upgrading via the '/home/frappe/frappe-bench/env/bin/python -m pip install --upgrade pip' command.

20. 進入bench目錄

cd frappe-bench

21. 新建網站，名字自己取，安裝時會提示輸入資料庫root賬號的密碼， 新網站資料庫及erp系統管理員帳號administator 密碼，其中資料庫root帳號密碼須與上述資料庫安裝時密碼一致，其它密碼自己取 --db-password xxx 也可以命令行參數中直接輸入好密碼,--mariadb-root-password yyyy -- admin-password zzzz

bench new-site mysite

#新建的站点名为mysite

22. 下載erpnext

bench get-app --branch version-13 https://gitee.com/qinyanwan/erpnext

23. 安裝erpnext

bench install-app erpnext

24. 設置為生產環境，即用supervisorctl管理所有進程，使用nginx做反向代理，USERNAME換成第3步新建的帳號，大功告成

sudo bench setup production USERNAME

提示這個 Do you want to continue？ [y/N]： y 請輸入 Y，回車

#重要：設置成生產環境后，不用執行bench start進行啟動!!!

25. 安裝完后可查看一下是否有活動的wokers

bench doctor 

#正常情况下会显示如下：

    -----Checking scheduler status-----
    Scheduler disabled for erpnext
    Scheduler inactive for erpnext
    Workers online: 3

-----erpnext Jobs-----

26. 以上完成後查看一下安裝了哪些app

 bench version 

正常會顯示以下兩個app

    erpnext 13.x.x
    frappe 13.x.x

27. 如果是虛似機安裝，需要防火牆入站打開80埠。

    ufw allow 80
    sudo ufw status verbose
    #打开后显示如下：
    root@erpnext:~# ufw allow 80
    Rule added
    Rule added (v6)
    root@erpnext:~# sudo ufw status verbose
    Status: active
    Logging: on (low)
    Default: deny (incoming), allow (outgoing), deny (routed)
    New profiles: skip
    To                         Action      From
    --                         ------      ----
    22/tcp                     ALLOW IN    Anywhere                  
    22                         ALLOW IN    Anywhere                  
    80                         ALLOW IN    Anywhere                  
    22/tcp (v6)                ALLOW IN    Anywhere (v6)             
    22 (v6)                    ALLOW IN    Anywhere (v6)             
    80 (v6)                    ALLOW IN    

28. 阿裡雲伺服器要在安全組裡添加80的入站埠號。

您將需要在ERPNext伺服器上開啟以下埠：

80/tcp and 443/tcp for HTTP and HTTPS respectively

HTTP和HTTPS分別為80/tcp和443/tcp

3306/tcp for MariaDB connection (recommended only if you need remote access to database)

3306/tcp用於MariaDB連接（僅在需要遠端存取資料庫時才建議使用）

143/tcp and 25/tcp for IMAP and STMP respectively

IMAP和STMP分別為143/tcp和25/tcp

22/tcp for SSH (if you have not already enabled OpenSSH in your UFW settings)

SSH 22/tcp （如果尚未在UFW設置中啟用OpenSSH ）

8000/tcp for testing your platform before deploying to production

8000/tcp用於在部署到生產環境之前測試平臺

#要一次打开多个端口，可以使用以下命令：

sudo ufw allow 22,25,143,80,443,3306,8000/tcp

sudo ufw允許22，25，143，80，443，3306，8000 / tcp

現在確認防火牆的狀態：

sudo ufw status

附註：安裝ebclocal漢化APP

1. 獲取APP

bench get-app --branch master https://gitee.com/yuzelin/ebclocal

2. 安裝APP

bench install-app ebclocal 

3. 用瀏覽器（推薦 Chrome或Firefox）輸入IP或功能變數名稱，登錄系統，使用者名administrator，密碼是第21步admin-password密碼。

常見問題

1. wkhtmltopdf安裝時出現字體庫依賴無法安裝等錯誤 參考了這個https://askubuntu.com/questions/604029/dependency-problems-with-wkhtmltopdf-when-trying-to-install-latest-version，最後是以下命令解決了

sudo apt-get -f install

2. 透過列印轉PDF時出現亂碼 參考這個帖子https://www. taodudu.cc/news/show-1772808.html，用以下命令安裝字體

sudo apt-get install ttf-wqy-zenhei -y

sudo apt-get install ttf-wqy-microhei -y

#### Ubuntu20.04 安裝列印wkhtmltopdf 庫

1、先下載適合我們系統的安裝包並進行安裝：

wget "https://github.com/wkhtmltopdf/packaging/releases/download/0.12.6-

1/wkhtmltox_0.12.6-1.focal_amd64.deb" -O /tmp/wkhtml.deb

2、下一步進行安裝

sudo dpkg -i /tmp/wkhtml.deb

3、這時可能會顯示缺少依賴的錯誤，以下命令可解決這一問題：

sudo apt -f install

4、現在，我們可以檢查wkhtmltopdf 庫是否正確安裝並確認是否為所需版本：

wkhtmltopdf –version

##### 顯示wkhtmltopdf 0.12.6 （with patched qt）即是正確版本

其他注意：

apt install wkhtmltopdf

##### 這條命令國內阿裡雲源自動安裝版本0.12.5，非patched qt 版本，erpnext 不列印頁面頭部和底部。

如果wkhtmltopdf 庫不是我們需要的版本，應對其進行卸載，命令如下：

sudo apt remove --purge wkhtmltopdf

1. 用戶登錄系統時獲取全域翻譯（字典），

1.1 獲取以下待翻譯文本（參考translate.get_dict fortype=="boot"）

• 遍曆已安裝app目錄獲取代碼檔（'.py'， '.html'， '.js'， '.vue'）中翻譯函數（py： _（）， js： __（））的第一個參數
• 從資料庫表中獲取一些全域共用訊息（編號、名稱），如左側導航功能表，單據類型，報表，角色，模組，工作區，初始化嚮導，

1.2 載入各app translations目錄下的目標語言翻譯csv文本檔（如zh.csv）為一個英文為鍵，翻譯文本為值的字典，如{『PO』：『採購訂單』}， 遍歷時以app安裝順序（參考 translate.load_lang），相同詞條，後安裝APP的內容覆蓋前面的，所以最新安裝的自定義APP中的zh.csv內容會覆蓋標準app 如frappe，erpnext中的相同詞條，此步驟結果會被緩存

1.3 第1步的待翻譯文本從上述字典中獲取翻譯內容，產生待返回翻譯字典

1.4 從app中定義的翻譯勾子程式中獲取翻譯內容，添加或更新待返回翻譯字典

1.5 從資料庫獲取使用者翻譯表的全部內容，添加或更新待返回翻譯字典

1.6 返回翻譯字典到前端網頁，載入（添加或更新）到frappe._message公用變數

1.7 js 檔案中的翻譯函數_（'待翻譯文本'） 基於frappe._message字典獲取翻譯結果

2. 獲取具體頁面（單據類型，報表，網頁）翻譯內容

除第1小步的獲取待翻譯文本是針對具體的頁面物件（單據類型、報表、網頁）之外，其它步驟同上述boot.

常見不能翻譯的情況

1. 代碼中未調用翻譯函數
2. 翻譯函數第一個參數是變數（動態文字）
3. 翻譯詞條與源文不同
1. 原文本首或尾有空格
2. 原文本是含花括號{0}變數的，翻譯詞條是固定字串
3. 原文本中含特殊字元，如回車換行，翻譯詞條沒換行
4. 代碼中待翻譯文本未正確獲取
5. 顯示內容屬於第三方控件，如熱力圖，甘特圖，數據表

常見翻譯錯誤

1. 一詞多義，如commit在預算管理中是承諾，在資料庫操作時是提交

ERPNext 應用開發新手入門教程-2

官網教程：https://frappeframework.com/docs/user/en/tutorial，中文解讀，實操演示

背景與問題
希望在專案表單中顯示與專案關聯總採購訂單費用。

使用者自己的嘗試

有好幾個問題，就不點評了。

參考解決方案

1.通過定製為專案單據類型新增總採購成本欄位

2.第一版：為專案單據類型新增兩個單據事件（提交后與取消后）內容相同的python腳本

for po_item in doc.items:
    po_cost = frappe.get_list('Purchase Order', 
                                fields = 'sum(grand_total)',
                                filters = {'project': po_item.project, 'docstatus': 1},
                                as_list = 1)[0][0]
    if po_cost:
        frappe.db.set_value('Project',po_item.project, 'total_po_cost', po_cost)

文稿說明：

• 遍歷採購訂單明細行，
• 通過get_list函數取滿足條件（專案等於當前採購訂單行的專案字段，採購訂單狀是已提交），採購金額總計（sum），返回類型為清單中套清單，最後取出匯總金額[0][0]
• 如果有匯總金額返回
• 更新到專案中的採購成本欄位

第二版： 考慮到專案是採購訂單行而非訂單頭上，實際上很可能不同採購訂單行分派相同專案，以上代碼每一行執行一次，相同專案會重複執行。 改進版代碼如下

projects = {po_item.project for po_item in doc.items}
for project in projects:
    po_cost = frappe.get_list('Purchase Order', 
                                fields = 'sum(grand_total)',
                                filters = {'project': project, 'docstatus': 1},
                                as_list = 1)[0][0]
    frappe.db.set_value('Project',project, 'total_po_cost', po_cost or 0)

簡要說明，第一行是用清單解析抓取不重複的項目號清單（集合）。
分享時提到用括弧（）作清單解析返回沒有重複項的集合是不正確的，括號返回的是元組，應該用花括號{}，以上代碼已修正。 謝謝參與分享的高手指出以上錯誤。

效果

小提示，採購訂單提交或取消后，跳轉回專案表單刷新瀏覽器成本字段值才會更新。

其他思考 ：
是否可以用用戶端腳本實現，需要考慮哪些問題？ 與python腳本實現對比有啥優缺點？

以上伺服器端實現方式是系統標準功能的實現方式，即關聯了專案的單據提交時，自動更新專案上的統計字段，此方式好處是統計值保存在專案單據（資料庫表）中了，表單，清單及報表查詢時該字段都有值。 不足是原有歷史採購訂單的舊專案，無新採購訂單提交或舊採購訂單取消時，不會觸發以上代碼，變通的做法是創建一個虛擬採購訂單提交再取消觸發程序執行。

如果用戶端JS實現，類似計算欄位，在每次打開專案表單（詳情）時計算。 可解決舊項目問題，但清單或報表中該值不會更新。
用戶端實現方式參考

常見問題
fields參數寫成這樣就會報下面的錯，這種寫法在py代碼里是可以的
fields:"sum(grand_total)",

filter參數寫成這樣filters：{'project'： project， 'docstatus'： 1} python後台可運行，通過js rest調用會出以下錯誤，系統程式對外部調用參數檢查邏輯不完善，沒考慮到內部支援子表單字段直接作為篩選條件。

ERPNext作為一款元數據驅動，自帶電池的低代碼訊息化平臺，本視頻嘗試解釋了此概念。

新年第一天開個頭，正式開始在國內推廣優秀的開源ERP產品ERPNext.

本貼將持續發佈ERPNext從安裝，實施到運維相關文檔，切實助力中小企業用得了，用得上，用得好ERPNext

核心主流程圖

採購主流程

銷售主流程

生產主流程

庫存主流程