litestream

(★ 14,283)

SQLite를 위한 스트리밍 복제(Streaming replication).

파일 탐색기

최종 버전 다운로드 (.zip)

- - ltx-compaction-specialist.md
  - performance-optimizer.md
  - replica-client-developer.md
  - sqlite-expert.md
  - test-engineer.md
- - add-storage-backend.md
  - analyze-ltx.md
  - debug-ipc.md
  - debug-wal.md
  - fix-common-issues.md
  - run-comprehensive-tests.md
  - test-compaction.md
  - trace-replication.md
  - validate-replica.md
- settings.json
- - bug_report.md
  - config.yml
  - feature_request.md
- - nightly-stability-jobs.js
  - nightly-stability-jobs.test.js
- - commit.yml
  - integration-tests.yml
  - manual-integration-tests.yml
  - nightly-stability.yml
  - pr-metrics.yml
  - pre-release-checklist.yml
  - release.docker.yml
  - release.yml
  - stale-issues.yml
  - upgrade-tests.yml
- copilot-instructions.md
- pull_request_template.md
- - library_example_test.go
  - README.md
- replica_client.go
- - databases.go
  - databases_test.go
  - directory_watcher.go
  - directory_watcher_stress_test.go
  - directory_watcher_test.go
  - helpers_test.go
  - info.go
  - info_test.go
  - list.go
  - list_test.go
  - ltx.go
  - ltx_test.go
  - main.go
  - main_cli_test.go
  - main_notwindows.go
  - main_test.go
  - main_windows.go
  - mcp.go
  - register.go
  - register_test.go
  - replicate.go
  - replicate_test.go
  - reset.go
  - reset_test.go
  - restore.go
  - restore_test.go
  - start.go
  - start_stop_test.go
  - status.go
  - status_test.go
  - stop.go
  - sync.go
  - sync_test.go
  - unregister.go
  - unregister_test.go
  - version.go
  - version_cli_test.go
  - version_test.go
- - load.go
  - main.go
  - populate.go
  - README.md
  - S3-RETENTION-TESTING.md
  - shrink.go
  - validate.go
- - chaos_test.go
  - fuzz_test.go
  - hydration_e2e_test.go
  - main.go
  - main_test.go
  - stress_test.go
  - time_travel_test.go
  - vfs_soak_test.go
  - vfs_write_integration_test.go
- ARCHITECTURE.md
- CLI_JSON_OUTPUT.md
- DOC_MAINTENANCE.md
- LTX_FORMAT.md
- PATTERNS.md
- PENDING_USER_DOCS.md
- PROVIDER_COMPATIBILITY.md
- REPLICA_CLIENT_GUIDE.md
- SQLITE_INTERNALS.md
- TESTING_GUIDE.md
- VFS.md
- build.ps1
- gon-sign.hcl
- gon.hcl
- litestream.service
- litestream.wxs
- litestream.yml
- nfpm.yml
- run-s3-docker-tests.sh
- s3_mock.py
- replica_client.go
- replica_client_test.go
- litestream-dashboard.json
- README.md
- replica_client.go
- replica_client_test.go
- - testingutil.go
- hexdump.go
- internal.go
- internal_unix.go
- internal_windows.go
- limit_read_closer.go
- lock_unix.go
- lock_windows.go
- log.go
- log_test.go
- resumable_reader.go
- resumable_reader_test.go
- replica_client.go
- replica_client.go
- replica_client_test.go
- replica_client.go
- replica_client_test.go
- - MANIFEST.in
  - README.md
  - setup.py
- - litestream-vfs.gemspec
  - README.md
- leaser.go
- leaser_test.go
- replica_client.go
- replica_client_test.go
- analyze-test-results.sh
- local-soak.sh
- README.md
- run-upgrade-tests.sh
- setup-homebrew-tap.sh
- replica_client.go
- - SKILL.md
- litestream-vfs.c
- sqlite3.h
- sqlite3ext.h
- sqlite3vfs.h
- - litestream-test-polling.yml
  - README.md
  - test-cpu-usage.sh
- - boundary_test.go
  - compatibility_test.go
  - comprehensive_soak_test.go
  - concurrent_test.go
  - directory_watcher_helpers.go
  - directory_watcher_test.go
  - docker_helpers.go
  - fixtures.go
  - helpers.go
  - load_profiles.go
  - ltx_assertions.go
  - ltx_assertions_test.go
  - ltx_behavior_test.go
  - minio_soak_test.go
  - overnight_s3_soak_test.go
  - overnight_test.go
  - profile_test.go
  - quick_test.go
  - README.md
  - s3_access_point_test.go
  - s3_restore_connection_drop_test.go
  - scenario_test.go
  - shutdown_retry_test.go
  - soak_helpers.go
  - soak_replicate_restore_test.go
  - upgrade_test.go
