스크립트 상세 설명

모든 스크립트의 상세 설명 및 사용법
최종 업데이트: 2025-11-28

📁 스크립트 디렉터리 구조

~/scripts/
├── utilities/          # 자주 사용하는 유틸리티 (25개)
├── archive/            # 한 번 사용한 스크립트 (32개)
├── backup_*.sh         # 백업 스크립트
└── restore_*.sh        # 복원 스크립트

🔧 유틸리티 스크립트 (`~/scripts/utilities/`)

시스템 점검

`full_system_refactoring_check_v2.sh`

용도: 시스템 전체 리팩토링 필요 사항 점검

점검 항목: - 보안 관련 (비밀번호 하드코딩, 환경 변수 파일, SSH 설정, UFW 방화벽) - 시스템 리소스 (디스크 사용량, Docker 리소스, 메모리 사용량) - 로그 관리 (Logrotate 설정, 로그 파일 크기) - 포트 노출 (외부 노출 포트, Docker 포트 매핑) - 백업 시스템 (백업 스크립트, 백업 디렉터리, Cron 백업 작업) - 스크립트 관리 (스크립트 구조, 홈 디렉터리 스크립트) - 시스템 업데이트 (업데이트 가능한 패키지, 보안 업데이트) - 서비스 상태 (Docker 컨테이너, CasaOS 서비스)

사용법:

~/scripts/utilities/full_system_refactoring_check_v2.sh

출력: 콘솔에 점검 결과 출력

백업 관련

`backup_sensitive_files.sh`

용도: 민감 정보 파일 백업 (GPG 암호화 지원)

백업 대상: - ~/.env_secrets - ~/stacknori/.env - ~/stacknori/runner/.env - ~/.ssh/id_rsa - ~/.ssh/id_ed25519 - ~/.ssh/config

저장 위치: /mnt/HDD500GB/backups/env/

GPG 암호화: USE_GPG=1 및 GPG_PASSPHRASE 설정 시 암호화

보관 기간: 최신 30개만 유지

사용법:

# 환경 변수 설정 (선택사항)
export USE_GPG=1
export GPG_PASSPHRASE="your_passphrase"

# 스크립트 실행
~/scripts/utilities/backup_sensitive_files.sh

Cron: 매일 03:00 자동 실행

`backup_env_secrets.sh`

용도: 환경 변수 파일 (~/.env_secrets) 백업

저장 위치: /mnt/HDD500GB/backups/env/

GPG 암호화: USE_GPG=1 및 GPG_PASSPHRASE 설정 시 암호화

사용법:

~/scripts/utilities/backup_env_secrets.sh

Cron: 매일 03:45 자동 실행

정리 작업

`cleanup_pip_cache.sh`

용도: pip 캐시 정리

기능: - 정리 전/후 캐시 크기 확인 - pip cache purge 실행 - 회수된 용량 로그 기록

로그: ~/logs/automation/cleanup_pip_cache.log

사용법:

~/scripts/utilities/cleanup_pip_cache.sh

Cron: 매주 일요일 07:00 자동 실행

`cleanup_cursor_cache.sh`

용도: Cursor IDE 캐시 정리

정리 대상: - ~/.cursor-server/ 디렉터리 - ~/.cursor/projects/terminals/ 임시 파일 - 7일 이상 된 임시 파일

사용법:

~/scripts/utilities/cleanup_cursor_cache.sh

Cron: 매주 일요일 06:00 자동 실행

`cleanup_runner_cache.sh`

용도: GitHub Actions Runner 캐시 정리

정리 대상: - ~/stacknori/runner/_work/ 디렉터리 - ~/stacknori/runner/_diag/ 로그 파일 (7일 이상)

사용법:

~/scripts/utilities/cleanup_runner_cache.sh

Cron: 매일 03:30 자동 실행

`cleanup_automation_logs.sh`

용도: 자동화 로그 정리

정리 대상: ~/logs/automation/ 디렉터리의 30일 이상 된 로그 파일

사용법:

~/scripts/utilities/cleanup_automation_logs.sh

Cron: 매주 일요일 04:00 자동 실행

`cleanup_archive_backups.sh`

