檔案與維運工具

WebDAV

在側邊欄「檔案服務」分組的「WebDAV 服務」中設定。

欄位	預設值	說明
enable	關閉	啟用服務，啟用時至少需要一位使用者
listenIp	空	監聽位址，留空監聽所有位址
port	18800	監聽連接埠
tls	關閉	啟用 HTTPS，憑證由 SSL 憑證 模組依 SNI 提供
users	無	多使用者，每位使用者包含 name、password、root（絕對路徑目錄）與 readOnly，或使用 mounts 掛載多個目錄

每位使用者可以對應到一個目錄，也可以掛載多個目錄：

• 單一目錄：填寫 root 與 readOnly，登入後根目錄就是該目錄。
• 多個目錄：在介面中點「掛載多個目錄」，或在 mounts 中填寫多項，每項包含 name（顯示名稱，不能含 /，同一使用者內不可重複）、path（絕對路徑）與 readOnly。登入後根目錄依名稱列出各目錄，根目錄本身無法寫入，檔案也無法在不同目錄之間移動。

從 Lucky 遷移時，使用者的掛載清單會轉換為多個目錄；Lucky 中重複出現的同名同密碼使用者會合併為一位使用者。

FTP

在「檔案服務」分組的「FTP 服務」中設定，支援 FTP 與 FTPS。

欄位	預設值	說明
enable	關閉	啟用服務，啟用時至少需要一位使用者
listenIp	空	監聽位址，留空監聽所有位址
port	2121	監聽連接埠
passiveStart / passiveEnd	0	被動模式資料連接埠範圍，均為 0 時由系統隨機分配；填寫時需滿足 1 ≤ 起始 ≤ 結束 ≤ 65535，並在防火牆與連接埠對應中放行該範圍
publicHost	空	被動模式對外通告的 IP，位於 NAT 之後時填寫公網或轉發後的 IP，僅支援 IP 位址，留空自動取連線位址
tlsMode	0	0 為明文與 FTPS 均可，1 為必須使用顯式 FTPS（AUTH TLS），2 為隱式 FTPS（連線即加密）；非 0 時憑證由 SSL 憑證 模組依 SNI 提供
idleTimeout	900	連線閒置多少秒後中斷
connectionTimeout	30	建立資料連線的逾時秒數
disableActiveMode	關閉	僅使用被動模式，更適合 NAT 環境
users	無	多使用者，欄位同 WebDAV：name、password、root、readOnly 或 mounts，使用者名稱不可重複

可從 Lucky 的 FTP 設定匯入服務參數與使用者（見 從 Lucky 遷移）。

儲存掛載

在「檔案服務」分組的「儲存掛載」中新增掛載點，在頁面內線上管理檔案。

欄位	說明
name、remark、enable	名稱、備註與啟用開關
type	local（本機目錄）、webdav（遠端 WebDAV）或 smb（SMB 共用）
path	本機目錄，需為已存在的絕對路徑（local 使用）
url、username、password	遠端位址與帳號，密碼在介面中遮蔽（webdav、smb 使用）。WebDAV 位址以 http:// 或 https:// 開頭；SMB 位址形如 smb://主機[:連接埠]/共用名稱[/子目錄]，支援 SMB2/3，使用者名稱留空時以來賓身分存取
skipVerify	略過 HTTPS 憑證驗證（webdav 使用）
domain	SMB 認證所用的網域或工作群組，通常留空（smb 使用）
readOnly	唯讀掛載，檔案管理拒絕一切寫入操作

可從 Lucky 的儲存管理匯入本機目錄與 WebDAV 儲存，阿里雲盤與系統掛載不遷移。

線上檔案管理支援瀏覽目錄、下載檔案、串流上傳（不把整個檔案載入記憶體）、新增目錄、重新命名和刪除。掛載點可作為備份工作的目標位置，備份檔案寫入掛載點中指定的目錄，並依保留策略清理舊檔案。

網路喚醒

在「網路喚醒」中管理裝置，向裝置發送魔術封包（6 位元組 0xFF 後接 16 次 MAC）。

欄位	預設值	說明
name	無	裝置名稱，必填
macs	無	MAC 位址，每行一個，至少一個，可為同一裝置填多個
broadcastIps	空	IPv4 廣播位址，留空時向 255.255.255.255 及各啟用網卡的廣播位址發送
port	9	目標 UDP 連接埠
repeat	3	每個 MAC 重複發送次數，上限 20
checkAddr	空	上線偵測位址，格式 主機:連接埠，如 192.168.1.10:3389，留空不偵測
remark	空	備註

在裝置清單上點擊喚醒即發送魔術封包，並依 checkAddr 顯示裝置是否在線。

排程工作

依 cron 運算式定時執行命令或發起 HTTP 請求。

• spec 支援標準 5 段運算式、可選的秒欄位（6 段，如 */30 * * * * *）以及 @every 10m、@daily 等描述符；
• type 為 command 時，透過 sh -c（Windows 為臨時 .bat）執行 command，環境變數中注入 taskName 及帶 GATELY_ 前綴的同名大寫變數；
• type 為 http 時依 http 設定發起請求，欄位包括 url、method（GET、POST、PUT、PATCH、DELETE）、headers（每項 Key: Value）、body、successContent（回應本文需包含其中任意一項才算成功，為空時只檢查 2xx）、timeout 與 insecureSkipVerify；
• 工作可啟用或停用，頁面顯示下次執行時間，可手動立即執行；
• 同一工作上一次尚未結束時，本次觸發會被略過；
• 每個工作保留最近 20 次執行記錄，包含開始時間、耗時、成功與否、是否手動觸發，以及輸出（最多保留 4000 字元摘要）；
• 建立表單提供運算式解析驗證。

概覽與系統日誌

• 「概覽」頁顯示主機資訊：CPU 型號、使用率與負載，記憶體，磁碟，網卡位址與即時速率，公網 IPv4 與 IPv6（點擊複製），各模組的服務狀態，以及 Gately 程序的版本、提交、建置時間、啟動時間、PID、CPU、常駐記憶體、Go 堆積與 goroutine 數；
• 「系統日誌」頁彙整各模組日誌，包括 Docker、FTP、排程工作等模組的執行記錄。

主題

介面提供 15 個色系，分為 Gately 原創（翠綠、海洋、清新、櫻花、暮光、午夜、龐克）與經典配色（GitHub, Nord, Dracula, Catppuccin, Tokyo Night, Gruvbox, Rosé Pine, Solarized），每個色系都有亮色與暗色兩種版本。模式可選亮色、暗色或跟隨系統，跟隨系統時使用目前色系對應的亮色或暗色版本。主色可在任一色系上改為 10 種預設顏色之一，或用系統取色器自選，Logo 與登入頁漸層隨之變化，重新選擇色系會清除自訂主色；圓角可選直角、跟隨色系或圓潤。主題設定儲存在瀏覽器本機。