### [解决1Panel 部署WordPress启动Redis Object Cache插件报错](https://www.huiui.net/article/103)

**Published:** 2026-08-24T02:59:26

**Author:** 小新.

**Excerpt:** 解决1Panel部署WordPress启动Redis Object Cache插件报错

## **前言**

在使用 1Panel Docker 容器环境下部署 WordPress 并启用 Redis Object Cache 时，常见报错如下：

```javascript
Connection refused [tcp://127.0.0.1:6379]
```

这是因为 Docker 容器的网络隔离机制导致的。每个容器都有独立的 IP 地址，因此容器内的 `127.0.0.1` 或 `localhost` 仅指向自身，无法直接访问其他容器中的服务（如 MySQL、Redis、Memcached 等）。

## **解决方案**

### **1\. 配置 WordPress 连接 Redis**

编辑 WordPress 根目录下的 `wp-config.php` 文件，添加以下 Redis 配置：

```php
/** Redis Object Cache */
define('WP_REDIS_HOST', 'redis');       // Redis 容器名称或服务名
define('WP_REDIS_PORT', 6379);          // Redis 默认端口
define('WP_REDIS_DATABASE', 0);         // Redis 数据库索引
define('WP_REDIS_PASSWORD', '你的Redis密码'); // Redis 密码
```

注意：`redis` 是 Redis 容器在 Docker 网络中的名称（通常在 Docker Compose 文件中定义）。

### **2\. 修复 Object Cache 插件的连接问题**

如果启用 Redis Object Cache 后仍提示 `Connection refused`，需要修改插件内部连接参数：

1.  找到 WordPress 插件目录下的 `object-cache.php` 文件，例如： `/opt/1panel/apps/wordpress/wordpress/data/wp-content/object-cache.php`
    
2.  在约 **第 620 行**，找到 `build_parameters()` 方法，替换为：
    
    ```php
    protected function build_parameters()
    {
        $parameters = [
            'scheme'   => 'tcp',
            'host'     => 'redis', // Redis 容器名称
            'port'     => 6379,    // Redis 端口
            'password' => '你的Redis密码', // Redis 密码
        ];
    
        return $parameters;
    }
    ```
    

保存文件后，刷新 WordPress 后台，Redis Object Cache 应可正常连接。

### **3\. 注意事项**

-   确保 Redis 容器已经启动，并且端口对 WordPress 容器开放。
    
-   如果使用 Docker Compose，可以通过容器名称互相访问，而无需使用 `127.0.0.1`。
    
-   Redis 密码配置必须与 Redis 实际设置一致，否则连接会被拒绝。
    

通过以上步骤，即可解决 WordPress 在 Docker 容器中启用 Redis Object Cache 时的“Connection refused”问题，同时保证缓存功能正常运行。

**Tags:** 1panel, docker, redis, Wordpress, 报错, 插件

**Categories:** 建站教程

**Comments:** 

**DoKi.:** 文章写得很好，让我学会了如何配置Redis Object Cache。

**哆啦A梦的时光机:** 解决了我的大问题，谢谢作者。



---