용도: Archive 백업 파일 정리

정리 대상: ~/scripts/archive/ 디렉터리의 *.sh.backup.* 파일 (30일 이상)

사용법:

~/scripts/utilities/cleanup_archive_backups.sh

Cron: 매주 일요일 05:00 자동 실행

기타

`archive_reports.sh`

용도: 오래된 보고서 압축 아카이브

대상: ~/reports/ 디렉터리의 .md 파일 (14일 이상)

저장 위치: ~/reports/archive/ (gzip 압축)

사용법:

~/scripts/utilities/archive_reports.sh

Cron: 매주 일요일 03:15 자동 실행

`docker_cleanup_and_update.sh`

용도: Docker 리소스 정리 및 시스템 업데이트

기능: - 사용하지 않는 Docker 이미지 정리 - 사용하지 않는 Docker 컨테이너 정리 - 사용하지 않는 Docker 볼륨 정리 - 사용하지 않는 Docker 네트워크 정리 - 시스템 패키지 업데이트

사용법:

~/scripts/utilities/docker_cleanup_and_update.sh

`remove_password_hardcoding.sh`

용도: 스크립트에서 비밀번호 하드코딩 제거

기능: - ~/scripts/utilities/ 디렉터리의 스크립트 검사 - 비밀번호 하드코딩 발견 시 [REDACTED]로 변경 - ~/.env_secrets 파일 사용 권장

사용법:

~/scripts/utilities/remove_password_hardcoding.sh

💾 백업 스크립트 (`~/scripts/`)

`backup_all.sh`

용도: 전체 백업 마스터 스크립트

백업 대상: 1. Nextcloud 데이터 2. PostgreSQL 데이터베이스 3. Nginx 설정 4. SSL 인증서

사용법:

~/scripts/backup_all.sh

Cron: 매일 02:00 자동 실행

로그: /mnt/HDD500GB/backups/backup.log

`backup_nextcloud.sh`

용도: Nextcloud 데이터 백업

백업 대상: /DATA/AppData/big-bear-nextcloud/

저장 위치: /mnt/HDD500GB/backups/nextcloud/

파일명 형식: nextcloud_backup_YYYYMMDD_HHMMSS.tar.gz

사용법:

~/scripts/backup_nextcloud.sh

`backup_postgresql.sh`

용도: PostgreSQL 데이터베이스 백업

백업 대상: db-nextcloud 컨테이너의 모든 데이터베이스

저장 위치: /mnt/HDD500GB/backups/postgresql/

파일명 형식: postgresql_backup_YYYYMMDD_HHMMSS.sql.gz

사용법:

~/scripts/backup_postgresql.sh

`backup_nginx.sh`

용도: Nginx 설정 백업

백업 대상: /etc/nginx/

저장 위치: /mnt/HDD500GB/backups/nginx/

파일명 형식: nginx_backup_YYYYMMDD_HHMMSS.tar.gz

사용법:

~/scripts/backup_nginx.sh

`backup_ssl.sh`

용도: SSL 인증서 백업

백업 대상: /etc/letsencrypt/

저장 위치: /mnt/HDD500GB/backups/ssl/

파일명 형식: ssl_backup_YYYYMMDD_HHMMSS.tar.gz

사용법:

~/scripts/backup_ssl.sh

🔄 복원 스크립트 (`~/scripts/`)

`restore_nextcloud.sh`

용도: Nextcloud 데이터 복원

사용법:

# 복원할 백업 파일 선택
~/scripts/restore_nextcloud.sh

주의사항: 복원 전에 현재 데이터를 백업하는 것을 권장합니다.

`restore_postgresql.sh`

용도: PostgreSQL 데이터베이스 복원

사용법:

# 복원할 백업 파일 선택
~/scripts/restore_postgresql.sh

주의사항: 복원 전에 현재 데이터베이스를 백업하는 것을 권장합니다.

📦 Archive 스크립트 (`~/scripts/archive/`)

Archive 디렉터리에는 한 번 사용한 스크립트들이 보관되어 있습니다. (32개)

주요 카테고리: - Nextcloud 설정 관련 - Portainer 설정 관련 - DNS/SSL 설정 관련 - 시스템 초기 설정 관련