- replica_client.go
- replica_client_test.go
.aiexclude
.cursorrules
.gitignore
.goreleaser.yml
.markdownlint.json
.pre-commit-config.yaml
AGENTS.md
AI_PR_GUIDE.md
CLAUDE.md
compaction_level.go
compactor.go
compactor_test.go
CONTRIBUTING.md
db.go
db_internal_test.go
db_shutdown_test.go
db_test.go
docker-compose.test.yml
Dockerfile
GEMINI.md
go.mod
go.sum
heartbeat.go
heartbeat_test.go
leaser.go
LICENSE
litestream.go
litestream_test.go
llms.txt
log.go
Makefile
README.md
replica.go
replica_client.go
replica_client_test.go
replica_internal_test.go
replica_test.go
replica_url.go
replica_url_test.go
restore_fuzz_test.go
SECURITY.md
server.go
server_test.go
store.go
store_compaction_remote_test.go
store_test.go
v3.go
v3_test.go
vfs.go
vfs_compaction_test.go
vfs_test.go
vfs_write_test.go
wal_reader.go
wal_reader_test.go

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/benbjohnson/litestream

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd litestream

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Docker

쉬움 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Docker Desktop 컨테이너를 빌드하고 실행하려면 필요합니다. 설치 후 실행해서 백그라운드에 켜두세요.

docker compose -f docker-compose.test.yml up -d --build

compose 설정 파일에 정의된 서비스들을 대상으로 명령을 실행합니다.

✅ 터미널에 docker compose ps 를 입력해 컨테이너들이 Up 상태인지 확인하세요. README에 포트 번호가 적혀있다면 브라우저에서 http://localhost:포트번호 로 접속해보세요.

3. Node.js

쉬움

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Node.js npm 명령어를 쓰려면 Node.js가 설치되어 있어야 합니다. LTS(장기지원) 버전을 추천합니다.

⚠️ 이 프로젝트는 규모가 큰 저장소라, 이 방법이 실제 핵심 제품이 아니라 내부 하위 패키지를 가리키는 것일 수 있습니다. README 전체를 함께 확인해보세요.

cd packages/npm/litestream-vfs-darwin-amd64

이 프로젝트의 관련 파일이 하위 폴더 안에 있어서, 먼저 그 폴더로 이동합니다.

npm install

package.json에 명시된 라이브러리들을 내려받아 설치합니다.

npm start

개발/실행 서버를 켭니다.

✅ 명령어 실행 후 터미널에 나타나는 주소(보통 http://localhost:3000 형태)를 브라우저에서 열어보세요.

4. Python

쉬움

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Python 3 설치 시 'Add Python to PATH' 옵션을 꼭 체크하세요 (Windows).

⚠️ 이 프로젝트는 규모가 큰 저장소라, 이 방법이 실제 핵심 제품이 아니라 내부 하위 패키지를 가리키는 것일 수 있습니다. README 전체를 함께 확인해보세요.

pip install .

PyPI에 배포된 패키지를 바로 설치합니다. 소스 클론이 필요 없습니다.

python <실행할 파일명>.py # README에서 정확한 실행 파일명을 확인하세요

파이썬 스크립트(또는 모듈)를 실행합니다.

✅ 에러 메시지 없이 실행되고 터미널에 안내 문구가 출력되면 정상입니다.

5. Go

보통

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Go Go 언어 컴파일러 및 도구 모음입니다.

go build ./...

Go 프로그램을 컴파일해 실행 파일을 만듭니다.

go run .

따로 빌드하지 않고 바로 Go 프로그램을 실행합니다.

✅ 빌드가 에러 없이 끝나면 성공입니다. go run . 을 썼다면 터미널 출력을 확인하세요.

6. Make

보통

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Make Linux/macOS는 보통 기본 설치되어 있습니다. Windows는 별도 설치(예: MSYS2, WSL)가 필요합니다.

make

생성된 빌드 설정을 바탕으로 실제 컴파일을 진행해 실행 파일을 만듭니다.

✅ 에러 없이 끝나면 성공입니다. 생성된 실행 파일을 직접 실행해보세요.

litestream

파일 탐색기

# 설치 가이드

2. Docker

3. Node.js

4. Python

5. Go

6. Make

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

litestream

파일 탐색기

# 설치 가이드

2. Docker

3. Node.js

4. Python

5. Go

6. Make

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README