掌握iStore：OpenWRT应用商店完全配置指南

iStore是基于OpenWRT标准的轻量级应用商店，纯脚本实现且仅依赖系统原生组件。本文将系统讲解如何通过iStore高效管理OpenWRT应用，从环境准备到高级配置，帮助用户快速掌握这款实用工具。

如何快速部署iStore应用商店？

环境兼容性验证步骤

在部署iStore前，请确认设备满足以下条件：

• OpenWRT 21.x及以上版本系统
• x86_64/arm64架构支持
• ≥32MB可用存储空间
• 稳定网络连接

通过以下命令检查系统信息：

# 查看OpenWRT版本
cat /etc/openwrt_release | grep DISTRIB_RELEASE

# 检查存储空间
df -h /

高效部署方案

方案A：命令行极速安装

# 更新软件源
opkg update

# 下载安装脚本
wget -O /tmp/istore-installer.run https://gitcode.com/gh_mirrors/is/istore/raw/main/installer/istore-installer.run

# 执行安装
chmod +x /tmp/istore-installer.run && /tmp/istore-installer.run

方案B：手动安装流程

1. 访问OpenWRT管理后台
2. 进入 系统 > 软件包
3. 上传iStore安装包（可从项目仓库获取）
4. 点击"安装"并等待完成

iStore界面功能如何高效使用？

应用商店界面全解析

iStore界面主要包含三大功能区域：

• 左侧导航区：系统功能入口，含Store、Docker等核心模块
• 顶部标签栏：提供"已安装"、"全部软件"等视图切换
• 应用展示区：网格布局展示应用卡片，包含图标、名称、版本及操作按钮

应用管理核心操作

快速查找与安装应用

1. 在顶部搜索框输入关键词（如"ddns"）
2. 在结果列表中点击目标应用卡片
3. 点击"安装"按钮，系统自动处理依赖关系
4. 等待进度条完成，应用自动启用

已安装应用维护

1. 切换至"已安装"标签页
2. 查看应用状态及版本信息
3. 可执行更新/卸载操作
4. 部分应用提供快捷访问入口

如何深度定制iStore功能？

软件源配置进阶技巧

iStore支持自定义软件源，扩展应用获取渠道：

1. 编辑配置文件：/etc/config/istore
2. 添加新源配置：

config repository 'custom_repo'
    option name 'My Repository'
    option url 'https://example.com/packages'
    option enabled '1'

3. 重启服务使配置生效：/etc/init.d/istore restart

系统备份与迁移方案

通过iStore内置工具实现配置备份：

# 执行备份命令
/usr/libexec/istore/backup

# 备份文件路径
/tmp/istore_backup_*.tar.gz

恢复操作：在iStore设置界面选择"恢复配置"，上传备份文件即可。

常见问题如何诊断与解决？

安装失败排查流程

当应用安装失败时，建议按以下步骤排查：

1. 检查网络连通性：ping mirrors.openwrt.org
2. 确认存储空间：df -h
3. 手动安装依赖：opkg install <依赖包名>
4. 查看日志定位问题：logread | grep istore

界面异常处理方案

界面显示问题通常通过以下方法解决：

• 清除浏览器缓存（Ctrl+Shift+R）
• 更换Luci主题（系统 > 系统 > 语言和界面）
• 重启uhttpd服务：/etc/init.d/uhttpd restart

功能验证清单

安装配置完成后，请验证以下功能：

• [ ] 服务菜单中显示iStore图标
• [ ] 应用商店页面加载完整
• [ ] 应用搜索功能正常工作
• [ ] 应用安装/卸载流程顺畅
• [ ] 软件源更新功能可用
• [ ] 备份/恢复功能正常

资源导航

核心文件路径：

• 主配置文件：/etc/config/istore
• 初始化脚本：/etc/init.d/istore
• 控制器代码：luci/luci-app-store/luasrc/controller/store.lua
• 视图模板：luci/luci-app-store/luasrc/view/store/main.htm

项目仓库：git clone https://gitcode.com/gh_mirrors/is/istore