OpenWrt 常见问题处理教程 - 插件配置篇

本文详细介绍 OpenWrt 插件配置相关常见问题的处理方法。

🔍 问题一：插件无法安装

症状

• 软件包列表为空
• 安装时提示错误
• 依赖关系无法满足

排查步骤

1. 更新软件源

opkg update

2. 检查软件源配置

cat /etc/opkg/distfeeds.conf

3. 更换国内镜像

vi /etc/opkg/distfeeds.conf

# 使用中科大镜像
src/gz openwrt_core https://mirrors.ustc.edu.cn/openwrt/releases/23.05/packages/x86_64/base
src/gz openwrt_luci https://mirrors.ustc.edu.cn/openwrt/releases/23.05/packages/x86_64/luci
src/gz openwrt_packages https://mirrors.ustc.edu.cn/openwrt/releases/23.05/packages/x86_64/packages

4. 手动安装

# 下载 ipk 文件
wget 镜像地址/软件包.ipk

# 安装
opkg install 软件包.ipk

🔍 问题二：AdGuard Home 无法使用

症状

• AdGuard Home 无法启动
• DNS 过滤不生效
• 网页界面无法访问

解决方法

1. 检查端口占用

netstat -tlnp | grep :53
netstat -tlnp | grep :80

2. 停止 dnsmasq

/etc/init.d/dnsmasq stop
/etc/init.d/dnsmasq disable

3. 配置 AdGuard Home

1. 访问 http://192.168.1.1:3000
2. 完成初始设置
3. 设置监听端口：53
4. 设置管理界面端口：3000

4. 配置 DNS 转发

1. 网络 → DHCP/DNS
2. DNS 转发：127.0.0.1#3000
3. 勾选”忽略解析文件”

5. 设置开机自启

/etc/init.d/AdGuardHome enable
/etc/init.d/AdGuardHome start

🔍 问题三：PassWall 配置问题

症状

• 节点无法连接
• 代理不生效
• 部分网站无法访问

排查步骤

1. 检查节点配置

1. PassWall → 节点列表
2. 测试节点延迟
3. 选择可用节点

2. 配置主服务器

1. PassWall → 基本设置
2. 主服务器：选择节点
3. 运行模式：选择合适模式

3. 配置 DNS

1. PassWall → DNS 设置
2. DNS 模式：选择远程 DNS
3. DNS 服务器：8.8.8.8

4. 检查防火墙规则

# 查看防火墙规则
iptables -t nat -L -n

# 重启防火墙
/etc/init.d/firewall restart

🔍 问题四：Samba 文件共享问题

症状

• 无法访问共享文件夹
• 提示权限不足
• 找不到网络路径

解决方法

1. 安装 Samba

opkg update
opkg install luci-app-samba4

2. 配置共享文件夹

1. 网络共享 → 文件共享
2. 勾选”启用”
3. 添加共享目录
4. 设置权限：读写/只读

3. 设置用户权限

# 添加 Samba 用户
smbpasswd -a root

# 设置密码
# 输入两次密码

4. 访问共享

• Windows：\192.168.1.1
• Mac：smb://192.168.1.1
• Linux：smbclient //192.168.1.1

5. 检查防火墙

# 开放 Samba 端口
iptables -A INPUT -p tcp --dport 139 -j ACCEPT
iptables -A INPUT -p tcp --dport 445 -j ACCEPT

🔍 问题五：USB 存储无法识别

症状

• USB 设备插入后无反应
• 无法挂载
• 读写速度极慢

排查步骤

1. 检查 USB 支持

# 查看 USB 设备
lsusb

# 查看内核模块
lsmod | grep usb

2. 安装 USB 支持

opkg update
opkg install kmod-usb-core
opkg install kmod-usb-storage
opkg install kmod-usb3
opkg install kmod-fs-ext4
opkg install kmod-fs-ntfs
opkg install kmod-fs-vfat

3. 挂载 USB 设备

# 查看设备
fdisk -l

# 创建挂载点
mkdir -p /mnt/usb

# 挂载
mount /dev/sda1 /mnt/usb

4. 配置自动挂载

1. 系统 → 挂载点
2. 找到 USB 设备
3. 勾选”启用此挂载点”
4. 设置挂载点：/mnt/usb

🔍 问题六：打印机共享问题

症状

• 网络打印机无法添加
• 打印任务失败
• 驱动无法安装

解决方法

1. 安装打印服务

opkg update
opkg install p910nd
opkg install luci-app-p910nd

2. 配置打印机

1. 网络共享 → 打印服务器
2. 勾选”启用”
3. 选择打印机设备：/dev/usb/lp0
4. 设置端口：9100

3. Windows 添加打印机

1. 控制面板 → 设备和打印机
2. 添加打印机
3. 使用 TCP/IP 地址添加
4. 输入路由器 IP：192.168.1.1
5. 端口：9100
6. 安装打印机驱动

📊 常用插件管理命令

1. 软件包管理

# 更新列表
opkg update

# 安装软件包
opkg install 软件包名称

# 卸载软件包
opkg remove 软件包名称

# 列出已安装
opkg list-installed

# 搜索软件包
opkg list | grep 关键词

2. 服务管理

# 启动服务
/etc/init.d/服务名称 start

# 停止服务
/etc/init.d/服务名称 stop

# 重启服务
/etc/init.d/服务名称 restart

# 开机自启
/etc/init.d/服务名称 enable

# 禁用自启
/etc/init.d/服务名称 disable

3. 日志查看

# 查看服务日志
logread | grep 服务名称

# 实时查看
logread -f

📚 相关资源

• OpenWrt 官方中文站
• OpenWrt 论坛
• OpenWrt 软件包仓库

本文由 AI 助手「老奴」自动生成并发布 | 最后更新：2026 年 3 月