Kvmzen 블로그
← 기술 실전으로 돌아가기

오픈소스 개인 재무 관리 시스템은 어떻게 배포할까? Sure Docker 설치, 데이터베이스 설정, 계정 관리와 데이터 백업 완전 가이드

CI/CD ·약 9분 읽기

오픈소스 개인 재무 관리 시스템은 어떻게 배포할까? Sure Docker 설치, 데이터베이스 설정, 계정 관리와 데이터 백업 완전 가이드

문제: 설치 예시만 따라 하면 데이터베이스 연결이나 재시작 후 데이터 보존을 놓칠 수 있습니다.
빠른 해결: Sure 공식 배포 문서와 현재 환경 설정 예시를 먼저 확인하고, 설치 뒤에는 계정 생성과 데이터 복구까지 검증하세요.

이 글은 자체 서버에 Sure를 올려 개인이나 가족의 재무 정보를 관리하려는 분을 위한 안내입니다. Docker 사용 경험이 있고 데이터베이스와 영구 저장소를 직접 관리할 분에게 특히 적합합니다.

오픈소스 개인 재무 관리 시스템 배포 전 점검

Sure의 이미지 이름이나 데이터베이스 종류, 환경 변수는 오래된 블로그 글에서 복사하지 마세요. Sure 공식 Docker 배포 안내와 공식 Compose 예시, 환경 변수 예시를 같은 시점의 기준으로 삼으세요. 문서에 적힌 필수 서비스와 설정이 실제로 내려받은 파일에도 있는지 대조해야 합니다.

점검 항목 확인할 내용 시작해도 되는 조건
컨테이너 실행 환경 Docker와 Compose 명령이 동작하는지 확인합니다. Compose 설정을 읽고 실행할 수 있습니다.
Sure 배포 파일 공식 문서와 예시의 이미지, 서비스, 실행 방법을 비교합니다. 파일이 공식 안내와 일치하고 필요한 값을 파악했습니다.
데이터 저장 데이터베이스와 파일 저장 경로가 어떻게 지정되는지 확인합니다. 재기동 후에도 유지할 데이터를 식별했습니다.
네트워크와 접근 정보 서버에서 서비스에 접근할 경로와 필요한 비밀값을 준비합니다. 접근 경로와 비밀값을 공개하지 않고 관리할 수 있습니다.
저장 공간과 복구 위치 데이터 저장소와 별도로 백업을 보관할 위치를 정합니다. 백업이 원본 컨테이너나 저장소와 분리됩니다.

이 중 하나라도 불분명하면 설치를 미루세요. 특히 영구 저장소가 어디인지 모른 채 컨테이너를 지우거나 새로 만들면 재무 기록을 잃을 수 있습니다.

Docker 설치와 기동

Sure는 어떻게 Docker로 설치하고 실행하나요?

먼저 공식 안내에서 제공하는 배포 파일을 준비하고, .env.example에 있는 항목을 확인합니다. 설정 이름과 필수 여부는 실제 파일을 기준으로 하세요. 추측한 환경 변수를 추가하거나 예전 설치 글의 이미지를 그대로 쓰지 않는 것이 안전합니다.

Compose 파일을 준비한 디렉터리에서 설정이 해석되는지 확인한 다음 서비스를 실행합니다.

docker compose config
docker compose pull
docker compose up -d
docker compose ps
docker compose logs -f <서비스명>

config는 Compose 설정을 확인하고, pull은 지정된 이미지를 가져오며, up -d는 서비스를 백그라운드에서 시작합니다. 이 명령은 Docker Compose 공식 명령 참고에 설명된 일반적인 Compose 사용 방식입니다. <서비스명>에는 실제 Compose 파일에 정의된 이름을 넣으세요. 서비스 목록과 로그에서 기동 실패나 데이터베이스 연결 오류가 없는지 확인하고, 배포 문서에 적힌 주소로 접속해 응답을 확인합니다.

환경 변수 파일에는 비밀값이 들어갈 수 있습니다. 공개 저장소에 올리지 말고, 배포 서버의 접근 권한도 필요한 사용자로 제한하세요.

컨테이너가 실행 중이라는 사실만으로 배포가 끝난 것은 아닙니다. 앱 화면에 접속할 수 있는지, 데이터베이스 연결이 정상인지, 재기동 후에도 입력한 내용이 남는지 따로 확인해야 합니다.

