Lỗi Error Establishing a Database Connection
Nếu bạn thấy lỗi “Error establishing a database connection” trên giao diện HiTechAdmin, điều đó cho biết kết nối cơ sở dữ liệu đã thất bại.
Dịch vụ MySQL
HiTechCloud và HiTechAdmin dùng một dịch vụ Docker MySQL khai báo trong /root/docker-compose.yml.
Trước tiên, đảm bảo dịch vụ đang chạy:
Từ HiTechAdmin:
- Vào Dịch vụ > Trạng thái dịch vụ.
- Kiểm tra trạng thái của dịch vụ MySQL.
- Khởi động lại từ trang này nếu cần.
Từ terminal:
docker ps -a
Tìm dịch vụ hitechcloud_mysql trong kết quả.
MySQL không khởi động được
Nếu dịch vụ MySQL không khởi động được, Docker sẽ liên tục khởi động lại nó. Bạn có thể thấy điều này trong kết quả của docker ps -a.
Ví dụ:
root@hitechcloud:~# docker ps -a
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
6d9885164cba mysql/mysql-server "/entrypoint.sh mysql…" 30 minutes ago Restarting (1) 22 seconds ago hitechcloud_mysql
- Nếu thời gian chạy chỉ vài giây và trạng thái hiển thị not running hoặc unhealthy, hãy xem nhật ký dịch vụ:
docker logs -f hitechcloud_mysql
Ví dụ:
root@hitechcloud:~# docker logs -f hitechcloud_mysql
[Entrypoint] MySQL Docker Image 8.0.32-1.2.11-server
[Entrypoint] Starting MySQL 8.0.32-1.2.11-server
2025-10-17T15:36:55.291441Z 0 [Warning] [MY-011068] [Server] The syntax '--skip-host-cache' is deprecated and will be removed in a future release. Please use SET GLOBAL host_cache_size=0 instead.
2025-10-17T15:36:55.293565Z 0 [System] [MY-010116] [Server] /usr/sbin/mysqld (mysqld 8.0.32) starting as process 1
2025-10-17T15:36:55.304336Z 1 [System] [MY-013576] [InnoDB] InnoDB initialization has started.
2025-10-17T15:36:55.546466Z 1 [System] [MY-013577] [InnoDB] InnoDB initialization has ended.
2025-10-17T15:36:55.852133Z 0 [Warning] [MY-010068] [Server] CA certificate ca.pem is self signed.
2025-10-17T15:36:55.852166Z 0 [System] [MY-013602] [Server] Channel mysql_main configured to support TLS. Encrypted connections are now supported for this channel.
2025-10-17T15:36:55.852534Z 0 [ERROR] [MY-010259] [Server] Another process with pid 60 is using unix socket file.
2025-10-17T15:36:55.852547Z 0 [ERROR] [MY-010268] [Server] Unable to setup unix socket lock file.
2025-10-17T15:36:55.852555Z 0 [ERROR] [MY-010119] [Server] Aborting
2025-10-17T15:36:57.431776Z 0 [System] [MY-010910] [Server] /usr/sbin/mysqld: Shutdown complete (mysqld 8.0.32) MySQL Community Server - GPL.
Trong ví dụ này, lỗi là: Another process with pid 60 is using unix socket file.
Tìm lỗi này trên Google, ta có cách khắc phục: cd /root && docker compose down --volumes LƯU Ý: lệnh này sẽ xoá toàn bộ dữ liệu mysql hiện có, gồm người dùng, gói, tên miền.. chỉ chạy trên bản cài mới, tức là khi lỗi mysql này xảy ra ngay sau khi cài hitechcloud.
-
Sao chép mọi thông báo lỗi và tìm kiếm trên mạng. Các sự cố thường gặp gồm:
- Sự cố với tag mới nhất của docker image mysql
- MySQL không chạy đúng trên CPU ARM
Lệnh mysql không hoạt động
Bạn có thể kiểm tra kết nối trực tiếp từ terminal bằng lệnh mysql.
Ví dụ lỗi:
root@hitechcloud:~# mysql
ERROR 2026 (HY000): TLS/SSL error: SSL is required, but the server does not support it
Để xử lý lỗi TLS/SSL error: SSL is required, but the server does not support it, chạy: echo "skip-ssl = true" >> /etc/my.cnf NGUỒN
Ví dụ lỗi:
root@hitechcloud:~# mysql
ERROR 2003 (HY000): Can't connect to MySQL server on '127.0.0.1:3306' (111)
Nếu đây là bản cài mới và chưa có người dùng hay gói nào, MySQL có thể đã khởi tạo thất bại trong quá trình cài đặt. Để khắc phục:
cd /root
docker compose down
docker volume rm root_mysql # DANGER: this will delete all users and plans, only run it on a fresh install!
docker compose up -d hitechcloud_mysql hitechcloud
Nếu không, hãy kiểm tra thông tin đăng nhập lưu trong /etc/my.cnf có đúng không:
root@demo:~# cat /etc/my.cnf
[client]
user = panel
database = panel
password = e391ac94321d110c
host = 127.0.0.1
protocol = tcp
Tường lửa
Kết nối đi trên cổng 3306 phải được cho phép. Đảm bảo cổng này được mở trong Sentinel Firewall (CSF).
Kiểm tra thiết lập TCP_OUT= trong /etc/csf/csf.conf và xác nhận cổng 3306 có trong đó. Nếu không, hãy thêm vào và khởi động lại CSF:
csf -r
Nếu không bước nào giải quyết được sự cố, hãy liên hệ chúng tôi qua diễn đàn hoặc mở ticket hỗ trợ, và chúng tôi sẽ giúp xử lý.