开启 FTP 与 SFTP 服务:配置文件开关与端口说明
除了 WebDAV,OpenList 还能当 FTP / SFTP 服务器——老牌 FTP 客户端、脚本工具、某些电视盒子的兼容通道。
关键前提:配置文件里要开开关
这是 FTP 服务最大的坑:只在后台管理界面里填设置是不够的,必须同时把配置文件(data/config.json)里 ftp 段的 enable 改成 true,然后重启 OpenList 才会真正监听端口。SFTP 同理,改的是 sftp 段(注意别改错段)。
配置文件的位置与编辑方法见 config.json 关键字段。
端口与关键参数
| 服务 | 默认端口 | 开关位置 |
|---|---|---|
| FTP | 5221 | 配置文件 ftp.enable + 后台设置 |
| SFTP | 5222 | 配置文件 sftp.enable |
FTP 段里还有被动模式端口、连接超时等参数,公网环境部署在 NAT 后面时要注意被动端口范围的放行;具体字段含义见配置文件注释与官方文档。
客户端连接
- 用户名密码:与网页登录一致(同样受用户权限位控制,FTP 读 / FTP 写是独立权限)
- FTP 客户端(FileZilla 等)地址填主机 + 5221;SFTP 客户端填 5222
- 连不上时按顺序查:配置文件开关是否改了 → 是否重启过 → 后台 FTP 设置是否启用 → 防火墙 / 安全组是否放行端口
与 WebDAV 怎么选
| 场景 | 建议 |
|---|---|
| 播放器、现代文件管理器 | WebDAV(见 WebDAV 服务) |
| 老设备、只认 FTP 的工具链 | FTP |
| 需要加密传输的脚本自动化 | SFTP |
功能重叠度高,现代场景优先 WebDAV;FTP/SFTP 更多是兼容性兜底。