MacOS에서 Redis 클라이언트 실행, 종료, 원격 접속하기

참고 문서

• redis.io: Get Started

이 문서의 내용

Redis 클라이언트

Redis 클라이언트는 Redis 서버에 데이터 읽기/쓰기/삭제 등의 요청을 보낼 수 있는 CLI(Command Line Interface)입니다.

터미널에서 Redis 클라이언트를 실행하고, Redis 서버에 접속하고, 간단한 요청을 보낼 수 있습니다.

Redis 클라이언트 실행 및 로컬 서비스 접속

Redis 클라이언트를 실행하는 가장 기본적인명령문은 redis-cli입니다.

현재 PC에서 구동중인 Redis 서버에 접속하는 Redis 클라이언트를 실행합니다.

$ redis-cli

현재 PC에서 Redis 서버가 실행중이 아니라면 다음과 같은 오류를 출력합니다.

Could not connect to Redis at 127.0.0.1:6379: Connection refused
not connected>

Redis 클라이언트가 실행되면 이제부터 실행하는 명령문은 접속중인 Redis 호스트:포트>로 시작합니다.

$ 127.0.0.1:6379>

Redis 클라이언트 실행 및 원격 서비스 접속

접속하려는 Redis 서버가 로컬 서비스가 아닌 경우 다음 명령문으로 원격 접근이 가능합니다.

$ redis-cli -h [호스트] -p [포트]

Redis 서버는 설치 후 별다른 환경 설정을 지정하지 않으면 루프백 주소(127.0.0.1 ::1)를 제외한 모든 접속을 차단합니다.

원격 접속을 허용하려면 환경 설정 파일 /usr/local/etc/redis.conf를 다음과 같이 수정합니다.

# bind 127.0.0.1 ::1
bind * -::*

bind 환경 설정은 접속을 허용하는 화이트리스트(Whiltelist)에 대한 등록입니다.

Redis를 설치하면 default로 bind 127.0.0.1 ::1입니다. 모든 원격 접속을 허용하려면 이 값을 예시와 같이 수정합니다.

Redis 클라이언트 종료

클라이언트 CLI에서 Ctrl+C를 입력하여 프로세스를 종료합니다.

또는 클라이언트에서 exit 명령문을 입력합니다.

$ 127.0.0.1:6379> exit

Redis 서버에 요청 전송

Redis 클라이언트에서 명령문은 접속중인 Redis 호스트:포트>으로 시작하며 명령문을 실행하면 연결된 Redis 서버에 요청을 보냅니다.

$ 127.0.0.1:6379>

예를 들어 ping 요청을 보내면 서버는 PONG으로 응답합니다.

$ 127.0.0.1:6379> ping
PONG

서버에 요청 할 수 있는 전체 명령문은 redis.io: commands 문서를 참고합니다.