AI 寫的 TypeScript 程式怎麼常駐?用 PM2、監看頁和 Tunnel 管理維護
現在用 AI 寫 TypeScript 工具越來越容易,但程式寫好後,很快就會遇到下一個問題:關掉終端機就停了、電腦重開要手動啟動、服務一多就忘記哪個 Port 是誰,也不知道該怎麼更新。
我的建議是用 PM2 讓程式常駐,再建置 PM2 管理頁和 Node 程式監看頁,最後把 Port 接到 Cloudflare Tunnel。這樣什麼 Port 對應什麼網域一清二楚,AI 開發的工具也能用得更安心。這篇只談做法和重點,細部設定可以交給 AI Agent。
PM2 解決什麼問題?
PM2 是 Node.js 常用的程序管理工具,可以幫你:
- 讓程式常駐:在背景持續執行,不必一直開著終端機。
- 重開機後恢復:設定開機啟動並儲存程式清單後,可以自動帶回服務;macOS 也支援。
- 集中管理:用同一個清單查看狀態、重新啟動和查看記錄。
- 統一設定:把多個程式的名稱、路徑和啟動方式放進設定檔。
TypeScript 專案建議先編譯成 JavaScript,再交給 PM2 執行正式版本,這樣啟動比較單純,也更容易在上線前發現型別錯誤。
建議架構
AI 開發的 TypeScript 程式
↓ 編譯
PM2 常駐與管理
↓
PM2 管理頁 + Node 程式監看頁
↓
Cloudflare Tunnel(Port 對應網域)
PM2 管理頁:負責操作
把常用動作集中到一個頁面,例如查看程式清單、狀態、CPU 和記憶體,以及重新啟動或查看記錄。PM2 提供程式介面,可以取得清單並操作程序,所以可以請 AI Agent 依你的需求建置。
如果不想花錢,請注意 PM2 官方的 PM2 Plus 監控服務是付費的。PM2 本身可以免費使用,自建頁面也不需要使用 PM2 Plus。
Node 程式監看頁:負責看健康狀態
PM2 看得到程式有沒有在跑,但不一定知道服務功能是否正常。可以另外建置監看頁,檢查:
- 健康檢查網址是否正常回應。
- 版本、啟動時間和最後部署時間。
- 資料庫或外部 API 是否連得上。
- 最近的錯誤和重新啟動次數。
這個頁面可以和 PM2 管理頁併用:一個看服務是否真的健康,一個負責實際操作。
用 Tunnel 把 Port 和網域整理清楚
PM2 管理頁和其他服務的 Port,都可以接到 Cloudflare Tunnel。替每個服務固定 Port,再對應一個容易理解的網域,並整理成一份清單:
pm2.example.com → localhost:3100(PM2 管理頁)
monitor.example.com → localhost:3101(程式監看頁)
api.example.com → localhost:3200(工作 API)
tools.example.com → localhost:3300(內部工具)
服務一多,就不用再猜哪個 Port 是誰。Tunnel 的概念可以參考這篇 Mac mini 架站文章。
管理頁一定要加保護
這是整個架構最需要注意的地方。管理頁能重新啟動服務、查看記錄,等於握有後台權限;記錄裡也可能出現敏感資料。因此:
- 不要直接公開:接上 Tunnel 前,先用 Cloudflare Access 限定只有指定帳號能登入,也可以再限定 IP。
- 程式本身也要驗證:不能只依賴 Cloudflare,管理頁和 API 都要檢查權限。
- 只監聽本機:服務盡量綁定
127.0.0.1,避免同一個網路的其他裝置直接連線。 - 限制操作範圍:不要讓網頁可以執行任意指令;刪除、重新部署等動作要再次確認。
- 隱藏敏感資料:頁面和記錄都不要顯示 Token、密碼或環境變數內容。
做到這些能大幅降低風險,但沒有任何工具能保證絕對安全,所以仍要持續維護。
怎麼維護和更新?
AI 程式上線後,建議固定用同一套流程更新:
- 先備份:用 Git 記錄目前版本,並備份設定和資料。
- 檢查更新內容:查看重大變更,並用
npm audit檢查已知漏洞。 - 安裝和編譯:保留
package-lock.json,正式環境優先使用npm ci,再完成編譯和測試。 - 重新載入:用 PM2 重新載入或重新啟動服務。
- 確認健康狀態:回到監看頁檢查,並實際操作主要功能。
- 出問題就還原:退回上一個可正常運作的版本。
也別忘了這些容易遺漏的項目:
- Node.js:正式服務應使用 LTS 版本,並留意安全更新。升級 Node 後,PM2 的開機設定也要重新產生。
- 記錄檔:記錄會持續變大,可以用
pm2-logrotate自動輪替。 - 重開機測試:定期確認電腦重開後,所有服務都會恢復。
把困難的部分交給 AI Agent
可以直接用這段提示開始:
請協助我用 PM2 管理這台電腦上的 TypeScript 服務,並建置:
1. PM2 管理頁:查看狀態、記錄,並可重新啟動指定服務。
2. Node 程式監看頁:顯示健康檢查、版本和最近錯誤。
3. Cloudflare Tunnel 的 Port 與網域對應清單。
請遵守:
- 先編譯再執行,並設定開機後自動恢復。
- 服務只監聽 127.0.0.1。
- 管理頁公開前,先規劃 Cloudflare Access 和程式內權限檢查。
- 不提供執行任意指令的功能。
- 不顯示 Token、密碼或環境變數。
- 不使用付費服務;有費用時先告訴我。
- 修改前先備份,每一步都要驗證並說明如何復原。
之後也可以定期請它做維護:
請檢查所有 PM2 服務的依賴套件、Node.js 版本和已知漏洞,
列出建議更新與風險。先確認備份,再逐一更新;
每完成一項都要測試,出問題就還原,
重大變更先等我確認。
AI 寫的程式也要檢查。請它說明新增了哪些套件、開放哪些 Port 和權限。不要把 Token 或密碼貼進對話,也不要讓它在沒有備份時直接修改正式服務。
什麼時候不適合這樣做?
- 重要商業服務:如果不能中斷,需要再規劃備援、監控和正式維運。
- 處理金流或大量個資:建議先請資安或系統專業人員檢查。
- 商業使用:PM2 使用 AGPL-3.0 授權。如果你會修改或散布 PM2,或用於商業產品,請先確認授權義務。
- 無法持續維護:沒有時間更新時,不建議把服務長期公開。
快速整理
- TypeScript 先編譯,再用 PM2 常駐並設定開機恢復。
- PM2 管理頁負責操作,Node 監看頁負責確認服務健康。
- 每個服務固定 Port,透過 Tunnel 對應清楚的網域。
- 管理頁一定要加登入保護,也不能顯示敏感資料。
- 更新前先備份,更新後要測試,出問題要能還原。
- 困難的設定和定期維護,都可以交給 AI Agent,但重要操作要自己確認。
留言
張貼留言