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

[oksgo]

🏠 宝塔面板安装 Invision Community（IPS）完整教程​

适用版本：IPS 4.7.x / IPS 5.x | 环境：宝塔面板 | 更新：2026-04-26

---

📋 一、系统需求​

PHP 版本要求：

IPS 版本	最低 PHP	推荐 PHP	数据库
IPS 4.7.x	PHP 7.4	PHP 8.1	MySQL 5.7+ / MariaDB 10.3+
IPS 5.x	PHP 8.1	PHP 8.2 / 8.3	MySQL 8.0+ / MariaDB 10.6+

必须开启的 PHP 扩展：

• curl ✅
• gd ✅
• mbstring ✅
• xml / dom / simplexml ✅
• zip ✅
• fileinfo ✅
• intl ✅
• opcache ✅（性能优化）
• pdo_mysql ✅
• bcmath ✅
• openssl ✅

---

🔧 二、宝塔面板环境配置​

第一步：安装运行环境​

登录宝塔面板 → 软件商店 → 分别安装：

• Nginx 1.22+（推荐，不建议使用 Apache）
• MySQL 8.0（IPS 5.x 必须 8.0+；IPS 4.x 可用 5.7）
• PHP 8.2（推荐，兼容 IPS 4.x 和 5.x）

第二步：安装 PHP 扩展​

宝塔 → 软件商店 → PHP 8.2 → 点击设置 → 安装扩展

确保以下扩展已安装：

• fileinfo
• curl
• gd
• imagick（推荐）
• mbstring
• xml
• zip
• intl
• opcache
• bcmath

第三步：调整 PHP 配置​

宝塔 → PHP 8.2 → 设置 → 配置修改，修改以下参数后保存：

memory_limit = 256M
upload_max_filesize = 100M
post_max_size = 100M
max_execution_time = 120
max_input_vars = 10000

第四步：禁用危险函数（如已禁用请检查移除）​

宝塔 → PHP 8.2 → 设置 → 禁用函数

确认以下函数不在禁用列表中（IPS 安装需要用到）：

• proc_open
• popen
• exec

如果这些函数被禁用，将其从禁用列表中删除并保存。

---

🌐 三、创建网站与数据库​

第五步：添加站点​

宝塔 → 网站 → 添加站点

• 域名：你的域名，如 community.example.com
• PHP 版本：选 8.2
• 数据库：勾选"创建数据库"
  
  • 数据库名：ips
    
  • 用户名：ips
    
  • 密码：点击"随机"生成，记录下来备用
    

点击提交。

第六步：配置 MySQL 字符集（重要）​

宝塔 → 数据库 → 点击 phpMyAdmin 进入数据库管理 → 选择刚创建的 ips 数据库 → 点击顶部 Operations（操作）

将排序规则（Collation）改为：

utf8mb4_unicode_ci

点击"Go"保存。

第七步：配置 SSL 证书​

宝塔 → 网站 → 找到站点 → 设置 → SSL → 选 Let's Encrypt → 申请 → 开启强制 HTTPS

---

📁 四、上传 IPS 文件​

第八步：准备安装包​

从 IPS 客户区 下载完整安装包，文件名类似：

• IPS 4.x：ips_4.7.x.zip
• IPS 5.x：ips_5.x.x.zip

第九步：上传并解压​

宝塔 → 文件 → 进入网站根目录（如 /www/wwwroot/community.example.com/）

1. 点击右上角上传，上传 ips_x.x.x.zip
2. 上传完成后点击压缩包右侧解压
3. 解压后会出现一个文件夹（如 ips_x.x.x/）
4. 进入该文件夹，全选所有文件 → 剪切
5. 返回网站根目录 → 粘贴
6. 删除空文件夹和压缩包

根目录下应直接看到 index.php、install/、applications/ 等。

第十步：设置目录权限​

宝塔 → 文件 → 在网站根目录，对以下目录右键 → 权限 → 设为 755，勾选递归子目录：

• uploads/
• datastore/
• plugins/（如存在）

---

⚙️ 五、配置 Nginx 伪静态​

宝塔 → 网站 → 站点设置 → 伪静态 → 清空内容，粘贴以下规则，保存：

location / {
    try_files $uri $uri/ /index.php?$args;
}

location ~ /uploads/task_hooks {
    deny all;
}

location ~ /datastore {
    deny all;
}

location ~ /(interface|locale|skins|css_built_files|screenshots|themes|uploads)/ {
    try_files $uri $uri/ /index.php?$args;
}

---

🚀 六、运行 Web 安装程序​

浏览器访问：

https://你的域名/install/

安装步骤详解​

1. System Check（系统检测）
   安装程序自动检测环境，全部绿色 ✅ 才能继续。
   出现红色报错请参考下方常见问题。
2. License（授权码）
   输入你的 IPS 授权码（License Key）。
   可在 IPS 客户区 → 你的授权 → 复制 License Key。
