今天尝试在docker中运行ghost报错
"Unknown database error"Error ID:500Error Code: ECONNREFUSED----------------------------------------Error: connect ECONNREFUSED 127.0.0.1:3306at /var/lib/ghost/versions/5.112.0/node_modules/knex-migrator/lib/database.js:57:19at TCPConnectWrap.afterConnect [as oncomplete] (node:net:1555:16)[2025-03-13 19:14:18] WARN Ghost is shutting down
[2025-03-13 19:14:18] WARN Ghost has shut down
[2025-03-13 19:14:18] WARN Your site is now offline
[2025-03-13 19:14:18] WARN Ghost was running for a few seconds
问题背景
从 Ghost 5.0 开始,官方引入了一个 Breaking Change:默认不再支持 SQLite3(生产环境)和 MySQL 5,仅支持 MySQL 8。然而,SQLite3 仍然可以在开发环境中使用。
在 Ghost 5.9 版本的 Docker 镜像中,官方进一步将默认数据库改为了 MySQL 8。这导致从低版本升级到 5.9 或更高版本时,原有的 SQLite3 配置会失效,从而出现 ECONNREFUSED 127.0.0.1:3306
错误。
问题原因
- Ghost 5.0+ 的 Breaking Change:默认不再支持 SQLite3(生产环境)和 MySQL 5,仅支持 MySQL 8。
- Ghost 5.9+ 的 Docker 镜像变更:默认数据库配置改为 MySQL 8,导致升级后 SQLite3 配置失效。
- 错误表现:升级后,Ghost 尝试连接 MySQL 8,但由于未配置 MySQL,导致
ECONNREFUSED 127.0.0.1:3306
错误。
解决方案
根据官方提供的临时解决方案,可以通过设置环境变量来强制 Ghost 继续使用 SQLite3 数据库。具体步骤如下:
1. 添加环境变量
在运行 Ghost 容器时,添加以下两个环境变量:
database__client=sqlite3
:指定数据库客户端为 SQLite3。database__connection__filename=/var/lib/ghost/content/data/ghost.db
:指定 SQLite3 数据库文件的路径。
2. 运行容器的完整命令
docker run -d \--name ghost \--net=container:pause \--ipc=container:pause \--pid=container:pause \-e database__client=sqlite3 \-e database__connection__filename=/var/lib/ghost/content/data/ghost.db \ghost