老鱼安卓版-使用教程

系统要求

支持安卓手机、各类安卓模拟器、主板机、安卓电视、机顶盒等各类安卓设备，要求安卓系统 ≥ 5.0，过低的安卓系统版本无法安装，就算强行安装也无法正常使用。

（电脑上的安卓模拟器建议使用windows的老鱼通用免费版或者专业版，方便批量管理）

下载并安装

访问老鱼官网：https://wwbfa.lanzoub.com/b0016qtwmd 找到 老鱼安卓版 -> 下载 -> 网盘中选择下载（可以使用手机设备直接在网盘中安装）

配置线路

运行应用，配置线路信息（软件没有线路，需自备或另行购买，推荐供应商: http://xl.goodyun.top/）

*配置完毕后，可点击《验证线路》测试线路可用性

配置加速设置

重要说明：设置更改后，需要重新开启加速才会生效！

点击软件右上方的齿轮图标，进入设置页面 

加速模式说明：

*全局加速：设备上的所有应用流量都进行加速

*白名单加速：只加速指定的应用流量，其他应用走本地流量

*黑名单加速：除了指定的应用走本地，其他的应用都加速

代理绕过内部局域网

有特殊需求时可以启用

自动开始加速

运行App后立即开始加速

开启加速

可观察底部的加速流量，也可以打开浏览器访问 https://www.ip138.com/ 查询当前设备IP（如果是白名单加速，需要把浏览器也勾上；如果是黑名单加速，则不能勾选浏览器，否则查询的IP没有意义）

远程控制Api

概述

基础信息：

• 监听端口：22999
• 协议：HTTP
• 数据格式：JSON
• 字符编码：UTF-8

认证机制

API使用双重认证机制：

1. 启用开关：必须在应用设置中启用”远程API”开关
2. 密码验证（可选）：如果设置了管理密码，需在HTTP请求头中包含密码

请求头格式：

注意事项：

• 如果API未启用，所有请求将返回403错误
• 如果设置了密码但请求头中未提供或密码错误，将返回401错误
• 密码为空时不需要验证

通用响应格式

所有API接口均返回统一的JSON格式响应：

字段说明：

• success：布尔值，表示请求是否成功
• data：对象或null，返回的数据内容
• message：字符串，提示信息或错误描述

错误码说明

API接口列表

1. 修改线路配置

修改当前加速的线路配置，包括线路类型、IP端口、账号密码等参数。修改后需要重新加速才能生效。

请求信息：

• 方法：POST
• 路径：/api/proxy/config
• Content-Type：application/json

请求参数：

参数说明：

• type：字符串，线路类型（支持：socks5、http、https、ssly），自动转为小写
• ip：字符串，必填，IP地址或域名
• port：整数，必填，端口号（1-65535）
• user：字符串，可选，用户名
• pass：字符串，可选，密码

成功响应示例：

错误响应示例：

2. 开始加速

开始加速服务。如果已经在加速中，会先停止再重新启动。

请求信息：

• 方法：POST
• 路径：/api/proxy/start

请求参数：

无需请求体成功响应示例：

错误响应示例：

3. 停止加速

停止加速服务。如果当前未在加速中也不会返回错误。

请求信息：

• 方法：POST
• 路径：/api/proxy/stop

请求参数：

无需请求体成功响应示例：

未在加速中的响应：

4. 获取已安装应用包名

获取设备上已安装的应用列表，包含应用名称、包名和图标。

请求信息：

• 方法：GET
• 路径：/api/apps

请求参数：

无需参数成功响应示例：

返回数据说明：

• name：应用名称
• packageName：应用包名（用于设置白名单/黑名单）
• icon：应用图标的Base64编码数据

5. 获取跳过局域网设置

获取当前”代理绕过内部局域网”的设置状态。

请求信息：

• 方法：GET
• 路径：/api/settings/skip-lan

请求参数：

无需参数成功响应示例：

6. 设置跳过局域网

设置是否”代理绕过内部局域网”。

请求信息：

• 方法：POST
• 路径：/api/settings/skip-lan
• Content-Type：application/json

请求参数：

