Redis 安装 + 配置 + FastAdmin 调试 · 完整教程文案

适用环境：

• 1Panel 面板
• Docker 容器
• PHP 7.x
• FastAdmin / ThinkPHP
• Redis 作为缓存 + Session

🟦 第 1 部分：Redis 安装（1Panel）

① 打开 1Panel → 应用商店

搜索：Redis

② 点击安装

保持默认配置即可。

③ 查看 Redis 容器名称

安装完成后 → 容器列表
例如：

1Panel-redis-AIf3

后续 FastAdmin 配置会用到这个名称。

④ 查看 Redis 密码

进入 Redis 容器 → 环境变量
例如：

redis_*****

🟩 第 2 部分：PHP 安装 Redis 扩展

1. 打开 1Panel → 已安装 → PHP 7.x
2. 进入 扩展管理
3. 安装扩展：redis
4. 重启 PHP 服务

🟧 第 3 部分：Redis 终端登录（调试必备）

登录 Redis（推荐方式）

redis-cli
auth redis_****

登录指定 DB

select 1

查看所有 key

keys *

🟨 第 4 部分：FastAdmin 配置 Redis（缓存 + Session）

FastAdmin 配置文件路径：

application/config.php

🟩 缓存配置（cache）

示例（使用 Redis 容器名称）：

'cache' => [
    'type'   => 'redis',
    'host'   => '1Panel-redis-AIf3',
    'port'   => 6379,
    'password' => 'redis_****',
    'select' => 0,
    'prefix' => 'fastadmin_cache_',
    'expire' => 0,
],

说明：

• select = Redis DB
• prefix = 缓存前缀（必须独立）

🟦 Session 配置（session）

'session' => [
    'id'             => '',
    'var_session_id' => '',
    'prefix'         => 'fastadmin_sess_',
    'type'           => 'redis',
    'auto_start'     => true,
    'host'           => '1Panel-redis-AIf3',
    'port'           => 6379,
    'password'       => 'redis_****',
    'select'         => 1,
],

说明：

• Session 必须使用独立 DB（避免清缓存导致掉线）
• prefix 必须与 cache 不同

🟧 第 5 部分：多站点 Redis 配置（3 站点示例）

每个站点都必须：

• 独立 DB
• 独立 prefix
• 独立 Session

避免互相覆盖、互相掉线。

🟨 第 6 部分：FastAdmin 调试步骤

① 清理缓存

php think clear

或后台 → 系统管理 → 清除缓存

② 重启 PHP 容器

使 Redis Session 生效。

③ 验证 Redis 是否写入 Session

redis-cli
auth redis_***
select 1
keys *

如果看到随机 key，说明 Session 已成功写入 Redis。

④ 验证 Session 是否稳定

重启 PHP 容器 → 刷新后台，如果仍然保持登录 → Session 配置成功。

🟦 第 7 部分：常见问题排查

❌ 后台登录后跳回登录页

原因：Session DB 与 Cache DB 混用，解决：Session 使用独立 DB

❌ 清缓存导致后台掉线

原因：prefix 相同，解决：cache prefix ≠ session prefix

❌ Redis 无法连接

检查：

• 容器名称是否正确
• 密码是否正确
• PHP redis 扩展是否安装

🎉 最终效果

• FastAdmin 全站加速
• Session 稳定不掉线
• 多站点互不干扰
• Redis 性能最佳
• 配置清晰、可维护