Ultra Explorer Docs

自架

Docker、手機與 PWA

用 Docker Compose 在您的 NAS 或伺服器上執行 Ultra Explorer,再像應用程式一樣安裝到手機上。介面為觸控而設計,而不只是縮小。

使用 Docker Compose 自架

網頁版是由 Ultra Explorer 伺服器提供的同一套介面。執行「docker compose up --build -d」,然後開啟 http://localhost:7373,並在啟動後 15 分鐘內在瀏覽器中建立管理員密碼(也可以在 .env 檔案中設定 ULTRA_ADMIN_PASSWORD 自行指定)。容器以非特權方式執行,捨棄 Linux 權能,使用唯讀根檔案系統,並把資料庫、rclone 設定和暫時傳輸狀態保存在 ultra-data 磁碟區中。

提示 :Compose 預設只綁定 127.0.0.1。切勿把 7373 連接埠直接暴露到網際網路。

透過 HTTPS 在手機上存取

若要在可信任的私人網路之外使用,請把服務放在 HTTPS 反向代理之後,並設定 ULTRA_SECURE_COOKIES=true。HTTPS 也是安裝的前提:Service Worker 和安裝提示需要安全的環境,即使在私人區域網路中也是如此。像伺服器內部 IP 這樣的 http:// 位址不符合要求。

作為應用程式安裝(PWA)

在手機瀏覽器中開啟該位址並登入。在 iPhone 和 iPad 上,點「分享」,再點「加入主畫面」,並保持「以網頁 App 開啟」開啟。在提供安裝提示的瀏覽器中,「設定」會顯示「安裝應用程式」按鈕。安裝後的應用程式有自己的圖示,開啟時沒有瀏覽器分頁。

提示 :當沒有可靠的安裝方式、應用程式已處於安裝狀態,以及在桌面應用程式內時,安裝控制項會被隱藏。

為觸控而設計

在小螢幕上,檔案總管的兩個窗格會堆疊,選取模式會加上所選檔案的動作列。設定採用清單與詳細資料版面。固定控制項始終位於系統安全區域內,瀏海、圓角和主畫面手勢不會遮住它們。

在 iPhone 和 iPad 上儲存檔案

在已安裝的應用程式中,下載的檔案保留在 Ultra Explorer 內。檔案接收完成後,「儲存…」會開啟系統分享選單(包括「儲存到檔案」),「全部儲存(N)…」會把所有就緒檔案傳送到同一個選單。這需要 iOS 26 或更高版本的 Safari 以及足夠的可用儲存空間。等待儲存的檔案是暫時的:請在關閉或登出前儲存。

需要了解的事

手機應用程式需要能夠連線到伺服器:它即時瀏覽和操作,不會快取檔案清單、API 回應、憑證或待處理的變更。伺服器無法使用時,會顯示在地化的頁面並提供重試。更新不會強制重新載入頁面;關閉後再開啟應用程式即可套用更新。