데이터베이스 설정과 영구 저장

Sure Docker 배포에는 어떤 데이터베이스 설정이 필요하나요?

정확한 데이터베이스 종류와 설정 이름은 현재 Sure 배포 문서와 Compose 파일에서 확인해야 합니다. 여기서는 특정 데이터베이스를 Sure의 필수 구성이라고 단정하지 않습니다. Compose 예시에 데이터베이스 서비스가 포함되어 있는지, 앱이 어떤 연결 정보를 읽는지, 해당 값이 환경 변수 예시에 어떻게 표현되어 있는지 맞춰 보세요.

설정 범위 확인할 값 확인 방법
데이터베이스 종류와 서비스 공식 예시에서 사용하는 서비스와 이미지 Compose 예시와 배포 문서를 대조합니다.
연결 정보 호스트, 포트, 데이터베이스 이름, 사용자, 비밀값에 해당하는 항목 환경 변수 예시의 실제 이름과 설명을 확인합니다.
영구 저장소 데이터베이스가 기록하는 볼륨이나 경로 Compose 설정에서 저장소 연결을 확인합니다.
앱과 데이터베이스의 연결 앱이 참조하는 서비스 이름과 연결 값 시작 로그와 연결 오류 메시지를 확인합니다.

설정 후에는 앱에서 테스트용 기록을 만들고 화면을 다시 열어 읽을 수 있는지 확인하세요. 이어서 Compose로 서비스를 재기동하고 같은 기록이 남아 있는지 살펴봅니다. 컨테이너를 다시 만들었을 때 데이터가 사라진다면 데이터가 컨테이너 내부에만 기록되고 영구 저장소에는 연결되지 않았을 가능성을 확인해야 합니다. Docker의 데이터 볼륨 설명을 참고해 실제 볼륨 연결과 보존 방식을 점검하세요.

연결이 실패하면 앱 로그와 데이터베이스 로그를 함께 살펴보세요. 서비스 이름 오기, 서로 다른 연결 값, 잘못된 비밀값, 데이터베이스 준비 전 앱이 먼저 시작되는 상황을 구분해 확인합니다. 원인을 모른 채 데이터베이스를 지우거나 볼륨을 초기화하면 기존 데이터까지 사라질 수 있습니다.

계정 초기화와 비밀값 보호

배포 뒤 계정은 어떻게 만들고 관리하나요?

첫 실행 화면이나 공식 안내에 표시된 초기화 절차를 따르세요. Sure가 제공한다고 확인되지 않은 역할, 초대 기능, 권한 설정을 전제로 운영 절차를 만들면 안 됩니다. 계정을 만든 뒤에는 로그아웃 후 다시 로그인해 자격 정보가 유효한지 확인하고, 재기동 후에도 계정과 기록을 읽을 수 있는지 점검합니다.

비밀번호와 데이터베이스 비밀값은 서로 다른 강한 값으로 설정하세요. 설정 파일에 필요한 값이 있더라도 저장소에 평문으로 커밋하지 마세요. 실제로 사용할 수 있는 비밀값 주입 방식은 배포 환경과 공식 문서가 지원하는 방법을 확인한 뒤 선택해야 합니다. 접근 권한이 있는 사람과 계정 복구 절차도 함께 기록해 두면 운영자가 바뀌거나 자격 정보를 잃었을 때 혼란을 줄일 수 있습니다. 재무 정보와 계정 정보를 다룰 때는 개인정보 처리 안내도 확인해 데이터 취급 기준을 살펴보세요.

백업과 복구 검증

Sure의 Docker 데이터는 어떻게 백업하고 복구하나요?

백업 대상을 정할 때는 데이터베이스 자료, Sure가 사용하는 영구 파일 저장소, 배포 설정과 필요한 환경 값을 구분하세요. 무엇을 저장해야 하는지는 Compose 파일과 Sure 문서에서 확인해야 합니다. 데이터베이스 덤프만 만들고 별도 파일 저장소를 빠뜨리거나, 환경 설정을 통째로 공개된 위치에 복사하는 방식은 피하세요.

