Lucky 移动端 API 对接完整指南快速打造随身远程管理 App【免费下载链接】lucky软硬路由公网神器,ipv6/ipv4 端口转发,反向代理,DDNS,WOL,ipv4 stun内网穿透,cron,acme,rclone,ftp,webdav,filebrowser项目地址: https://gitcode.com/GitHub_Trending/luc/luckyLucky 是一款软硬路由公网神器集 ipv4/ipv6 端口转发、反向代理、DDNS 域名同步、WOL 网络唤醒于一体。本文面向想给 Lucky 做一个移动端 App 的新手带你从零跑通Lucky API对接怎么登录拿 Token、端口转发/DDNS/唤醒这些常用接口怎么调、哪里最容易翻车。读完你手上就是一个能随时查状态、改规则、远程开机的完整方案不用再被管理后台只能在电脑上打开限制住。为什么值得自己搓一个移动端先说场景Lucky 跑在软路由或光猫上管理后台默认监听16601端口浏览器访问很方便。但出门在外时你可能就想要几件事——看一眼 DDNS 任务是不是还在正常同步IP 换了域名没跟上网站直接挂确认某条端口转发规则还开着家里 PC 睡了远程唤醒一下这些操作在手机浏览器里点来点去很痛苦原生 App 或者套壳 H5 体验会好很多。而 Lucky 的所有功能都有对应的 RESTful 接口官方 Web 后台本身就是调同一套 API 的所以移动端开发本质就是复用官方 Web 前端的请求逻辑不用自己发明协议。最小可用方案登录 一个 Token整个对接只有一道门槛Token。除了/api/login所有接口都要在请求头里带上Authorization后端会逐个校验。登录接口接受 JSON注意字段是首字母大写的Account/Password// POST http://路由IP:16601/api/login const { token } await post(http://192.168.31.1:16601/api/login, { Account: admin, Password: 你的管理密码 }) // 之后所有请求都带上它 const rules await get(/api/portforwards, { headers: { Authorization: token }, params: { _: Date.now() } // 防缓存参数前端一直这么干 })拿到的 Token 是一个有效期 24 小时的 JWT存本地即可不用频繁重新登录。官方前端的请求封装可以直接抄思路web/adminviews/src/request/ 里用 axios 统一设置了Content-Type: application/json、5 秒超时并在响应ret -1时自动跳回登录页。分场景拆解五类高频接口状态与日志App 首页数据源首页仪表盘的数据基本就靠这两个接口轮询GET /api/status拿系统运行状态GET /api/logs?pre时间戳增量拉日志pre传上次拉取的时间戳即可。再配上GET /api/info看版本信息一个状态卡片就齐了。端口转发规则的增删改查这是移动端最常用的模块接口模式是典型的列表用复数、操作走单数动作方法与路径规则列表GET /api/portforwards新增规则POST /api/portforward修改规则PUT /api/portforward删除规则DELETE /api/portforward?key规则key启用/停用GET /api/portforward/enable?keyenable规则日志GET /api/portforward/logs?keypagepageSize规则支持 tcp4/tcp6 端口范围、目标 IP、黑白名单与 256 端口参数界面上的开关按钮对应的就是 enable 接口移动端做一个 Toggle 直接复用即可。DDNS任务同步状态与 IP 历史DDNS 模块接口同构GET /api/ddnstasklist拉任务POST /api/ddns添加PUT/DELETE /api/ddns?key改删GET /api/ddns/enable切换开关。任务详情里能看到公网 IP、TTL、最后检测时间移动端做成时间线展示最直观——反向代理与 SSL 证书反向代理同样是列表复数、操作单数GET /api/reverseproxyrules、POST/PUT/DELETE /api/reverseproxyrule开关走GET /api/reverseproxyrule/enable?ruleKeyproxyKeyenable日志走GET /api/reverseproxyrule/logs。SSL 证书管理在/api/ssl上做全套增删改查移动端如果做一键申请证书页面直接对接它就行。WOL 网络唤醒手机端最能打的场景WOL 是移动端体验提升最大的模块——躺在床上喊设备开机。接口只有五个全都围绕设备动作方法与路径设备列表GET /api/wol/devices添加设备POST /api/wol/device修改设备PUT /api/wol/device删除设备DELETE /api/wol/device?key唤醒设备GET /api/wol/device/wakeup?key唤醒就是一个 GET 请求一行搞定await get(/api/wol/device/wakeup?key${deviceKey}_${Date.now()}, { headers: { Authorization: token } })踩坑清单这些地方最容易翻车字段大小写登录报登录失败,登录请求解析出错九成是字段写成了username/password。后端解析的是Account/Password一个字母都不对。⚠️Token 失效别死磕接口返回ret: -1, msg: 登录失效说明 Token 无效或已过期24 小时。另外注意——在后台改了管理员密码旧 Token 立刻全部作废登录时机的随机 key 会变移动端收到ret-1的正确姿势是清 Token、跳登录而不是无限重试。️防登录锁连续输错密码 99 次登录功能会被禁用只能重启 Lucky 程序。移动端做暴力重试策略前务必先读这条。性能优化四件套规则列表这类高频数据做本地缓存首页对/api/status做心跳轮询而不是长连接网络抖动时对唤醒、保存这类写操作做有限次重试关键配置本地留一份断网恢复后再同步。延伸资源源码就是最佳文档后端全部路由注册在一处web/web.go想看某个模块的完整接口表直接翻它前端每个接口的请求写法web/adminviews/src/apis/移动端照着改就行各模块配置结构定义config/请求体的字段名、类型一目了然界面截图参考previews/设计移动端页面时对着做想本地跑起来看接口git clone https://gitcode.com/GitHub_Trending/luc/lucky接口清单就这么多登录换 Token 之后剩下的都是 CRUD 的排列组合。现在就去把 Token 跑通你的 Lucky 移动端第一个页面半小时就能上线 【免费下载链接】lucky软硬路由公网神器,ipv6/ipv4 端口转发,反向代理,DDNS,WOL,ipv4 stun内网穿透,cron,acme,rclone,ftp,webdav,filebrowser项目地址: https://gitcode.com/GitHub_Trending/luc/lucky创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考