---
title: "Kết nối PostgreSQL"
description: "Lấy đúng host, port, database, role và chế độ SSL cho ứng dụng hoặc psql."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.pgnext.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Kết nối PostgreSQL

Trước khi kết nối, compute phải sẵn sàng và bạn phải có quyền xem thông tin kết nối của nó. Mật khẩu PostgreSQL khác mật khẩu đăng nhập PG Next.

## Lấy thông tin trong console

1. Mở dự án và chọn **Kết nối** (Connect).
2. Chọn đúng nhánh, compute, database và role.
3. Chọn kết nối bên ngoài cho máy cá nhân/ứng dụng ngoài cluster. Địa chỉ nội bộ Kubernetes chỉ dùng từ mạng phù hợp.
4. Kiểm tra host, port và chế độ SSL do console trả về. Dùng các giá trị của chính compute; không tự ghép host từ tên dự án.
5. Sao chép chuỗi kết nối. Nếu nút ghi **Sao chép mẫu**, chuỗi chưa chứa mật khẩu thật; cần bổ sung mật khẩu riêng trước khi sử dụng.

Chuỗi có mật khẩu là bí mật. Không gửi qua chat, commit vào Git hoặc đưa vào biến frontend `VITE_*`.

## Dùng psql mà không ghi mật khẩu vào lệnh

Thay các trường minh họa bên dưới bằng giá trị từ console. Đây không phải một endpoint thật:

```sh
psql "host=HOST_TU_CONSOLE port=PORT_TU_CONSOLE dbname=DATABASE_TU_CONSOLE user=ROLE_TU_CONSOLE sslmode=SSL_MODE_TU_CONSOLE" -W
```

Nhập mật khẩu ở lời nhắc. Không mặc định mọi endpoint hỗ trợ cùng một chế độ TLS; không hạ chế độ SSL chỉ để bỏ lỗi chứng thư. Nếu yêu cầu bảo mật của ứng dụng cao hơn endpoint đang cung cấp, dừng và xác minh cấu hình với đơn vị vận hành.

```sql
SELECT current_database(), current_user;
```

Hai giá trị phải khớp lựa chọn trong console. Với ứng dụng, đặt chuỗi kết nối ở secret phía server theo cơ chế của framework, tránh hiển thị trong log và thông báo lỗi.

## Khi kết nối thất bại

| Triệu chứng | Kiểm tra |
| --- | --- |
| Timeout hoặc connection refused | Compute đang chạy chưa, host/port có đúng loại kết nối và mạng có tới endpoint không? |
| Password authentication failed | Có đúng role và mật khẩu PostgreSQL hiện tại không? Mẫu kết nối đã được điền mật khẩu chưa? |
| Database does not exist | Database trong chuỗi có đúng database hiện có trong compute không? |
| Lỗi SSL/chứng thư | Đối chiếu chế độ SSL và chứng thư endpoint; không bỏ qua xác minh để thử nhanh. |

Cú pháp tham số theo [tài liệu libpq PostgreSQL](https://www.postgresql.org/docs/17/libpq-connect.html). Khả năng TLS thực tế của PG Next phụ thuộc endpoint đang dùng.

Source: https://docs.pgnext.dev/vi/huong-dan/ket-noi/index.mdx