이 스크립트들은 참고용으로 보관되며, 필요시 수정하여 재사용할 수 있습니다.

🔐 환경 변수

`~/.env_secrets`

용도: 비밀번호 등 환경 변수 저장

내용:

export SUDO_PASSWORD="your_password"

권한: 600 (소유자만 읽기/쓰기)

주의: 이 파일은 절대 Git에 커밋하지 마세요!

📝 로그 파일

모든 자동화 스크립트의 로그는 ~/logs/automation/ 디렉터리에 저장됩니다.

로그 파일 목록: - backup_all.log - 전체 백업 로그 - archive_reports.log - 보고서 아카이브 로그 - cleanup_runner_cache.log - Runner 캐시 정리 로그 - backup_env_secrets.log - 환경 변수 백업 로그 - cleanup_automation_logs.log - 자동화 로그 정리 로그 - cleanup_archive_backups.log - Archive 백업 정리 로그 - cleanup_cursor_cache.log - Cursor 캐시 정리 로그 - cleanup_pip_cache.log - pip 캐시 정리 로그

🚀 스크립트 작성 가이드

새로운 스크립트를 작성할 때 다음 사항을 준수하세요:

헤더 주석: 스크립트 용도 및 사용법 명시
에러 처리: set -e 또는 적절한 에러 처리
로그 기록: ~/logs/automation/ 디렉터리에 로그 저장
비밀번호 하드코딩 금지: ~/.env_secrets 파일 사용
권한 설정: 실행 권한 부여 (chmod +x)

템플릿:

#!/bin/bash
# 스크립트 설명

set -e

LOG_FILE="$HOME/logs/automation/script_name.log"
mkdir -p "$(dirname "$LOG_FILE")"

echo "[$(date '+%Y-%m-%d %H:%M:%S')] 스크립트 시작" | tee -a "$LOG_FILE"

# 스크립트 내용

echo "[$(date '+%Y-%m-%d %H:%M:%S')] 스크립트 완료" | tee -a "$LOG_FILE"

문서 자동 업데이트: 이 문서는 ~/scripts/utilities/update_documentation.sh 스크립트에 의해 자동으로 업데이트됩니다.

스크립트 상세 설명

📁 스크립트 디렉터리 구조

🔧 유틸리티 스크립트 (~/scripts/utilities/)

시스템 점검

full_system_refactoring_check_v2.sh

백업 관련

backup_sensitive_files.sh

backup_env_secrets.sh

정리 작업

cleanup_pip_cache.sh

cleanup_cursor_cache.sh

cleanup_runner_cache.sh

cleanup_automation_logs.sh

cleanup_archive_backups.sh

기타

archive_reports.sh

docker_cleanup_and_update.sh

remove_password_hardcoding.sh

💾 백업 스크립트 (~/scripts/)

backup_all.sh

backup_nextcloud.sh

backup_postgresql.sh

backup_nginx.sh

backup_ssl.sh

🔄 복원 스크립트 (~/scripts/)

restore_nextcloud.sh

restore_postgresql.sh

📦 Archive 스크립트 (~/scripts/archive/)

🔐 환경 변수

~/.env_secrets

📝 로그 파일

🚀 스크립트 작성 가이드

🔧 유틸리티 스크립트 (`~/scripts/utilities/`)

`full_system_refactoring_check_v2.sh`

`backup_sensitive_files.sh`

`backup_env_secrets.sh`

`cleanup_pip_cache.sh`

`cleanup_cursor_cache.sh`

`cleanup_runner_cache.sh`

`cleanup_automation_logs.sh`

`cleanup_archive_backups.sh`

`archive_reports.sh`

`docker_cleanup_and_update.sh`

`remove_password_hardcoding.sh`

💾 백업 스크립트 (`~/scripts/`)

`backup_all.sh`

`backup_nextcloud.sh`

`backup_postgresql.sh`

`backup_nginx.sh`

`backup_ssl.sh`

🔄 복원 스크립트 (`~/scripts/`)

`restore_nextcloud.sh`

`restore_postgresql.sh`

📦 Archive 스크립트 (`~/scripts/archive/`)

`~/.env_secrets`