Tutorial|教程 Invision Community（IPS）插件 / 应用安装完整教程

[oksgo]

📦 Invision Community（IPS）插件 / 应用安装完整教程​

适用版本：IPS 4.7.x / IPS 5.x | 更新：2026-04-26

---

📋 前置说明​

IPS 的扩展内容分为以下几种类型，安装方式略有不同：

• Applications（应用） — 独立功能模块，如 Forums、Pages、Downloads、Gallery 等
• Plugins（插件） — 轻量级功能扩展，无独立数据库表
• Themes（主题） — 前台界面主题
• Languages（语言包） — 界面翻译

本教程重点讲解 Applications（应用） 和 Plugins（插件） 的安装。

---

✅ 一、安装 Application（应用）​

第一步：获取应用文件​

从 IPS 官方市场或第三方开发者处下载应用包，解压后通常包含：

• 应用名称.xml 或 应用名称.tar — 主安装文件（必须）
• upload/ 文件夹 — 附加资源文件（部分应用有，需额外上传）
• README.txt — 安装说明（务必先阅读）

⚠️ 注意区分：有些应用包需要先手动上传 upload/ 里的文件到服务器，再后台安装 XML。具体看应用的说明文档。

第二步（如有 upload 文件夹）：上传资源文件​

宝塔面板操作：

1. 宝塔 → 文件 → 进入网站根目录（如 /www/wwwroot/你的域名/）
2. 将 upload/ 文件夹内的所有内容上传并合并到网站根目录
3. 注意：是合并，不是覆盖整个目录

第三步：后台安装应用​

登录后台 https://你的域名/admin/

左侧菜单 → System → Applications

点击右上角 Install Application（安装应用）

1. 点击 Choose File，选择应用的 .xml 或 .tar 文件
2. 点击 Install
3. 等待安装完成（可能需要 10-60 秒）
4. 安装完成后，应用出现在列表中，状态为 Enabled（已启用）

第四步：确认应用已启用​

后台 → System → Applications → 确认新应用右侧开关为绿色（Enabled）

部分应用安装后还需要在 Options（设置） 中进行额外配置，注意查看应用文档。

---

✅ 二、安装 Plugin（插件）​

IPS 的 Plugin 比 Application 更轻量，通常只有一个 XML 文件，不需要上传额外资源。

第一步：获取插件文件​

解压下载包，找到 .xml 文件（通常命名为 plugin_xxx.xml 或 xxx.xml）。

第二步：后台安装插件​

后台 → System → Plugins

点击右上角 Install Plugin（安装插件）

1. 选择插件 .xml 文件
2. 点击 Install
3. 安装成功，插件出现在列表

---

🔄 三、更新 Application / Plugin​

更新 Application​

1. 如果新版本包含 upload/ 资源文件，先将其上传覆盖到网站根目录
2. 后台 → System → Applications → 找到对应应用
3. 点击应用右侧操作菜单（齿轮图标）→ Upgrade（升级）
4. 选择新版 XML 文件 → 点击 Upgrade 确认

更新 Plugin​

1. 后台 → System → Plugins → 找到对应插件
2. 点击右侧操作菜单 → Update
3. 选择新版 XML → 确认更新

---

🗑️ 四、卸载 Application / Plugin​

卸载 Application​

后台 → System → Applications → 找到应用 → 操作菜单 → Uninstall

⚠️ 卸载应用会删除该应用的所有数据库数据（帖子、附件、配置等），不可恢复！卸载前务必备份数据库。

卸载 Plugin​

后台 → System → Plugins → 找到插件 → 操作菜单 → Uninstall

Plugin 卸载相对安全，通常不会删除用户数据，但具体情况取决于插件设计。

---

🔧 五、安装后常用操作​

清除系统缓存​

安装/更新插件后，如果前台样式异常或功能未生效，清除缓存：

后台 → System → Support → Clear System Caches → 勾选全部 → Clear

或者通过 URL 直接访问：

https://你的域名/admin/?adsess=xxx&app=core&module=support&controller=support&do=clearCaches

配置应用权限​

后台 → Members → Groups → 找到用户组 → 编辑 → 找到新应用对应的权限分组 → 按需开启/关闭权限

查看应用设置​

后台 → System → Settings（或 Applications 对应应用的设置入口）

部分应用在后台左侧菜单会新增独立的菜单项，直接点击进入配置。

---

❓ 常见问题​

隐藏: 安装时提示"The file you have uploaded is not valid"？

1. 确认上传的是正确的 .xml 或 .tar 文件，不是整个压缩包
2. 用记事本打开 XML 确认第一行是 <?xml version="1.0"
3. 确认文件未损坏，重新下载后再试
4. 检查应用是否与当前 IPS 版本兼容（IPS 4.x 应用不能直接装在 IPS 5.x 上）

隐藏: 安装后应用没有出现在前台菜单？

1. 后台 → System → Applications → 确认应用状态为 Enabled（已启用）
2. 后台 → System → Navigation → 确认应用对应的导航项已开启且顺序正确
3. 清除系统缓存（见上方"清除系统缓存"操作）
4. 检查用户组权限：后台 → Members → Groups → 对应用户组 → 确认有访问权限

隐藏: 安装后前台报 500 错误或白屏？

1. 宝塔 → 网站 → 错误日志，查看 PHP 错误信息
2. 后台 → System → Support → Error Logs，查看 IPS 内部错误
3. 临时禁用刚安装的应用排查：后台 → System → Applications → 将新应用 Disable
4. 如后台也无法访问，通过 FTP/宝塔文件管理，在网站根目录创建 conf_global.php 中追加：

define( 'RECOVERY_MODE', TRUE );

使用恢复模式登录后台禁用有问题的应用，然后删除此行。

隐藏: 应用已安装但设置页面找不到？

• 部分应用的设置在后台左侧菜单会新增独立入口，检查左侧导航是否有新菜单
• 也可能在：后台 → System → Settings → 找到对应应用的设置选项卡
• 若为第三方应用，参考开发者提供的文档说明

隐藏: 上传 XML 文件提示大小超出限制？

宝塔 → PHP 8.2 → 设置 → 配置修改，调整：

upload_max_filesize = 100M
post_max_size = 100M

保存后重启 PHP-FPM，重新上传。

隐藏: 如何批量安装多个应用？

IPS 不支持一次性批量安装，需逐个安装。建议安装顺序：

1. 先安装基础/依赖应用（如某些应用依赖 Commerce 或 Pages）
2. 再安装功能性应用
3. 最后安装主题和语言包

每安装一个后，清除一次缓存，确认正常再装下一个。

---

如有安装问题欢迎回帖，请附上报错截图或 Error Log 内容，并说明 IPS 版本和应用名称。

 

Tutorial|教程  宝塔面板安装 Invision Community（IPS）完整教程