Redis 연결 문자열 빌더
Redis 또는 Valkey 연결 URI, StackExchange.Redis 구성 문자열, redis-cli 명령을 하나의 양식에서 만들거나, 하나를 붙여넣어 각 옵션이 무엇을 하는지, 비밀번호가 네트워크를 평문으로 지나가는지 확인할 수 있습니다. 모든 처리는 브라우저에서 이뤄집니다: 입력한 내용은 어디로도 전송되지 않습니다.
이 연결을 SQLly에서 열기
설계 단계부터 프라이버시를 지킵니다. 빌더와 디코더는 이 탭에서 돌아가는 순수 JavaScript입니다. 입력한 내용으로 요청을 하나도 보내지 않고, 아무것도 저장하지 않으며(브라우저에도 저장하지 않음), 한 번 로드되면 오프라인에서도 계속 작동합니다. SQLly에서 열기 링크는 브라우저에서 컴퓨터의 앱으로 바로 이어집니다.
Redis 연결 문자열 형식
거의 모든 Redis 클라이언트는 URI를 받습니다: redis://[[user]:password@]host[:port][/db], 또는 rediss:// TLS용입니다. .NET 클라이언트인 StackExchange.Redis만 예외인데, 다음과 같은 쉼표 구분 설정 문자열을 씁니다 host:6380,password=...,ssl=true.
redis:// 은(는) 평문이고 AUTH 비밀번호도 그대로 들어갑니다. 관리형 서비스(Azure Cache for Redis, 전송 중 암호화를 쓰는 ElastiCache, Upstash)는 다음을 요구합니다 rediss://.
TLS가 포함된 URI redis-py, node-redis, ioredis, go-redis, Lettuce, Jedis, SQLly
rediss://:[email protected]/0
ACL 사용자(Redis 6+)를 사용하는 URI 동일
rediss://app_user:[email protected]:6380/0
StackExchange.Redis .NET
cache.example.com:6380,password=your_password,ssl=true,abortConnect=false
redis-cli 명령줄
redis-cli -h cache.example.com -p 6380 --tls --askpass
다음과 같은 플레이스홀더 your_password 말 그대로 그 이상도 이하도 아닙니다. 위 양식으로 연결 문자열을 직접 만드세요. SQLly를 Redis에 연결하는 방법 더 알아보기: Redis용 SQLly.
Redis URI 구성 요소
redis 그리고 rediss 임시 IANA URI 스킴입니다. 사용자와 비밀번호의 특수 문자는 퍼센트 인코딩하세요. 사용자가 없는 비밀번호 (redis://:pw@host) 다음 사용자로 로그인합니다 default 사용자.
| 키워드 | 동의어 | 기본값 | 기능 |
|---|---|---|---|
scheme |
- | 레디스 | redis:// 일반 TCP, rediss:// TLS. Valkey 클라이언트도 같은 것을 받아들이고, 일부는 다음도 받습니다 valkey://. |
user |
- | default | ACL 사용자 이름(Redis 6 이상). |
password |
- | - | AUTH 비밀번호. |
host:port |
- | localhost:6379 | 서버 주소. |
/db |
?db= | 0 | 데이터베이스 인덱스, 기본 범위는 0~15입니다. |
StackExchange.Redis 구성 옵션
형식: host:port[,host2:port2],option=value,.... 옵션 이름은 대소문자를 구분하지 않습니다. 쉼표가 들어간 비밀번호는 문자열에 직접 쓸 수 없으므로 다음으로 ConfigurationOptions.Password 코드에서.
| 키워드 | 동의어 | 기본값 | 기능 |
|---|---|---|---|
password |
- | - | AUTH 비밀번호. |
user |
- | - | ACL 사용자 이름. |
ssl |
- | 거짓 | TLS를 사용하세요. 다음을 지정하면 ssl=true 포트가 없으면 기본 포트는 6380입니다. |
sslHost |
- | - | 인증서가 일치해야 하는 호스트 이름. |
abortConnect |
- | true (Azure Cache for Redis의 경우 false) | false Connect에서 예외를 던지는 대신 백그라운드에서 재시도를 계속합니다. |
connectTimeout |
- | 5000 | 밀리초. |
syncTimeout |
- | 5000 | 동기 작업 시간(밀리초). |
asyncTimeout |
- | syncTimeout | 비동기 작업 시간(밀리초). |
connectRetry |
- | 3 | 연결 시도. |
defaultDatabase |
- | - | 데이터베이스 인덱스. |
name |
- | - | 클라이언트 이름 (CLIENT SETNAME). |
allowAdmin |
- | 거짓 | FLUSHALL, CONFIG 등 관리 명령 허용. |
keepAlive |
- | -1 (60초) | keepalive 핑 간격(초). |
serviceName |
- | - | Sentinel 마스터 이름. |
redis-cli 연결 플래그
redis-cli도 허용합니다 -u redis://....
| 키워드 | 동의어 | 기본값 | 기능 |
|---|---|---|---|
-h |
- | 127.0.0.1 | 호스트. |
-p |
- | 6379 | 포트. |
--user |
- | - | ACL 사용자(비밀번호 포함). |
-a / --pass |
- | - | 명령줄의 비밀번호는 셸 히스토리와 프로세스 목록에 그대로 노출됩니다. 가급적이면 --askpass 또는 REDISCLI_AUTH 환경 변수. |
-n |
- | 0 | 데이터베이스 인덱스. |
--tls |
- | - | TLS를 사용하고, 다음을 추가하세요 --cacert 사설 CA용입니다. |
일반적인 Redis 연결 오류
NOAUTH Authentication required.
이유: 서버에는 비밀번호(requirepass 또는 ACL 사용자)가 있으며, 클라이언트가 인증하지 않고 명령을 보냈습니다. 이는 일반적으로 URI에 비밀번호가 없기 때문입니다.
해결: 비밀번호를 추가하세요: redis://:password@host:6379, 또는 redis://user:password@host ACL 사용자를 위해.
WRONGPASS invalid username-password pair or user is disabled.
이유: Redis 6+에서 자격 증명이 거부되었습니다. 종종 비밀번호가 사용자 이름으로 제공된 경우입니다: 일부 클라이언트는 redis://secret@host 사용자로서 secret 비밀번호 없이.
해결: 작성 redis://:secret@host (콜론에 주의) 또는 사용자 이름과 비밀번호를 모두 입력하십시오.
It was not possible to connect to the redis server(s).
이유: StackExchange.Redis가 연결하지 못했습니다: 호스트나 포트가 틀렸거나, TLS가 필요한데 ssl=true 누락(또는 그 반대)이거나 방화벽일 수 있습니다. 다음과 같이 abortConnect=true (기본값)인 경우 즉시 예외를 발생시킵니다.
해결: 확인 ssl 그리고 포트(TLS 엔드포인트는 보통 6380)를 점검하고, 설정할 값은 abortConnect=false 그래서 멀티플렉서가 계속 재시도합니다.
DENIED Redis is running in protected mode because protected mode is enabled
이유: 비밀번호도 없고 명시적인 bind 주소도 없는 Redis는 다른 컴퓨터에서 오는 연결을 거부합니다.
해결: 서버에서 비밀번호(또는 ACL 사용자)와 bind 보호 모드를 끄는 대신 서버에 주소를 설정하세요.
Redis 연결 문자열 FAQ
Redis 연결 문자열 형식은 무엇인가요?
redis://[[user]:password@]host[:port][/db], 또는 rediss:// TLS용입니다. 예를 들어 rediss://:[email protected]:6380/0. StackExchange.Redis는 다음을 사용합니다 host:port,password=...,ssl=true 를 대신 사용합니다.
기본 Redis 포트는 무엇인가요?
6379입니다. 많은 관리형 서비스는 6380에서 TLS를 제공하며, StackExchange.Redis는 ssl=true 그리고 포트를 지정하지 않으면 6380으로 가정합니다.
Redis URI에는 사용자 이름을 어떻게 넣나요?
Redis 6에서는 ACL 사용자가 추가되었습니다: redis://user:password@host:6379. 비밀번호만 있을 때는 다음과 같이 씁니다 redis://:password@host; 서버가 로그인시키는 사용자는 default 사용자.
이 문자열들이 Valkey에서도 작동하나요?
네. Valkey는 Redis와 프로토콜이 호환되므로 같은 URI, 구성 문자열, redis-cli 플래그(또는 valkey-cli)가 그대로 작동합니다. SQLly도 valkey:// 그리고 valkeys://.
한 번 연결하세요. 그 뒤는 그냥 SQL만 쓰면 됩니다.
SQLly는 macOS, Windows, Linux용 네이티브 SQL 워크벤치입니다. 연결 편집기에 연결 문자열을 붙여넣고, 비밀번호는 시스템 키체인에 보관하고, Redis 등에서 스키마 인식 IntelliSense를 사용할 수 있습니다.