3. Database Configuration（数据库配置）
   
   • Server：localhost
     
   • Port：3306
     
   • Username：ips（第五步创建的用户）
     
   • Password：第五步生成的密码
     
   • Database Name：ips
     
   • Table Prefix：ibf_（默认，可自定义）
     
   填写后点击 Next。
4. Admin Account（创建管理员账号）
   
   • Display Name：管理员用户名
     
   • Email：管理员邮箱
     
   • Password：强密码（12位以上）
     
5. Install（开始安装）
   程序自动创建数据库表，进度条走完即安装成功。
   此过程可能需要 1-3 分钟，不要关闭页面。
6. 安装完成
   点击 Go to Admin Panel 进入后台，或 Go to Community 进入前台。

---

✅ 七、安装完成后必做事项​

1. 删除安装目录（重要！）​

宝塔 → 文件 → 网站根目录 → 找到 install 文件夹 → 右键删除

⚠️ 必须删除！否则任何人可以重新安装覆盖你的社区数据。

2. 配置定时任务（Cron）​

IPS 的后台任务（邮件发送、缓存清理等）需要 Cron 支持。

宝塔 → 计划任务 → 添加任务：

• 任务类型：Shell 脚本
• 任务名称：IPS Cron
• 执行周期：每 1 分钟
• 脚本内容：

/www/server/php/82/bin/php -d memory_limit=256M /www/wwwroot/你的域名/applications/core/interface/task/web.php

PHP 路径根据宝塔实际安装版本确认，PHP 8.2 通常为 /www/server/php/82/bin/php

3. 后台基本设置​

登录后台（https://你的域名/admin/）完成以下配置：

• 邮件设置：后台 → System → Email Settings → 配置 SMTP（推荐）
  
  • SMTP Host：你的邮件服务商地址
    
  • Port：587（STARTTLS）或 465（SSL）
    
  • Username / Password：SMTP 账号密码
    
• 社区基本信息：后台 → System → Site Information → 填写社区名称、描述
• 注册设置：后台 → Members → Registration → 设置是否开放注册、验证方式
• 上传限制：后台 → System → Attachments → 根据需要调整上传大小上限

---

❓ 常见问题​

隐藏: 系统检测出现红色报错怎么办？

PHP 扩展未安装：
宝塔 → PHP 8.2 → 设置 → 安装扩展 → 安装对应扩展

目录不可写：
宝塔 → 文件 → 右键对应目录（uploads / datastore）→ 权限 → 改为 755

PHP 版本不符：
宝塔 → 软件商店 → 安装对应 PHP 版本 → 网站 → 站点设置 → 切换 PHP 版本

隐藏: 输入授权码提示"Invalid License"？

1. 确认授权码从 IPS 客户区复制，没有多余空格
2. 确认授权绑定的域名与当前安装域名一致（IPS 授权是绑定域名的）
3. 检查服务器能否访问外网（IPS 安装时需要联网验证授权）：

curl -I https://invisioncommunity.com

宝塔终端执行，返回 200 即正常。

隐藏: 安装完成后页面显示空白或 500 错误？

1. 宝塔 → 网站 → 找到站点 → 错误日志，查看具体报错信息
2. 检查 datastore/ 和 uploads/ 目录权限是否为 755
3. 确认 Nginx 伪静态规则已保存
4. 临时开启 IPS 调试模式（排查后关闭）：

编辑网站根目录下的 conf_global.php，追加：

define( 'IN_DEV', TRUE );

查看报错后删除此行。

隐藏: 页面 URL 含有 index.php 没有伪静态效果？

1. 确认 Nginx 伪静态规则已按照第五章保存
2. 后台 → System → Search Engine Optimization → Enable SEO Friendly URLs → 开启
3. 宝塔 → 重载 Nginx

隐藏: 上传头像/附件失败？

1. 检查 PHP 配置：upload_max_filesize 和 post_max_size 是否足够大
2. 检查 uploads/ 目录权限：宝塔 → 文件 → 右键 → 权限 755
3. 后台 → System → Attachments → 确认最大上传大小设置

隐藏: 安装 IPS 插件（应用）方法？

后台 → System → Applications（应用） → Install Application

选择插件的 .xml 或 .tar 文件上传安装。

安装完成后如需激活：Applications 列表 → 找到插件 → 点击 Enable

隐藏: IPS 如何升级？

推荐使用官方升级程序：

1. 先备份数据库和文件（宝塔 → 数据库 → 备份）
2. 从 IPS 客户区下载升级包（upgrade_x.x.x.zip）
3. 将升级包文件覆盖上传到网站根目录（不要删除现有文件，直接覆盖）
4. 访问 https://你的域名/install/ → 选择 Upgrade
5. 按提示完成升级，最后删除 install/ 目录

---

如有安装问题欢迎回帖，请附上报错截图或日志内容，说明 IPS 版本和服务器环境。