PostgreSQL
일식일식 ·
🛠️ Windows PostgreSQL 설치 단계
1단계: 공식 인스톨러 다운로드
PostgreSQL 공식 다운로드 페이지에 접속합니다.
상단의 "Download the installer" 링크를 클릭합니다.
다양한 버전 목록이 나오는데, 특별한 이유가 없다면 가장 최신 안정 버전을 선택하고 Windows x86-64 항목의 다운로드 버튼을 누릅니다.
2단계: 설치 프로세스 진행 (중요 설정 포인트)
다운로드된 .exe 파일을 실행하면 설치 마법사가 시작됩니다. 대부분 Next를 누르면 되지만, 아래 단계들은 주의해서 설정해야 합니다.
Select Components (구성 요소 선택):
PostgreSQL Server (필수)
pgAdmin 4 (GUI로 DB를 관리할 수 있는 아주 유용한 툴입니다. 체크 권장)
Stack Builder (추가 드라이버 설치 툴인데, 당장 필요 없으므로 체크 해제하셔도 무방합니다.)
Command Line Tools (터미널 제어용 필수)
Password (비밀번호 설정): ⭐ 매우 중요
PostgreSQL의 최고 관리자 계정인 postgres의 비밀번호를 설정하는 창입니다.
외부 서버인 만큼 복잡하고 안전한 비밀번호를 입력하고, 반드시 메모해 두세요. 나중에 에이전트나 백엔드가 접속할 때 이 비밀번호가 필요합니다.
Port (포트 설정):
기본값인 5432가 지정되어 있습니다. 그대로 두고 Next를 누릅니다. (나중에 방화벽에서 이 5432 포트를 신경 써야 합니다.)
이후에는 계속 Next를 눌러 설치를 완료합니다.
🔐 3단계: 외부 접속을 위한 방화벽 세팅 (핵심)
현재 도서관 사태(?)를 겪으신 것처럼, 외부 컴퓨터에서 이 PostgreSQL에 접속하거나 안티그래비티 에이전트가 원격으로 테이블을 만들게 하려면 Windows 방화벽에서 5432 포트를 열어주어야 합니다.
Windows 시작 메뉴에서 "고급 보안이 포함된 Windows 방화벽"을 검색하여 실행합니다.
왼쪽 메뉴에서 [인바운드 규칙]을 클릭한 뒤, 오른쪽의 [새 규칙...]을 누릅니다.
규칙 종류: [포트] 선택 ➡️ 다음
[TCP] 선택 및 특정 로컬 포트에 5432 입력 ➡️ 다음
[연결 허용] 선택 ➡️ 다음 ➡️ 규칙 이름(예: PostgreSQL_5432)을 입력하고 마칩니다.
⚙️ 4단계: 외부 접속 허용 설정 파일 수정 (설치 후 필수 작업)
PostgreSQL은 기본적으로 '보안'을 위해 설치된 그 컴퓨터 내부(localhost)에서의 접속만 허용하도록 잠겨 있습니다. 외부 백엔드나 에이전트가 통신할 수 있게 설정 파일 2개를 살짝 고쳐주어야 합니다.
Windows 탐색기를 열고 PostgreSQL이 설치된 경로(기본값: C:\Program Files\PostgreSQL\[버전]\data)로 이동합니다.
① postgresql.conf 파일 수정
postgresql.conf 파일을 메모장(관리자 권한)으로 엽니다.
#listen_addresses = 'localhost' 라고 되어 있는 부분을 찾아 주석(#)을 지우고 다음과 같이 변경합니다.
Plaintext
listen_addresses = '*'
(모든 IP 주소로부터의 연결 요청을 듣겠다는 뜻입니다.)
② pg_hba.conf 파일 수정
같은 폴더에 있는 pg_hba.conf 파일을 메모장으로 엽니다.
파일 맨 아래로 내려가서 다음 한 줄을 추가해 줍니다.
Plaintext
host all all 0.0.0.0/0 scram-sha-256
(어떤 IP에서 오든 비밀번호 인증을 거치면 접속을 허용하겠다는 규칙입니다.)
3. 파일을 저장합니다.
🔄 5단계: PostgreSQL 서비스 재시작
설정 파일을 바꿨으니 DB 서비스를 껐다 켜야 적용됩니다.
Ctrl + Shift + Esc를 눌러 작업 관리자를 켜고 [서비스] 탭으로 이동합니다.
이름 중 postgresql...을 찾아서 마우스 우클릭 후 [재시작]을 누릅니다.
이제 설치와 외부 연결을 위한 기초 공사가 끝났습니다! pgAdmin 4를 켜서 처음에 설정한 비밀번호로 로그인이 잘 되는지 확인해 보시면 됩니다. 부딪히는 부분이나 막히는 단계가 있다면 언제든 말씀해 주세요.