Docker Compose

​

개요

​

시스템 요구 사항

• RAM: 환경에 최소 2GB의 RAM이 있는지 확인하십시오. 메모리가 충분하지 않으면 프로세스가 중단될 수 있습니다.
• Docker 및 Docker Compose: 둘 다 설치되고 최신 상태인지 확인하세요.

​

옵션 1: 한 줄 스크립트

bash <(curl -sL https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/scripts/install.sh)

VERSION=vx.y.z BRANCH=branch-name bash <(curl -sL https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/scripts/install.sh)

• 원하는 버전 번호로 x.y.z를 대체하십시오.
• 설치할 브랜치 이름으로 branch-name을 대체하십시오.

​

옵션 2: 수동 단계

​

단계 1: 환경 파일 설정

1. .env 파일 생성 예제 환경 파일을 워킹 디렉토리의 새 .env 파일로 복사합니다.
   curl -o .env https://raw.githubusercontent.com/twentyhq/twenty/refs/heads/main/packages/twenty-docker/.env.example
   
2. 암호화 키 생성하기 고유한 랜덤 문자열을 생성하기 위해 다음 명령을 실행하세요:
   openssl rand -base64 32
   
   중요: 이 값을 비공개로 유지/공유하지 마십시오. ENCRYPTION_KEY를 잃어버리면 데이터베이스에 저장된 모든 비밀(예: OAuth 토큰, 애플리케이션 변수, TOTP 비밀 등)에 대한 액세스를 잃게 됩니다.
3. .env 업데이트 생성된 토큰으로 .env 파일의 플레이스홀더 값을 대체합니다.
   ENCRYPTION_KEY=random_string
   
   중단 없이 키를 회전하는 방법은 키 회전 가이드를 참조하세요.
4. Postgres 비밀번호 설정 .env 파일에서 특수 문자가 없는 강력한 비밀번호로 PG_DATABASE_PASSWORD 값을 업데이트하십시오.
   PG_DATABASE_PASSWORD=my_strong_password
   

​

단계 2: Docker Compose 파일 얻기

curl -o docker-compose.yml https://raw.githubusercontent.com/twentyhq/twenty/refs/heads/main/packages/twenty-docker/docker-compose.yml

​

단계 3: 애플리케이션 시작

docker compose up -d

​

단계 4: 애플리케이션에 액세스

curl http://localhost:3000

​

구성

​

Twenty를 외부 액세스에 노출

​

SERVER_URL 이해하기

• 프로토콜: 구성에 따라 http 또는 https를 사용하십시오.
  • SSL을 설정하지 않은 경우 http를 사용합니다.
  • SSL이 구성되어 있으면 https를 사용하십시오.
• 도메인/IP: 애플리케이션을 액세스할 수 있는 도메인 이름 또는 IP 주소입니다.
• 포트: 기본 포트(http의 경우 80, https의 경우 443)를 사용하지 않는 경우 포트 번호를 포함하십시오.

​

SSL 요구 사항

​

SERVER_URL 설정

1. 접속 URL 결정
   • 리버스 프록시 없이(직접 접속): 리버스 프록시 없이 애플리케이션에 직접 액세스:
     SERVER_URL=http://your-domain-or-ip:3000
     
   • 리버스 프록시 사용 (표준 포트): SSL이 구성된 Nginx 또는 Traefik과 같은 리버스 프록시를 사용하는 경우:
     SERVER_URL=https://your-domain-or-ip
     
   • 리버스 프록시 사용 (사용자 지정 포트): 비표준 포트를 사용하는 경우:
     SERVER_URL=https://your-domain-or-ip:custom-port
     
2. .env 파일 업데이트 .env 파일을 열고 SERVER_URL을 업데이트하십시오:
   SERVER_URL=http(s)://your-domain-or-ip:your-port
   
   예시:
   • SSL 없이 직접 접근:
     SERVER_URL=http://123.45.67.89:3000
     
   • SSL을 사용한 도메인 접근:
     SERVER_URL=https://mytwentyapp.com
     
3. 애플리케이션 재시작 변경 사항을 적용하기 위해 Docker 컨테이너를 재시작하십시오.
   docker compose down
   docker compose up -d
   

​

고려 사항

• 리버스 프록시 구성: 리버스 프록시가 올바른 내부 포트(3000 기본값)로 요청을 전달하도록 확인하십시오. SSL 종료와 필요한 헤더를 구성하십시오.
• 방화벽 설정: 외부 액세스를 허용하기 위해 방화벽에서 필요한 포트를 엽니다.
• 일관성: SERVER_URL은 사용자가 브라우저에서 애플리케이션에 액세스하는 방식과 일치해야 합니다.

​

영속성

• 데이터 볼륨: Docker Compose 구성은 데이터베이스 및 서버 저장소의 데이터를 영구적으로 저장하기 위해 볼륨을 사용합니다.
• 무상태 환경: 무상태 환경(예: 특정 클라우드 서비스)에 배포하는 경우 데이터 지속성을 위해 외부 저장소를 구성합니다.

​

백업 및 복원

​

데이터베이스 백업 생성

docker exec twenty-postgres pg_dump -U postgres twenty > backup_$(date +%Y%m%d).sql

​

일일 백업 자동화

0 2 * * * docker exec twenty-postgres pg_dump -U postgres twenty > /backups/twenty_$(date +\%Y\%m\%d).sql

​

백업에서 복원

1. 애플리케이션을 중지하세요:

docker compose stop server worker

2. 데이터베이스를 복원하세요:

docker exec -i twenty-postgres psql -U postgres twenty < backup_20240115.sql

3. 서비스 재시작:

docker compose up -d

​

백업 모범 사례

• 복원을 정기적으로 테스트하세요 — 백업이 실제로 작동하는지 확인하세요
• 백업을 오프사이트에 보관하세요 — 클라우드 스토리지(S3, GCS 등)를 사용하세요
• 민감한 데이터를 암호화하세요 — 암호화를 통해 백업을 보호하세요
• 여러 사본을 유지하세요 — 일간, 주간, 월간 백업을 보관하세요

​

문제 해결

​

관리형 호스팅