페이지 안의 SQLly: 릴레이 프록시 모드
정상 동작직접 운영하는 릴레이를 통해 자신의 데이터베이스를 브라우저 빌드로 실행하세요 - 릴레이가 자격 증명을 보관하므로 페이지에는 비밀번호가 노출되지 않습니다.
그 브라우저 빌드 SQLly는 보통 탭 안의 샘플 데이터로 동작합니다. 웹 페이지는 데이터베이스 소켓을 열 수 없기 때문입니다. 릴레이 프록시 모드 실제 서버를 하나 붙여 줍니다: 다음은 sqlly-relay 실행하면 전달받는
자격 증명 파일, 그리고 브라우저 빌드는 그 릴레이 주소로 열어 파일 안의 모든 서버와 데이터베이스를 쿼리합니다. 객체 탐색기, IntelliSense, 실행 계획, 행 편집까지 전부 동작하는데, 비밀번호는 절대 릴레이 호스트를 떠나지 않습니다.
전체적인 구성 방식
browser (SQLly on a page) --wss--> sqlly-relay proxy --local--> SQLly engine --TDS / PG / MySQL / ...--> your databases
holds the credential file one per browser session
- 릴레이는 자격 증명 파일을 제공합니다. 그 안의 모든 연결 - 서버, 데이터베이스, 로그인과 비밀번호, 공유 로그인, SSH 터널과 프록시, 그리고 클라이언트, 프로젝트, 환경 레이블 - 이 브라우저가 닿을 수 있는 전부입니다. 그 밖에는 아무것도 없습니다.
- 세션당 한 개의 엔진. 각 브라우저 세션은 릴레이 호스트에서 자체 SQLly 엔진을 받으며, 파일에 저장된 연결만 열 수 있도록 잠긴 모드로 시작됩니다. 자체 서버를 지정하거나 자체 비밀번호를 담은 요청은 거부됩니다.
- 브라우저는 비밀 정보를 받는 것이 아니라 이름을 받습니다. 비밀번호, 터널 설정, 토큰을 뺀 연결 목록을 받을 뿐 목록은 저장하지 않습니다. 릴레이가 페이지를 로드할 때마다 새로 전송합니다.
- 릴레이의 나머지 역할은 그대로입니다. 프록시는 별도의 선택적 리스너입니다. 이를 활성화하지 않는 릴레이는 이전과 동일하게 Via Relay 트래픽을 전달합니다.
릴레이를 설정하세요
데이터베이스에 접근할 수 있고 다음이 설치된 호스트에서는 sqlly-cli 옆에 설치된
sqlly-relay, 자격 증명 파일을 작성합니다(데스크톱 앱에서 다음으로 내보내기
파일 → 연결 내보내기(자격 증명 포함)…, 또는 직접 작성)한 뒤, 평소 구성에 프록시 플래그를 추가해서 릴레이를 시작합니다:
sqlly-relay \ --tls-cert /certs/relay.crt --tls-key /certs/relay.key \ --proxy-credentials /etc/sqlly/browser-connections.json \ --proxy-token 'a-long-random-secret' \ --proxy-bind 0.0.0.0:8444 \ --proxy-allowed-origins https://sqlly.app
| 플래그 | 기능 |
|---|---|
--proxy-credentials | 자격 증명 파일입니다. 이 파일을 설정해야 프록시가 켜집니다. 파일은 새 브라우저 세션마다 다시 읽히므로 편집한 내용은 재시작 없이도 적용됩니다. |
--proxy-token | 브라우저가 제시해야 하는 공유 비밀. 필수: 이것 없이는 릴레이가 시작을 거부하며, 유일한 예외는 --proxy-insecure-no-token, 포트에 닿을 수 있는 사람이면 누구나 나열된 모든 데이터베이스에 접근할 수 있게 됩니다. |
--proxy-bind | 프록시가 수신 대기하는 위치이며, 기본값은 포트 8444입니다. 다음 용도로 릴레이의 TLS 인증서를 사용합니다 wss://; --proxy-plain 다음을 제공합니다 ws:// 로컬 테스트나 TLS 종단을 대신 맡는 리버스 프록시 뒤에서는. |
--proxy-allowed-origins | 세션을 열 수 있도록 허용된 웹 출처를 쉼표로 구분해 지정합니다. 따라서 직접 호스팅하는 페이지만 프록시를 사용할 수 있습니다. 모든 출처를 허용하려면 생략하십시오(토큰은 여전히 적용됩니다). |
--proxy-max-sessions | 동시에 열 수 있는 브라우저 세션 수(각각이 하나의 엔진 프로세스); 기본값은 32입니다. 가득 찬 프록시는 새 세션에게 나중에 다시 시도하라고 요청합니다. |
--proxy-engine-binary | 위치 sqlly-cli 옆에 있지 않다면 sqlly-relay 또는 PATH. |
모든 플래그에는 환경 변수 형태가 있습니다 (RELAY_PROXY_CREDENTIALS,
RELAY_PROXY_TOKEN, 등)을 위한 컨테이너 배포입니다. 릴레이 컨테이너 이미지는 다음과 함께 빌드하면 엔진을 포함합니다 --build-arg WITH_PROXY_ENGINE=1.
두 가지 규칙이 데스크톱 가져오기와 다릅니다: 공유 로그인과 터널 프로필은 동일한 파일에 정의되어야 합니다 (릴레이에는 참조할 저장된 연결이 없음), 그리고
via-relay 연결에서는 이 경로가 무시됩니다. 릴레이 호스트가 모든 서버에 직접 연결하기 때문입니다.
브라우저 빌드로 열어 보기
브라우저 빌드의 URL에 프록시 주소와 토큰을 추가합니다:
https://sqlly.app/app/?proxy=wss://relay.example.com:8444/proxy&token=a-long-random-secret
빌드를 삽입하는 페이지는 앱이 부팅하기 전에 전역으로 SQLLY_PROXY_URL 그리고
SQLLY_PROXY_TOKEN 앱이 시작되기 전에 주소 표시줄에 넣지 않고 전역으로 설정해 두면 됩니다. 로드 시 앱이 연결되고, 상태 줄에 릴레이 이름과 그 릴레이가 서비스하는 연결 수가 표시되며, 그 연결들은 탐색기에 나타나 바로 사용할 수 있습니다. 이 모드에서는 샘플 데이터베이스를 전혀 내려받지 않습니다.
앱에서의 변경 사항
- 연결은 읽기 전용입니다. 이 목록은 릴레이의 목록입니다. 서버 추가, 복제, 삭제, 연결 가져오기는 비활성화되고, 연결 관리자의 추가·제거·복제 버튼과 클라이언트·프로젝트·환경 편집기는 잠겨 있으며, 연결을 열면 다음과 같이 표시됩니다 연결 보기 저장이 비활성화되어 있으며 릴레이가 자격 증명을 보유하고 있다는 메모가 표시됩니다. 사용자가 보는 내용을 변경하려면 릴레이의 자격 증명 파일을 변경하십시오.
- 연결 테스트는 여전히 동작합니다 - 프록시를 거쳐 어떤 쿼리와 똑같이 실행되고, 모든 쿼리 기능, 객체 탐색기, IntelliSense 카탈로그 동기화, 실행 계획, 스크립팅, 행 편집도 마찬가지입니다.
- 라벨도 함께 표시됩니다. 파일의 클라이언트·프로젝트·환경 이름, 색상, 안전 스위치가 데스크톱에서와 똑같이 탐색기를 그룹화합니다. 페이지를 가볍게 유지하려고 아이콘은 빠져 있습니다.
- 릴레이가 사라지면 - 상태 줄에 그 사실이 표시되고, 프록시 연결의 쿼리는 페이지를 새로 고칠 때까지 명확한 메시지와 함께 실패합니다.