OpenWrt 基础配置与插件安装 的完整指南

一、 OpenWrt 基础配置

首次刷入 OpenWrt 并通过网线连接路由器后，在浏览器输入默认后台地址（通常为 192.168.1.1）即可登录。默认用户名一般为 root，初始密码可能为空或 password。

建议按照以下顺序完成基础网络配置：

1. 修改管理员密码

• 路径：系统 (System) -> 管理权 (Administration)

• 操作：输入并确认新密码，点击页面底部的 保存并应用。

2. 设置 LAN 口 IP 地址

如果路由器的默认 IP（如 192.168.1.1）与您光猫或其他主路由冲突：

• 路径：网络 (Network) -> 接口 (Interfaces) -> LAN -> 点击 修改 (Edit)

• 操作：

  • 修改 IPv4 地址（例如改为 192.168.2.1）。

  • 修改 IPv4 网关 和 广播（通常会自动适配）。

  • 滚动到最下方，点击 保存 & 应用。之后需要使用新 IP 重新登录后台。

3. 配置联网与 IPv4/IPv6

• 拨号上网（PPPoE）：

  • 路径：网络 (Network) -> 接口 (Interfaces) -> WAN -> 点击 修改。

  • 将协议改为 PPPoE，填入宽带账号和密码，点击 保存 & 应用。

• DNS 设置：

  • 在 WAN 口配置中或 网络 -> DHCP/DNS 中，可以手动指定公共 DNS（如阿里 DNS 223.5.5.5、腾讯 DNS 119.29.29.29 或 1.1.1.1）。

二、 软件源（repositories）配置与更新

在安装插件之前，必须确保软件源配置正确，否则会出现找不到安装包或报错的情况。

1. 路径：系统 (System) -> 软件包 (Software)

2. 检查源地址：点击 配置操作 (Configuration)，检查自定义软件源列表：

   • 确保软件源版本与您的 OpenWrt 主版本号（如 23.05 等）严格一致。

   • 第三方编译版通常已经内置了源，直接使用即可。

3. 更新列表：点击 刷新列表 (Update lists) 按钮，等待系统同步软件仓库信息。

三、 插件安装方法

OpenWrt 安装插件主要有两种方式：在线安装（通过 LuCI 界面） 和 离线安装（上传 IPK 文件）。

方法 1：通过 LuCI 界面在线安装（推荐）

1. 进入 系统 (System) -> 软件包 (Software)。

2. 在 过滤器 (Filter) 输入框中搜索您需要的插件名称（例如 luci-app-ttyd）。

3. 找到目标软件包后，点击右侧的 安装 (Install) 按钮。

4. 安装完成后，刷新网页即可在菜单栏看到新插件的入口。

方法 2：通过 IPK 文件离线安装

如果您下载了特定版本的 .ipk 插件安装包：

1. 进入 系统 (System) -> 软件包 (Software)。

2. 找到 上传软件包 (Upload package) 区域，点击 选择文件 并选中您的 .ipk 文件，点击 上传。

3. 上传后系统会提示依赖关系，点击 安装 即可。

   • 注意：离线安装容易遇到依赖缺失报错，建议优先使用在线安装。

四、 常用必备插件推荐

根据不同需求，以下是 OpenWrt 上最常用的插件清单：

五、 常见问题与排错

1. 安装插件提示空间不足（No space left on device）：

   • 原因：路由器闪存（ROM）太小，通常是由于安装了体积较大的插件。

   • 解决：精简不需要的插件，或者使用外挂 U 盘进行扩容（Overlay 挂载）。

2. 更新列表失败（Failed to send request / 域名解析错误）：

   • 原因：路由器本身无法联网，或者 DNS 配置不正确。

   • 解决：检查 WAN 口连接状态，尝试在 DHCP/DNS 中将 DNS 服务器临时修改为 8.8.8.8 或 114.114.114.114。