文件与运维工具

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 堆与协程数；
• 「系统日志」页汇总各模块日志，包括 Docker、FTP、计划任务等模块的运行记录。

主题

界面提供 15 个色系，分为 Gately 原创（翠绿、海洋、清新、樱花、暮光、午夜、朋克）和经典配色（GitHub, Nord, Dracula, Catppuccin, Tokyo Night, Gruvbox, Rosé Pine, Solarized），每个色系都有亮色与暗色两种版本。模式可选亮色、暗色或跟随系统，跟随系统时使用当前色系对应的亮色或暗色版本。主色可在任一色系上改为 10 种预设颜色之一，或用系统取色器自选，Logo 与登录页渐变随之变化，重新选择色系会清除自定义主色；圆角可选直角、跟随色系或圆润。主题设置保存在浏览器本地。