Airi 是一款專為現代開發者設計的輕量級開源應用框架。無論你是想搭建個人服務還是企業級的微型工具，Airi 憑藉其極簡的架構和高效的性能，都能讓你快速上手。今天這篇文章就來跟大家分享如何從零開始安裝並部署 Airi 項目。
環境準備
在開始安裝 Airi 之前，請確保你的伺服器或本地開發環境已經具備以下基礎配置：
| 依賴組件 | 推薦版本 | 說明 |
|---|---|---|
| Node.js | v18.x 或以上 | 核心運行環境 |
| Docker | v20.10+ (選配) | 用於容器化快速部署 |
| Git | 最新版本 | 用於複製源代碼 |
第一步：獲取源代碼
首先，我們需要將 Airi 的開源倉庫克隆（Clone）到本地環境中：
git clone https://github.com/example/airi.git cd airi
第二步：安裝依賴與配置
進入項目目錄後，執行包管理命令來安裝所有必要的依賴物件：
npm install
接著，複製環境變數範例文件並進行修改。你可以使用 vim 或任何文字編輯器打開 .env 來設定你的通訊埠（Port）和資料庫連接資訊：
cp .env.example .env nano .env
💡 提示： 預設情況下，Airi 會運行在 3000 埠。如果該埠已被佔用，請務必在 .env 文件中修改 PORT=你的埠號。
第三步：本地啟動與測試
一切就緒後，便可以嘗試在本地啟動開發伺服器：
npm run dev
當終端機顯示 Airi is running on http://localhost:3000 時，即代表本地安裝成功！
第四步：生產環境部署 (Docker)
如果你打算將 Airi 部署到正式的雲端伺服器（如 AWS、DigitalOcean 等），強烈推薦使用 Docker 進行容器化部署，這樣可以確保環境的一致性：
# 構建 Docker 鏡像 docker build -t airi-app . # 運行容器 docker run -d -p 80:3000 --name airi-instance airi-app
運行後，你便可以直接透過伺服器的公網 IP 或綁定的網域訪問你的 Airi 服務了。
結語
透過以上簡單的四個步驟，我們就完成了 Airi 項目從本地安裝到生產環境部署的完整流程。Airi 的架構非常適合進行二次開發，接下來你可以根據官方文件嘗試編寫自己的第一個 Plugin 囉！有任何問題歡迎在下方留言討論。