Miniflux - 가볍고 빠른 RSS 리더 (Docker 설치 가이드)

한 줄 요약

Miniflux는 가볍고, 빠르고, 미니멀한 셀프호스팅 RSS 리더입니다.

왜 Miniflux인가?

개발자로서 최신 트렌드를 깊지는 않더라도 넓게는 알아야 하기에 기술 블로그 글을 시간날 때마다 읽는 편이다.

다른 RSS 리더들과 비교

Miniflux의 장점

1. 가볍고 빠르다

• Go 언어로 작성되어 메모리 사용량 최소
• 수백 개 피드도 빠르게 로딩
• NAS에서 돌려도 부담 없음

2. 깔끔한 미니멀 UI

• 불필요한 기능 없이 읽기에 집중
• 다크테마 기본 지원
• 키보드 단축키 지원 (j/k로 이동, v로 열기)

3. 반응형 웹

• 모바일에서 봐도 전혀 불편하지 않음
• 별도 앱 없이 브라우저로 사용
• PWA 지원으로 앱처럼 설치 가능

4. 다양한 연동

• Wallabag 연동 (나중에 읽기)
• Pocket, Instapaper 연동
• Webhook 지원
• Fever API 호환 (서드파티 앱 사용 가능)

Docker Compose로 설치하기

사전 준비

• Docker & Docker Compose 설치됨
• 포트 8080 사용 가능

docker-compose.yml

services:
  miniflux:
    image: miniflux/miniflux:latest
    container_name: miniflux
    ports:
      - "8080:8080"
    restart: unless-stopped
    depends_on:
      db:
        condition: service_healthy
    environment:
      - DATABASE_URL=postgres://miniflux:secret@db/miniflux?sslmode=disable
      - RUN_MIGRATIONS=1
      - CREATE_ADMIN=1
      - ADMIN_USERNAME=admin        # ⚠️ 변경하세요
      - ADMIN_PASSWORD=password     # ⚠️ 변경하세요

  db:
    image: postgres:15-alpine
    container_name: miniflux-db
    environment:
      - POSTGRES_USER=miniflux
      - POSTGRES_PASSWORD=secret    # ⚠️ 변경하세요
      - POSTGRES_DB=miniflux
    volumes:
      - miniflux-db:/var/lib/postgresql/data
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "pg_isready", "-U", "miniflux"]
      interval: 10s
      timeout: 5s
      retries: 5

volumes:
  miniflux-db:

실행

# 시작
docker compose up -d

# 로그 확인
docker compose logs -f miniflux

접속

• URL: http://서버IP:8080
• 계정: docker-compose.yml에서 설정한 값

추천 설정

1. 키보드 단축키 활성화

설정 → 키보드 단축키 활성화 체크

2. 피드 새로고침 간격

설정 → 피드 새로고침 간격을 30분~1시간으로 설정

너무 짧게 하면 일부 사이트에서 차단당할 수 있음

3. 읽기 모드 설정

• 항상 원본 콘텐츠 가져오기: 전문을 보여주지 않는 피드용
• 기본 항목 순서: 오래된 것 먼저 vs 최신 먼저

Wallabag 연동 (선택)

나중에 읽기 서비스인 Wallabag과 연동하면 유용하다.

설정 → 연동 → Wallabag에서:

1. Wallabag URL 입력
2. Client ID, Client Secret 입력
3. 사용자명, 비밀번호 입력
4. 연결 테스트

연동 후 글 목록에서 나중에 읽기 버튼이 활성화된다.

모바일에서 사용하기

방법 1: PWA 설치 (추천)

1. 모바일 브라우저로 Miniflux 접속
2. “홈 화면에 추가” 선택
3. 앱처럼 사용

방법 2: Fever API 호환 앱

Miniflux는 Fever API를 지원해서 서드파티 앱 사용 가능:

• iOS: Reeder, Unread
• Android: FeedMe, Read You

설정 → Fever API에서 활성화 후 앱에서 연결

내가 구독하는 피드들

참고용으로 내가 구독 중인 기술 블로그:

마무리

Miniflux는 “딱 필요한 기능만” 있는 RSS 리더를 원하는 분께 강력 추천한다.

• 가볍다
• 빠르다
• 셀프호스팅 가능
• 무료

미니멀한 RSS 리더를 찾는다면, Miniflux가 정답이다.