• 서버 장애의 은근한 1순위는 디스크 용량 부족입니다.
• 로그, 캐시, 오래된 백업, Docker 잔여 데이터가 단골 원인입니다.
• 임계치 초과 시 자동 정리 + 로그 기록 구조가 안전합니다.
• 삭제 전/후 용량 비교를 반드시 남겨야 합니다.
• 필요하면 시놀로지 챗/슬랙 알림까지 확장 가능합니다.

1️⃣ 문제 상황 (실제 운영에서 가장 흔한 케이스)

디스크가 100% 가까워지면 이런 일이 벌어집니다.

• 워드프레스 업로드 실패
• DB 쓰기 오류 → 서비스 중단
• 로그 기록 중단 → 원인 추적 불가
• Docker 컨테이너 갑자기 종료
• MySQL InnoDB write error

특히 무서운 건:

디스크 95% → 느려짐
100% → 바로 장애

CPU 문제보다 더 갑작스럽습니다.

2️⃣ 내 환경 (예시)

• Ubuntu 22.04
• Docker 사용
• 워드프레스 + MariaDB
• / 파티션 단일 구조
• 정기 백업 폴더 존재

※ 파티션이 분리되어 있으면 TARGET_MOUNT를 조정해야 합니다.

3️⃣ 1차 가설

느려질 때 CPU를 의심하지만,
top을 보면 CPU는 널널하고 wa(iowait)가 증가하는 경우가 많습니다.

확인 루틴:

df -h

90% 이상이면 거의 확실히 원인 후보입니다.

4️⃣ 자동 정리 전략 (안전하게)

❌ 무조건 삭제
❌ rm -rf 기반 강제 정리

실무에서 안전한 방식은 다음과 같습니다.

1. 디스크 사용량 확인
2. 임계치(예: 80%) 초과 시에만 실행
3. 삭제 목록 로그 기록
4. 정리 후 사용량 재확인
5. 로그 파일 유지

핵심은:

“정리했더니 얼마나 줄었는지” 기록하는 것

5️⃣ 자동 정리 스크립트

파일 생성:

sudo nano /usr/local/bin/disk_cleanup.sh

아래 내용 붙여넣기:

#!/bin/bash
set -eTARGET_MOUNT="/"
THRESHOLD=80LOG_DIR="/var/log/howinfo"
LOG_FILE="${LOG_DIR}/disk_cleanup.log"DAYS_LOG=14
DAYS_TMP=7
DAYS_BACKUP=30BACKUP_DIR="/backup/daily"mkdir -p "$LOG_DIR"log() {
  echo "[$(date '+%Y-%m-%d %H:%M:%S')] $1" | tee -a "$LOG_FILE"
}usage_percent() {
  df -P "$TARGET_MOUNT" | awk 'NR==2 {gsub("%","",$5); print $5}'
}log "=== 디스크 정리 시작 ==="
BEFORE=$(usage_percent)
log "정리 전 사용량: ${BEFORE}% (기준: ${THRESHOLD}%)"if [ "$BEFORE" -lt "$THRESHOLD" ]; then
  log "임계치 미만 → 정리하지 않음"
  log "=== 종료 ==="
  exit 0
filog "임계치 초과 → 정리 실행"if command -v apt-get >/dev/null 2>&1; then
  apt-get -y autoclean || true
  apt-get -y clean || true
fiif command -v journalctl >/dev/null 2>&1; then
  journalctl --vacuum-time=7d || true
fifind /var/log -type f -name "*.gz" -mtime +"$DAYS_LOG" -print -delete | tee -a "$LOG_FILE" || true
find /tmp -type f -mtime +"$DAYS_TMP" -print -delete | tee -a "$LOG_FILE" || trueif command -v docker >/dev/null 2>&1; then
  docker system prune -f || true
  docker volume prune -f || true
fiif [ -d "$BACKUP_DIR" ]; then
  find "$BACKUP_DIR" -type f -mtime +"$DAYS_BACKUP" -print -delete | tee -a "$LOG_FILE" || true
fiAFTER=$(usage_percent)
log "정리 후 사용량: ${AFTER}%"
log "=== 디스크 정리 완료 ==="

권한 부여:

sudo chmod +x /usr/local/bin/disk_cleanup.sh

6️⃣ 수동 테스트 (반드시 먼저)

sudo /usr/local/bin/disk_cleanup.sh

로그 확인:

tail -n 50 /var/log/howinfo/disk_cleanup.log

삭제 내역과 전/후 % 확인이 핵심입니다.

7️⃣ 자동 실행 (crontab)

sudo crontab -e

추가:

0 3 * * * /usr/local/bin/disk_cleanup.sh

→ 매일 새벽 3시 검사

임계치 미만이면 아무 작업도 하지 않습니다.

8️⃣ 더 안전하게 쓰는 방법

1️⃣ 드라이런 모드

삭제 대신 목록만 보기:

find /var/log -type f -name "*.gz" -mtime +14 -print

