AI 寫的 TypeScript 程式怎麼常駐?用 PM2、監看頁和 Tunnel 管理維護

現在用 AI 寫 TypeScript 工具越來越容易,但程式寫好後,很快就會遇到下一個問題:關掉終端機就停了、電腦重開要手動啟動、服務一多就忘記哪個 Port 是誰,也不知道該怎麼更新。

我的建議是用 PM2 讓程式常駐,再建置 PM2 管理頁和 Node 程式監看頁,最後把 Port 接到 Cloudflare Tunnel。這樣什麼 Port 對應什麼網域一清二楚,AI 開發的工具也能用得更安心。這篇只談做法和重點,細部設定可以交給 AI Agent。

AI 程式上線後的管理流程示意圖:編譯 TypeScript、PM2 常駐程式、管理頁操作服務、監看頁看健康、Tunnel 對應網域、備份後定期更新
示意圖:AI 開發的 TypeScript 程式上線後的管理流程

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 程式上線後,建議固定用同一套流程更新:

  1. 先備份:用 Git 記錄目前版本,並備份設定和資料。
  2. 檢查更新內容:查看重大變更,並用 npm audit 檢查已知漏洞。
  3. 安裝和編譯:保留 package-lock.json,正式環境優先使用 npm ci,再完成編譯和測試。
  4. 重新載入:用 PM2 重新載入或重新啟動服務。
  5. 確認健康狀態:回到監看頁檢查,並實際操作主要功能。
  6. 出問題就還原:退回上一個可正常運作的版本。

也別忘了這些容易遺漏的項目:

  • 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,或用於商業產品,請先確認授權義務。
  • 無法持續維護:沒有時間更新時,不建議把服務長期公開。

快速整理

  1. TypeScript 先編譯,再用 PM2 常駐並設定開機恢復。
  2. PM2 管理頁負責操作,Node 監看頁負責確認服務健康。
  3. 每個服務固定 Port,透過 Tunnel 對應清楚的網域。
  4. 管理頁一定要加登入保護,也不能顯示敏感資料。
  5. 更新前先備份,更新後要測試,出問題要能還原。
  6. 困難的設定和定期維護,都可以交給 AI Agent,但重要操作要自己確認。

相關文章

參考資料

留言

這個網誌中的熱門文章

用 AI 幫你寫工作 Email:可直接套用的提問範本

LINE 帳號被騙走怎麼辦?第一時間先做這 4 件事,不要急著自己搶救

LINE 來電不會響怎麼辦?App 和手機系統的通知權限都要開