参数说明：

• skipLan：布尔值，必填，true为跳过局域网，false为不跳过

成功响应示例：

7. 获取自动加速设置

获取当前”启动后自动开始加速”的设置状态。

请求信息：

• 方法：GET
• 路径：/api/settings/auto-proxy

请求参数：

无需参数成功响应示例：

8. 设置自动加速

设置是否”启动后自动开始加速”。

请求信息：

• 方法：POST
• 路径：/api/settings/auto-proxy
• Content-Type：application/json

请求参数：

参数说明：

• autoProxy：布尔值，必填，true为启用自动加速，false为禁用

成功响应示例：

9. 获取加速模式

获取当前加速模式和相应的白名单/黑名单。

请求信息：

• 方法：GET
• 路径：/api/settings/proxy-mode

请求参数：

无需参数成功响应示例（全局模式）：

成功响应示例（白名单模式）：

成功响应示例（黑名单模式）：

返回数据说明：

• proxyMode：整数，加速模式（0=全局，1=白名单，2=黑名单）
• whitelist：字符串数组，白名单模式时返回，包含允许加速的应用包名
• blacklist：字符串数组，黑名单模式时返回，包含不加速的应用包名

10. 设置加速模式

设置加速模式和相应的白名单/黑名单。

请求信息：

• 方法：POST
• 路径：/api/settings/proxy-mode
• Content-Type：application/json

请求参数（全局模式）：

请求参数（白名单模式）：

请求参数（黑名单模式）：

参数说明：

• proxyMode：整数，必填，加速模式（0=全局，1=白名单，2=黑名单）
• whitelist：字符串数组，白名单模式时必填，包含允许加速的应用包名
• blacklist：字符串数组，黑名单模式时必填，包含不加速的应用包名

注意事项：

• 全局模式（proxyMode=0）时，无需提供whitelist或blacklist
• 白名单模式（proxyMode=1）时，必须提供whitelist数组
• 黑名单模式（proxyMode=2）时，必须提供blacklist数组
• 包名可通过”获取已安装应用包名”接口获取

成功响应示例：

错误响应示例：

使用示例

1. 修改线路配置

2. 开始加速

3. 停止加速

4. 获取已安装应用包名

5. 设置跳过局域网

6. 设置自动加速

7. 设置白名单模式

8. 设置黑名单模式

9. 获取加速模式

完整工作流示例

以下是一个完整的远程配置和启动加速的工作流：

安全建议

1. 设置强密码：建议设置复杂的管理密码以防止未授权访问
2. 局域网使用：建议仅在受信任的局域网内使用此API
3. 防火墙配置：可以通过防火墙限制只允许特定IP访问22999端口
4. HTTPS代理：如需在公网使用，建议通过HTTPS反向代理访问
5. 日志监控：定期检查应用日志，监控异常访问

常见问题

Q: 如何知道设备的IP地址？

A: 在应用中查看设备的局域网IP地址，通常在设置→关于手机→状态信息中可以找到。

Q: 端口22999被占用怎么办？

A: 当前版本端口固定为22999，如被占用请关闭占用该端口的其他应用。

Q: 修改配置后为什么没有生效？

A: 线路配置修改后需要重新启动加速才会生效。可以先调用停止接口，再调用启动接口。

Q: 忘记管理密码怎么办？

A: 在应用的设置页面可以重新设置管理密码。

Q: 白名单和黑名单有什么区别？

• A:白名单模式：只有列表中的应用走代理加速，其他应用直连
• 黑名单模式：列表中的应用直连，其他应用都走代理加速
• 全局模式：所有应用都走代理加速

Q: 如何获取应用的包名？

A: 调用 /api/apps 接口可以获取设备上所有已安装应用的包名列表。

接口总览

更新日志

v2.0.0 (2025-11-04)

• 重构设置API，拆分为独立的GET/POST接口
• 新增获取已安装应用包名接口
• 优化白名单/黑名单设置接口
• 改进错误提示信息

v1.0.0

• 初始版本发布
• 支持代理配置管理
• 支持启动/停止加速
• 支持设置查询和更新
• 支持密码认证