? ?
目錄
1.node安裝
1.1下載node,解壓
1.2 部署bin文件
1.3 安裝mongodb
2.啟動yapi
2.1? 前置命令
2.2 啟動服務
3.利用pm2方便服務管理維護
3.1.安裝pm2
3.2 常用 PM2 命令
4.常見問題
4.1. 確認 MongoDB 是否安裝
4.2. 安裝 MongoDB（若未安裝）
4.3. 如果 MongoDB 已安裝但服務未啟動
4.4. 檢查 MongoDB 數據目錄
4.5. 重新啟動 YApi
4.6. 驗證 YApi 數據持久化
阿里云服務器申請過程，這個步驟省略了，以下是搭建YApi - 接口管理平臺的過程
安裝Yapi環境要求：
nodejs（7.6+)
mongodb（2.6+）
git
1.node安裝
?1.1下載node,解壓
使用wget直接下載
命令：cd /usr/local
然后輸入命令：
wget https://nodejs.org/download/release/v12.18.4/node-v12.18.4-linux-x64.tar.xz
解壓縮
xz -d node-v12.18.4-linux-x64.tar.xz
tar -xf node-v12.18.4-linux-x64.tar
下載后。mv 命令重命名下：
mv node-v12.18.4-linux-x64 node?
1.2 部署bin文件
命令
ln -s /usr/local/node/bin/node /usr/bin/node
ln -s /usr/local/node/bin/npm /usr/bin/npm
ln -s /usr/local/node/bin/npx /usr/bin/npx
1.3 安裝mongodb
??下載mongodb壓縮包到本地，解壓縮文件，移動并重命名mongodb
wget https://fastdl.mongodb.org/linux/mongodb-linux-x86_64-rhel70-4.4.22.tgz
# 解壓壓縮包
tar -zxvf mongodb-linux-x86_64-rhel70-4.4.22.tgz
# 移動node位置并重新命名
mv mongodb-linux-x86_64-rhel70-4.4.22 /usr/local/mongodb
配置mongoDB文件夾和配置文件，進入mongodb目錄 cd /usr/local/mongodb
執行mkdir data用來存放mongodb的數據庫數據
執行mkdir logs用來存放mongodb運行產生的日志
創建mongodb.conf文件
touch mongodb.conf
更改權限：
chmod +x mongodb.conf然后復制下面的命令到mongodb.conf里面，vi mongodb.conf
# 日志文件位置
logpath=/usr/local/mongodb/logs/mongod.log
# 以追加方式寫入日志
logappend=true
# 是否以守護進程方式運行
fork=true
# 默認27017
port = 27017
# 數據庫文件位置
dbpath=/usr/local/mongodb/data
# 允許哪個ip的連接，0.0.0.0表示任意ip都可以連接
bind_ip=0.0.0.0
# 是否以安全認證方式運行，默認是不認證的非安全方式
auth = false
將mongoDB的命令，添加到profile中
vim /etc/profile
# 文件尾部添加一行
export PATH=/usr/local/mongodb/bin:$PATH
# 刷新使修改生效
source /etc/profile
啟動mongodb，進入到 /usr/local/mongodb/bin 下面，執行
mongod -f mongodb.conf?出現successfully，代表啟動成功。
2.啟動yapi
2.1? 前置命令
然后輸入命令：
回到主目錄
cd 執行命令清除npm緩存：
npm cache clean --force執行命令取消ssl驗證
npm config set strict-ssl false然后重新執行npm install -g yapi-cli --registry https://registry.npm.taobao.org
然后輸入命令：
切換目錄：
cd /usr/local/node/bin./yapi server?2.2 啟動服務
在瀏覽器輸入：http://101.132.58.85:9090/，選擇這個版本
初始化管理員賬號成功,賬號名："admin@admin.com"，密碼："ymfe.org"
部署成功，請切換到部署目錄，輸入： "node vendors/server/app.js" 指令啟動服務器, 然后在瀏覽器打開 http://127.0.0.1:3000 訪問
如果無法訪問這個頁面，得在阿里云安全組設置端口訪問
?啟動yapi
如果不知道yapi安裝目錄，用命令： find / -name "config.json" | grep yapi然后到目錄 /usr/local/node/bin/my-yapi/vendors/server啟動yapi node app.js后臺運行，關掉窗口后yapi還在 node app.js &
YApi-高效、易用、功能強大的可視化接口管理平臺
3.利用pm2方便服務管理維護
3.1.安裝pm2
? ?由于命令管理yapi不方便比如想停止yapi進程：
[root@iZuf6iom68zjwhoqb0cw70Z server]# ps aux | grep "node app.js"
root 4476 0.0 0.0 112812 992 pts/1 S+ 22:08 0:00 grep --color=auto node app.js
root 30798 0.6 3.3 659992 59804 pts/0 Sl 21:57 0:03 node app.js
[root@iZuf6iom68zjwhoqb0cw70Z server]# kill -9 30798 # 強制終止
[root@iZuf6iom68zjwhoqb0cw70Z server]#
# 安裝 PM2
npm install pm2 -g
# 切換到 YApi 目錄
cd /usr/local/node/bin/my-yapi/vendors/server# 用 PM2 啟動 YApi（命名為 yapi）
pm2 start app.js --name yapi
如果報錯誤：-bash: pm2: command not found
那么是環境變量沒有安裝
npm list -g | grep pm2如果輸出中包含?pm2（例如?/usr/local/lib/node_modules/pm2），說明已安裝，但系統找不到它。
運行以下命令，查看 npm 全局包的安裝位置：
npm config get prefix典型輸出可能是：
-
/usr/local（默認） -
/usr/local/node（自定義路徑） -
/root/.nvm/versions/node/[版本號]（如果使用 nvm 管理 Node.js）
假設輸出是?/usr/local/node，則 PM2 的可執行文件路徑為：
/usr/local/node/bin/pm2
將路徑添加到?PATH?環境變量
vi /etc/profile
添加
export PATH=$PATH:/usr/local/node/binsource /etc/profile確保 Node.js 和 npm 已正確安裝
?再次執行
# 切換到 YApi 目錄
cd /usr/local/node/bin/my-yapi/vendors/server# 用 PM2 啟動 YApi（命名為 yapi）
pm2 start app.js --name yapi# 設置開機自啟
pm2 startup
pm2 save
3.2 常用 PM2 命令
# 查看 YApi 運行狀態
pm2 status yapi# 查看日志
pm2 logs yapi# 重啟 YApi
pm2 restart yapi# 停止 YApi
pm2 stop yapi# 監控資源占用
pm2 monit瀏覽器訪問?http://你的服務器IP:3000?確認 YApi 界面是否加載。
完成后，YApi 將由 PM2 守護運行，即使服務器重啟也會自動恢復。
4.常見問題
如果遇到注冊一個賬號隔一會或第二天就提示不存在了
4.1. 確認 MongoDB 是否安裝
運行以下命令檢查 MongoDB 是否已安裝：
bash
復制
下載
# 檢查 MongoDB 程序是否存在 which mongod# 或查看安裝包 rpm -qa | grep mongo
-
如果無輸出，說明?MongoDB 未安裝，需先安裝。
-
如果有輸出（如?
mongodb-org-server-4.4.x），說明已安裝但服務未正確配置。
4.2. 安裝 MongoDB（若未安裝）
步驟 1：添加 MongoDB 官方倉庫
bash
復制
下載
# 創建 MongoDB 倉庫文件 cat <<EOF | sudo tee /etc/yum.repos.d/mongodb-org-4.4.repo [mongodb-org-4.4] name=MongoDB Repository baseurl=https://repo.mongodb.org/yum/redhat/7/mongodb-org/4.4/x86_64/ gpgcheck=1 enabled=1 gpgkey=https://www.mongodb.org/static/pgp/server-4.4.asc EOF
步驟 2：安裝 MongoDB
bash
復制
下載
sudo yum install -y mongodb-org# 啟動服務并設置開機自啟 sudo systemctl start mongod sudo systemctl enable mongod
步驟 3：驗證服務狀態
bash
復制
下載
sudo systemctl status mongod # 確認狀態為 "active (running)"
4.3. 如果 MongoDB 已安裝但服務未啟動
可能原因：
-
服務名稱不符（如某些系統使用?
mongodb?而非?mongod）。 -
服務文件未正確生成。
解決方案：
bash
復制
下載
# 嘗試其他常見服務名稱 sudo systemctl status mongodb# 手動查找服務文件 ls /usr/lib/systemd/system/mongod* # 或 mongodb*# 如果存在服務文件但未啟動 sudo systemctl start mongod sudo systemctl enable mongod
4.4. 檢查 MongoDB 數據目錄
YApi 的數據依賴 MongoDB，需確保數據目錄存在且權限正確：
bash
復制
下載
# 默認數據目錄 ls -l /var/lib/mongo# 如果目錄不存在，手動創建并授權 sudo mkdir -p /var/lib/mongo sudo chown -R mongod:mongod /var/lib/mongo
4.5. 重新啟動 YApi
確保 MongoDB 正常運行后，重啟 YApi：
bash
復制
下載
cd /usr/local/node/bin/my-yapi/vendors/server pm2 restart app.js --name yapi
4.6. 驗證 YApi 數據持久化
連接到 MongoDB 檢查 YApi 的賬號數據是否存在：
bash
復制
下載
mongo use yapi db.user.find() # 查看已注冊的用戶
-
如果?
user?集合為空，說明之前的數據未持久化，需重新注冊賬號并觀察是否再次丟失。
?
