Support

Get help with OpenWrt Manager

Requirements

📡 OpenWrt Router

OpenWrt 19.07 or later (21.02+ / 23.05 recommended)
The uhttpd web server and ubus HTTP API must be enabled
Default: LuCI is installed and accessible via HTTP on port 80

📱 Mobile Device

iOS 13.0 or later / Android 5.0 or later
Can reach the router via local network or the internet

🌍 Remote Access (Optional)

You don't have to be on the same LAN. The App can connect to any reachable OpenWrt router, including:

Public IP — If your router has a public IP, enter it directly (with the correct port if non-standard).
Domain name — Use a domain or DDNS hostname pointing to your router. HTTPS is auto-enabled for domains.
frpc / frp tunnel — If you expose your router's HTTP(S) port via frpc, use the frp server address and mapped port.
Cloudflare Tunnel / Tailscale / ZeroTier / WireGuard — Any reverse proxy or VPN tunnel that makes the ubus HTTP API reachable will work.

⚠ When exposing your router to the internet, always enable HTTPS and use a strong password to prevent unauthorized access.

Getting Started

Local Network

Ensure your phone and the OpenWrt router are on the same local network (WiFi or wired).
Open the App and enter the router's LAN IP address (usually 192.168.1.1).
Enter the root user password and tap Connect.
If connection succeeds, you'll see the dashboard with real-time stats.

Remote Access

Enter the public IP, domain, or tunnel address of your router (e.g. router.example.com or frp.myserver.com:8080).
The App auto-enables HTTPS for domain names. For IP addresses, toggle HTTPS manually if your setup requires it.
Enter the root user password and tap Connect.
All features work the same as on a local connection.

Frequently Asked Questions

Cannot connect to the router?

Local: Make sure your device is on the same WiFi network as the router. Verify the address is correct (try opening http://192.168.1.1 in your phone's browser first).
Remote: Verify the public address/port is reachable (test in a browser). Check that your tunnel (frpc, Cloudflare, etc.) is running and the port mapping is correct.
If using HTTPS and it fails, try switching to HTTP — your router or tunnel endpoint may not have HTTPS configured.

Login fails with "Authentication failed"?

Double-check the root password. This is the same password you use to log in to the LuCI web interface. If you changed the password recently, make sure you're using the updated one.

Some features are unavailable?

Certain features require specific OpenWrt packages. For example, traffic statistics per device require nlbwmon or luci-app-nlbwmon. Port status detection requires /sys/class/net to be accessible via the ubus file API.

iOS: "Allow Local Network Access" prompt?

The App needs local network access to communicate with your router. Please tap Allow when iOS prompts you. If you denied it previously, go to Settings → Privacy → Local Network and enable it for OpenWrt Manager.

How is my password stored?

If you choose to save it, the password is stored in your device's secure storage (iOS Keychain / Android Keystore), encrypted at rest. It is never sent to any server other than your router. See our Privacy Policy for details.

Troubleshooting Tips

Restart the App if the dashboard shows stale data.
Pull down on the dashboard to force a manual refresh.
If firewall rules don't take effect, go to Maintenance → Reload Firewall.
On iOS, if connections fail after an OS update, delete and reinstall the App.

Contact

For bug reports, feature requests, or general inquiries, please open an issue on the project's GitHub repository or contact the developer via email.

技术支持

获取 OpenWrt Manager 使用帮助

系统要求

📡 OpenWrt 路由器

OpenWrt 19.07 或更高版本（推荐 21.02+ / 23.05）
必须启用 uhttpd Web 服务器和 ubus HTTP API
默认：已安装 LuCI 且可通过 HTTP 80 端口访问

📱 移动设备

iOS 13.0 或更高版本 / Android 5.0 或更高版本
能通过局域网或互联网访问到路由器即可

🌍 远程访问（可选）

不一定要在同一局域网内。只要能访问到路由器的 ubus HTTP 接口，本应用就能连接，包括：

公网 IP——如果路由器有公网 IP，直接输入即可（非标准端口需附带端口号）。
域名——使用指向路由器的域名或 DDNS 地址。输入域名时应用会自动开启 HTTPS。
frpc / frp 内网穿透——如果通过 frpc 将路由器 HTTP(S) 端口映射出去，使用 frp 服务器地址和映射端口即可。
Cloudflare Tunnel / Tailscale / ZeroTier / WireGuard——任何能让 ubus HTTP API 可达的反向代理或 VPN 隧道均可使用。

⚠ 将路由器暴露到公网时，请务必启用 HTTPS 并使用强密码，防止未授权访问。

快速开始

局域网连接

确保手机和 OpenWrt 路由器在同一局域网内（WiFi 或有线）。
打开应用，输入路由器的局域网 IP 地址（通常为 192.168.1.1）。
输入 root 用户密码，点击连接。
连接成功后即可看到实时数据的仪表盘。

远程连接

输入路由器的公网 IP、域名或隧道地址（例如 router.example.com 或 frp.myserver.com:8080）。
输入域名时应用会自动开启 HTTPS；IP 地址需要手动切换 HTTPS（如果你的配置需要）。
输入 root 用户密码，点击连接。
所有功能与局域网连接时完全一致。

常见问题

无法连接到路由器？

局域网：确认手机和路由器在同一 WiFi 网络。检查地址是否正确（可先在手机浏览器中访问 http://192.168.1.1 验证）。
远程：确认公网地址/端口可达（可在浏览器中测试）。检查隧道（frpc、Cloudflare 等）是否正常运行，端口映射是否正确。
如果 HTTPS 无法连接，请尝试切换到 HTTP——你的路由器或隧道端点可能未配置 HTTPS。

登录时提示"认证失败"？

请确认 root 密码是否正确。这与登录 LuCI 网页界面的密码相同。如果最近修改过密码，请使用新密码。

部分功能不可用？

某些功能需要特定的 OpenWrt 软件包。例如，按设备统计流量需要 nlbwmon 或 luci-app-nlbwmon。端口状态检测需要 /sys/class/net 通过 ubus file API 可访问。

iOS 提示"允许本地网络访问"？

应用需要本地网络权限才能与路由器通信。当 iOS 弹出提示时请点击允许。如果之前已拒绝，请前往设置 → 隐私与安全 → 本地网络为 OpenWrt Manager 开启权限。

密码如何存储？

如果选择保存密码，密码会存储在设备的安全存储中（iOS Keychain / Android Keystore），静态加密。密码永远不会发送到你的路由器以外的任何服务器。详见隐私政策。

故障排除

如果仪表盘显示旧数据，请重启应用。
在仪表盘下拉可强制手动刷新。
如果防火墙规则未生效，前往维护 → 重载防火墙。
在 iOS 上，如果系统更新后连接失败，请删除并重新安装应用。

联系我们

如需报告 Bug、提交功能建议或一般咨询，请在项目的 GitHub 仓库中提交 Issue，或通过邮件联系开发者。