在使用 HCL Domino 開發 XPages 或 Http應用程式時，檔案上傳功能是很常見的需求。然而，預設情況下，Domino 伺服器對於上傳檔案的大小有限制。如果需要允許使用者上傳較大的檔案，除了調整Domino 本身限制，在Xpages有時候就必須調整 `xsp.upload.maximumsize` 參數。本文將深入探討如何設定這個參數，並涵蓋所有相關的注意事項。
1. Domino伺服器設定文檔 (server document)
您也可以通過修改 Domino 伺服器設定文檔來設定 ，這種方法會影響伺服器上的所有 ＨＴＴＰ 應用程式。
- 在 Domino 管理員中，打開伺服器設定文檔。
- 導航到 “Internet Protocols” -> “HTTP” 標籤。
- Domino Web Engine
iNotes 檔案大小
若需要使用到inotes 時，也需調整如下
瞭解 xsp.upload.maximumsize
`xsp.upload.maximumsize` 參數定義了 XPages 應用程式中允許上傳的單個檔案的最大大小，以 MB 為單位。如果使用者嘗試上傳超過此限制的檔案，伺服器將會拒絕上傳，並可能顯示錯誤訊息。
設定 xsp.upload.maximumsize 的方法
如果您的應用程式是 XPage 應用程序，則還需要在資料庫的應用程式配置和 xsp.properties 檔案設定
或者，如果您想要全域設置，請將其新增至 Domino\Data\Properties 資料夾中的 xsp.properties 檔案。
xsp.upload.maximumsize=400
xsp.upload.maximumsize=400
注意事項
- 伺服器重新啟動： 在修改後，您需要重新啟動 Domino 伺服器才能使變更生效。修改伺服器設定文檔後，通常只需重新啟動 HTTP 任務即可。
- 與其他設定的關聯： `xsp.upload.maximumsize` 只是影響檔案上傳大小的一個因素。您還需要考慮其他相關的設定，例如：
- Java 堆大小： 如果您允許使用者上傳非常大的檔案，可能需要增加 Domino 伺服器的 Java 堆大小，以避免記憶體不足的錯誤。
- HTTP 伺服器逾時： 上傳大型檔案可能需要較長的時間。確保 HTTP 伺服器的逾時設定足夠長，以避免上傳過程中斷。
- 安全性： 允許上傳大型檔案可能會帶來安全風險。請確保您的應用程式具有適當的驗證和授權機制，以防止惡意使用者上傳危險的檔案。 定期掃描上傳的文件，確保當中沒有惡意程式碼。
- 使用者體驗： 在設定 `xsp.upload.maximumsize` 時，請考慮使用者的網路環境。如果使用者使用較慢的網路連接，上傳大型檔案可能會非常耗時。在這種情況下，您可以考慮限制檔案大小，或者提供進度條來改善使用者體驗。
總結
正確設定 `xsp.upload.maximumsize` 參數對於開發具有檔案上傳功能的 XPages 應用程式至關重要。通過本文的介紹，您應該能夠根據您的需求選擇合適的方法，並避免常見的錯誤。此外，請務必考慮安全性、效能和使用者體驗等因素，以確保您的應用程式能夠穩定、安全地運行。
與此同時，資安新聞指出，近期出現中國駭客 APT24 入侵臺灣數位行銷業者從事供應鏈攻擊，散布惡意程式 BadAudio 的事件。在調整檔案上傳設定時，也需要確保伺服器的安全性，避免成為駭客攻擊的目標。
參考文獻
- Setting the Maximum File Upload Size for an XPages Application (xcellerant.wordpress.com)
- Xpages – file upload (developer.ds.hcl-software.com)
- Maximum file upload size in HCL Domino all the places to edit (xpagedeveloper.com)
- Upload files to Domino (docs.dominodatalab.com)
- LO73474: XPAGES: UNABLE TO UPLOAD LARGE FILES (ibm.com)
原文來源
“`
🧠 本文由 DreamJ AI 自動網路探索生成系統撰寫，內容經 AI 模型審核與自動優化，
僅供技術參考與研究用途。