2️⃣ 임계치 조정

THRESHOLD=90

너무 자주 돌면 올려도 됩니다.

9️⃣ 재발 방지 구조 (진짜 중요)

자동 정리만으로 끝나면 안 됩니다.

✔ 디스크 80% 이상 알림 설정
✔ Docker 로그 max-size 설정
✔ 백업 보관 정책 명확화
✔ 업로드 디렉토리 주기 점검
✔ DB 용량 성장 추적

🔟 장애 사례에서 배운 교훈

• 디스크는 95%부터 체감 저하 시작
• 100% 되면 장애가 아니라 “즉시 중단”
• 자동 정리는 “응급조치”
• 근본 원인은 로그 폭증/백업 정책 부재

체크리스트

• 수동 실행 테스트 완료
• 로그 생성 확인
• 임계치 설정 확인
• crontab 등록 완료
• 다음날 자동 실행 로그 확인

확장 (선택)

원하면 아래도 추가 가능합니다.

• 사용량 85% 이상 시 시놀로지 챗 알림
• Slack Webhook 연동
• n8n으로 모니터링 + 자동 조치
• 특정 파티션 개별 감시

게시물 서버 “용량 부족” 알림 + 자동 정리까지 한 번에 구축하기이 하우인포-IT·테크에 처음 등장했습니다.

Linux 명령어에 익숙해졌다면, 이제 한 단계 올라갈 차례입니다.
요즘 서버 운영, AI, 자동화, NAS 환경에서 빠지지 않는 기술이 바로 Docker입니다.

Docker를 이해하면:

✔ 서버 세팅이 빨라지고
✔ 환경 충돌이 사라지고
✔ 자동화 구성이 쉬워지고
✔ 이식성이 극대화됩니다

이번 글에서는 직접 설치 → 실행 → 컨테이너 운영까지 실습해봅니다.

1️⃣ Docker란 무엇인가?

Docker는 컨테이너 기반 가상화 플랫폼입니다.

기존 가상머신(VM)은 OS를 통째로 올리지만,
Docker는 필요한 실행 환경만 분리해서 올립니다.

👉 가볍고 빠릅니다
👉 서버 운영에 최적화되어 있습니다

2️⃣ Docker 설치 실습 (Ubuntu 기준)

📌 1단계: 패키지 업데이트

sudo apt update

📌 2단계: Docker 설치

sudo apt install docker.io -y

📌 3단계: Docker 실행 확인

docker --version

📌 4단계: Docker 서비스 활성화

sudo systemctl enable docker
sudo systemctl start docker

상태 확인:

sudo systemctl status docker

3️⃣ 첫 번째 컨테이너 실행해보기

📌 Hello World 실행

sudo docker run hello-world

정상이라면 테스트 메시지가 출력됩니다.

👉 이 순간 Docker 엔진이 동작한 것입니다.

4️⃣ Nginx 웹서버 컨테이너 실행 실습

📌 Nginx 실행

sudo docker run -d -p 8080:80 nginx

설명:

• -d : 백그라운드 실행
• -p 8080:80 : 포트 연결
• nginx : 이미지 이름

브라우저에서 접속:

http://서버IP:8080

👉 웹서버가 바로 실행됩니다.

5️⃣ 컨테이너 관리하기

📌 실행 중 컨테이너 확인

docker ps

📌 전체 컨테이너 보기

docker ps -a

📌 컨테이너 중지

docker stop 컨테이너ID

📌 컨테이너 삭제

docker rm 컨테이너ID

6️⃣ Docker 이미지 관리

📌 이미지 목록 확인

docker images

📌 이미지 삭제

docker rmi 이미지ID

7️⃣ 실제 운영 감각 익히기 (중요)

Docker는 단순 실행이 목적이 아닙니다.

운영에서 중요한 개념:

🔹 포트 매핑

외부포트:내부포트

-p 3000:3000

🔹 볼륨 연결 (데이터 보존)

docker run -d -p 8080:80 -v /home/data:/usr/share/nginx/html nginx

👉 컨테이너 삭제해도 데이터 유지

🔹 재부팅 시 자동 실행

docker run -d --restart=always nginx

8️⃣ Docker Compose 기초 (실무 핵심)

Docker를 여러 개 운영하면 docker-compose가 필요합니다.

설치:

sudo apt install docker-compose -y

예시 docker-compose.yml

version: '3'
services:
  web:
    image: nginx
    ports:
      - "8080:80"

실행:

docker-compose up -d

👉 실무에서는 거의 이 방식으로 운영합니다.

📌 Docker를 배우면 생기는 변화

✔ 서버 세팅 시간이 획기적으로 단축
✔ 개발/운영 환경 동일화
✔ 자동화 구성 쉬워짐
✔ NAS 활용도 상승
✔ AI 모델 배포 쉬워짐

Docker는 이제 선택이 아니라 기본입니다.

게시물 Docker 기초 실습 가이드이 하우인포-IT·테크에 처음 등장했습니다.