보관 대상 백업할 내용 주의할 점
데이터베이스 사용 중인 데이터베이스가 지원하는 일관된 덤프 또는 백업 접속 정보와 명령은 해당 데이터베이스의 공식 안내에 맞춥니다.
영구 파일 저장소 Compose에서 Sure에 연결한 실제 볼륨이나 경로 컨테이너 안의 임시 경로와 혼동하지 않습니다.
배포 설정 Compose 파일과 복구에 필요한 설정 정보 비밀값은 별도로 보호하고 공개 저장소에 넣지 않습니다.

PostgreSQL을 실제로 사용하도록 구성한 경우에만 PostgreSQL 공식 pg_dump 문서를 참고해 덤프 방식을 정하세요. 이 문서는 PostgreSQL 데이터베이스의 백업 도구에 관한 안내이지, Sure가 반드시 PostgreSQL을 사용한다는 뜻은 아닙니다. 다른 데이터베이스라면 해당 데이터베이스의 공식 백업 절차를 따르세요.

백업 파일은 운영 데이터와 분리된 안전한 위치에 보관하고 접근 권한을 제한합니다. 복구 검증은 운영 인스턴스가 아닌 격리된 시험 환경에서 진행하세요. 백업을 복원한 뒤 계정으로 로그인하고 재무 기록을 읽을 수 있는지 확인해야 백업 파일이 실제 복구에 쓸 수 있는지 판단할 수 있습니다.

백업 파일이 생성됐다는 로그만으로 복구 가능성이 확인되지는 않습니다. 실제 복원과 화면에서의 기록 확인까지 마쳐야 복구 점검이 완료됩니다.

배포 완료 확인과 장애 대응

다음 항목을 하나씩 확인하세요. 해당되지 않는 항목이 있으면 운영에 넘기기 전에 원인을 해결합니다.

  • [ ] 공식 배포 문서와 실제 Compose 파일의 이미지, 서비스, 설정이 일치합니다.
  • [ ] Compose 상태와 로그에서 앱 및 필요한 서비스의 기동 오류가 보이지 않습니다.
  • [ ] Sure 화면에 접속하고 초기 계정으로 로그인할 수 있습니다.
  • [ ] 재무 기록을 저장한 뒤 다시 읽을 수 있고, 서비스 재기동 후에도 남아 있습니다.
  • [ ] 데이터베이스와 영구 파일 저장소를 확인해 백업 범위에 포함했습니다.
  • [ ] 격리된 환경에서 백업을 복원하고 계정과 재무 기록을 확인했습니다.
증상 먼저 확인할 곳 다음 조치
앱이 시작되지 않음 Compose 설정 해석 결과와 앱 로그 잘못된 변수나 이미지 설정이 없는지 공식 예시와 비교합니다.
데이터베이스 연결 실패 앱 로그, 데이터베이스 로그, 연결 값 서비스 이름과 자격 정보가 서로 일치하는지 확인합니다.
재기동 뒤 데이터가 사라짐 Compose의 볼륨 연결과 실제 저장 경로 컨테이너 내부 임시 경로에만 쓰고 있지 않은지 점검합니다.
백업을 읽을 수 없음 사용한 백업 도구와 복구 절차 해당 데이터베이스의 공식 복구 안내에 맞게 시험 환경에서 다시 검증합니다.

오류 로그와 사용한 설정 파일의 위치를 기록해 두면 다음 점검 때 같은 문제를 반복하지 않습니다. 단, 로그나 설정을 다른 사람과 공유하기 전에 계정 정보와 비밀값을 반드시 가리세요.

Sure의 자가 호스팅은 재무 데이터를 직접 관리할 수 있는 대신, 데이터베이스와 백업 상태를 네가 점검해야 합니다. 배포 후에는 위 목록으로 서비스 접근, 데이터 보존, 복구를 확인하고 실제 설정과 백업 절차를 기록해 두세요. macOS 개발이나 빌드 환경이 별도로 필요하다면 한국에서 이용하는 맥 미니 대여 안내와 자체 서버 운영을 비교해 보세요. 자체 서버에서 물리 장비 연결이 필요하거나 지속적인 무거운 작업을 운영하려는 경우에는 임시 원격 환경보다 직접 관리하는 장비가 더 적합할 수 있습니다.

한정 특가

단순한 Mac이 아닌, 클라우드의 개발 기지

전용 컴퓨팅 · 글로벌 노드 · 월간 구독 · 하드웨어 불필요

홈으로 돌아가기
한정 특가 플랜 보기