进阶 hestiacp.com 2026-11-15 08:32:00 · 7 阅读

第9章 数据库与 phpMyAdmin 单点登录配置

第9章:Database & phpMyAdmin SSO

如何配置远程数据库服务器

假设您的第二台服务器已就绪并正在运行。在您的 Hestia 服务器上执行以下命令(mysql 可替换为 postgresql):

bash v-add-database-host mysql new-server.com root password

若要确认主机已添加,请执行以下命令:

bash v-list-database-hosts

为什么我不能使用 http://ip/phpmyadmin/

出于安全考虑,我们已禁用此选项。请改用 https://host.domain.tld/phpmyadmin/。

如何创建 PhpMyAdmin 根用户凭据

将 myrootusername 和 myrootusername_password 替换为您期望的凭据:

bash mysql -urootsql CREATE USER 'myrootusername'@'localhost' IDENTIFIED BY 'myrootusername_password'; GRANT ALL PRIVILEGES ON *.* TO 'myrootusername'@'localhost' WITH GRANT OPTION; FLUSH PRIVILEGES; QUIT;

如何启用对 http://ip/phpmyadmin/ 的访问

对于 Apache2:

bash nano /etc/apache2/conf.d/ip.conf # 在两个 结束标签之前添加以下代码 IncludeOptional /etc/apache2/conf.d/*.inc # 重启 apache2 systemctl restart apache2 # 也可以将以下内容添加到 /etc/apache2.conf 中 IncludeOptional /etc/apache2/conf.d/*.inc

对于 Nginx:

bash nano /etc/nginx/conf.d/ip.conf # 替换以下内容 location /phpmyadmin/ { alias /var/www/document_errors/; return 404; } location /phppgadmin/ { alias /var/www/document_errors/; return 404; } # 替换为以下内容 include /etc/nginx/conf.d/phpmyadmin.inc*; include /etc/nginx/conf.d/phppgadmin.inc*;

注意:如果应用上述修复后 /phpmyadmin/ 显示“Page Not Found”(404)

如果访问 http://ip/phpmyadmin/(不带 index.php)返回 404,请在 phpmyadmin 包含文件中添加一个 index 指令:

bash nano /etc/nginx/conf.d/phpmyadmin.inc

在 location /phpmyadmin { ... } 块中的 alias 行之后添加 index index.php;:

nginx location /phpmyadmin { alias /usr/share/phpmyadmin/; index index.php; ... }

然后测试并重载:

bash nginx -t && systemctl reload nginx

如何从远程位置连接到数据库

默认情况下,防火墙禁用了到 3306 端口的连接。请在防火墙中打开 3306 端口(参见文档),然后编辑 /etc/mysql/mariadb.conf.d/50-server.cnf:

bash nano /etc/mysql/mariadb.conf.d/50-server.cnf # 将 bind-address 设置为以下之一 bind-address = 0.0.0.0 bind-address = "your.server.ip.address"

PhpMyAdmin 单点登录(SSO)

注意:PhpMyAdmin 单点登录仅针对单个数据库启用。现有的主要“PhpMyAdmin”按钮仅用于现有数据库凭据。

无法激活 phpMyAdmin 单点登录

确保 API 已启用且工作正常。Hestia 的 PhpMyAdmin 单点登录功能通过 Hestia API 进行连接。

点击 phpMyAdmin 单点登录按钮时,我被重定向到 phpMyAdmin 登录页面

自动化过程有时会导致问题。通过 SSH 登录并打开 /var/log/{webserver}/domains/{hostname.domain.tld.error.log,查找以下任一错误消息:

  • 无法通过 API 连接,请检查 API 连接
    检查 API 是否已启用。
    将服务器的公网 IP 添加到服务器设置中的允许 IP 列表中。

  • 访问被拒绝:安全令牌不匹配
    先禁用再启用 phpMyAdmin SSO。这将刷新两个密钥。
    如果您位于防火墙或代理之后,可能需要禁用它并重试。

  • 链接已过期
    刷新数据库页面并重试。

远程数据库

如有需要,您可以简单地在远程服务器上托管 Mysql 或 Postgresql。

添加远程数据库:

bash v-add-database-host TYPE HOST DBUSER DBPASS [MAX_DB] [CHARSETS] [TPL] [PORT]

例如:

bash v-add-database-host mysql db.hestiacp.com root mypassword 500

您也可以在主机服务器上设置 phpMyAdmin 以允许连接数据库。在 /etc/phpmyadmin/conf.d 中创建 01-localhost 文件的副本并修改:

php $cfg["Servers"][$i]["host"] = "localhost"; $cfg["Servers"][$i]["port"] = "3306"; $cfg["Servers"][$i]["pmadb"] = "phpmyadmin"; $cfg["Servers"][$i]["controluser"] = "pma"; $cfg["Servers"][$i]["controlpass"] = "random password"; $cfg["Servers"][$i]["bookmarktable"] = "pma__bookmark";

请务必创建 phpmyadmin 用户和数据库。
参见 /usr/local/hestia/install/deb/phpmyadmin/pma.sh

评论 (0)