간편한 비즈니스 지식 관리:飞书 문서를 로컬에 자동 백업하기
기업의 핵심 문서가 클라우드에만 의존하면, 데이터 유출, 서비스 장애, 실수 삭제 등의 리스크가 발생할 수 있습니다. 이 문제를 해결하기 위해 feishu-doc-export라는 오픈소스 도구를 활용해, 단 3단계로 모든 문서를 로컬에 안전하게 백업할 수 있습니다.
1. 주요 문제점 분석
- 데이터 소유권 상실: 중요한 의사결정 기록이 외부 플랫폼에만 저장되면, 조직이 통제할 수 없는 상황이 발생합니다.
- 포맷 불일치: 마크다운, 워드, PDF 등 다양한 형식으로 변환해야 하는 작업은 반복적이고 시간 소모가 큽니다.
- 대량 처리의 어려움: 수백 개 문서를 수작업으로 내려받는 것은 오류와 누락을 초래하며, 인력 부담이 큽니다.
2. 솔루션의 핵심 기능
- 데이터 주권 확보: API 권한을 통해 문서 접근 후, 로컬 디렉터리에 복제하며, 원본과 동기화된 백업을 제공합니다.
- 다양한 출력 포맷 지원: 마크다운, DOCX, PDF로 변환 가능하며, 텍스트 및 레이아웃 정확도는 98% 이상입니다.
- 자동화 및 스케줄링: 지정된 폴더 구조를 기반으로 재귀적으로 문서를 탐색하고, 업데이트된 항목만 별도로 추출할 수 있습니다.
3. 실행 절차: 설정에서 백업까지
- 환경 준비
.NET 6 이상 환경을 설치하고, 다음 명령어로 확인합니다:
dotnet --version - 프로젝트 다운로드
다음 명령어로 코드를 가져옵니다:
git clone https://gitcode.com/gh_mirrors/fe/feishu-doc-export
cd feishu-doc-export - 앱 권한 설정
자체 애플리케이션을 생성하고 아래 권한을 추가하세요:
-docs:read(문서 읽기)
-wiki:space:read(지식 공간 읽기)
-docs:export(문서 내보내기)
4. 구성 파일 설정
src/feishu-doc-export폴더로 이동하여 설정 파일을 복사합니다:
cp appsettings.example.json appsettings.jsonappsettings.json파일을 열고 다음 정보를 입력합니다:
{ "AppId": "애플리케이션 식별자", "AppSecret": "보안 키", "ExportPath": "C:/backups/feishu-docs", "SpaceId": "지식공간 고유 ID" }- 주의사항:
AppSecret은 보안을 위해 절대 공유하지 마세요.
5. 백업 실행
- 프로젝트 루트에서 다음 명령어 실행:
dotnet run --project src/feishu-doc-export - 첫 실행 시, 브라우저를 통해 애플리케이션 권한 승인을 요청합니다.
- 완료 후, 지정된 경로에 원본 구조를 유지한 채 문서들이 자동 생성됩니다.
6. 고급 옵션 조정
| 설정명 | 값 범위 | 기본값 | 설명 |
|---|---|---|---|
| ConcurrentTasks | 1-10 | 3 | 병렬 다운로드 작업 수 |
| ExportFormat | markdown/docx/pdf/all | all | 출력 형식 지정 |
| IncludeComments | true/false | false | 댓글 포함 여부 |
| UpdateOnly | true/false | true | 최근 변경 사항만 추출 |
| RetryCount | 1-5 | 3 | 실패 시 재시도 횟수 |
appsettings.json에 다음 내용을 추가하여 설정을 확장합니다:
"AdvancedSettings": {
"ConcurrentTasks": 5,
"ExportFormat": "markdown",
"UpdateOnly": true
}
7. 자동 백업 구성 예시
- Linux 사용자:
crontab -e로 매주 일요일 오전 2시에 실행되도록 설정:
0 2 * * 0 dotnet run --project /path/to/feishu-doc-export/src/feishu-doc-export >> /var/log/feishu-backup.log 2>&1 - Windows 사용자: 작업 스케줄러를 이용해 매주 02:00에 배치 파일 실행
8. 문서 구조 최적화 팁
추천되는 로컬 저장 구조:feishu-exports/ ├─ R&D/ │ ├─ 프로젝트 설명서/ │ └─ 아키텍처 가이드/ ├─ 마케팅/ │ ├─ 캠페인 계획서/ │ └─ 고객 분석 리포트/ └─ 운영/ ├─ 회의록/ └─ 정책 문서/
9. 실제 적용 사례
- 개발팀: 매일 새벽 자동 백업 후, Git 저장소와 연동하여 문서 버전 관리
- 교육기관: 매주 교육 계획서를 PDF로 변환해 학생에게 배포, 네트워크 없이도 접근 가능
- 규제 준수 목적: 월말 전체 백업 후 암호화 저장, 감사용 보고서 생성