1. 먼저 백업하기 (필수)
업그레이드 전 전체 백업을 꼭 하세요:
sudo cp -a /var/www/html/dokuwiki /home/pi/dokuwiki_backup_$(date +%Y%m%d)

2. 최신 버전 다운로드

공식 사이트 또는 명령어로 다운로드합니다:
cd /tmp
wget https://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz

📌 3. 압축 해제
tar -xvzf dokuwiki-stable.tgz
cd dokuwiki-*

📌 4. 기존 설치 디렉토리에 덮어쓰기
sudo cp -r * /var/www/html/dokuwiki/

단, 아래 디렉토리는 덮어쓰면 안 됩니다:

• conf/

• data/

• lib/plugins/ (특히 외부 플러그인 사용 중이라면)

• lib/tpl/ (사용자 정의 테마라면)

따라서 rsync를 추천합니다:

sudo rsync -av --exclude=data --exclude=conf --exclude=lib/plugins --exclude=lib/tpl ./ /var/www/html/dokuwiki/

📌 5. 권한 재설정
sudo chown -R www-data:www-data /var/www/html/dokuwiki

6. 설치 후 확인

웹브라우저에서 DokuWiki 메인 페이지 접속 → 버전 확인
하단에 "2025-05-14a 'Librarian'"이 표시되면 성공입니다.

2. AdGuard Home 설치

설치 후, 웹 GUI 주소는:

• http://<라즈베리파이 IP>:3000

초기 설정 마법사를 통해 관리자 계정과 포트 등을 설정하세요.

전체 구성도

]]> https://korduck.duckdns.org/288/feed/ 0 https://korduck.duckdns.org/272/ https://korduck.duckdns.org/272/#respond Wed, 09 Apr 2025 00:00:31 +0000 https://korduck.duckdns.org/?p=272 더 읽기]]> 1. zram-tools 설치

2. 기본 설정 확인 및 편집 (선택 사항)

zram-tools는 /etc/default/zramswap 파일을 설정파일로 사용합니다.

기본 설정은 다음과 비슷할 수 있습니다:

권장 설정:

• ALGO=zstd: 속도와 압축률의 균형이 좋음

• PERCENT=50 또는 75: 램의 절반 또는 3/4만큼 zram 생성

• PRIORITY=100: swap 우선순위 설정

3. 서비스 시작 및 부팅 시 자동 실행

4. 동작 확인

예시 출력:

또는 free -h 명령으로 swap이 활성화된 것 확인 가능.

참고 팁

• zram은 기존 SD카드 기반 swap보다 훨씬 빠르며 수명에도 유리합니다.

• dphys-swapfile 같은 기존 swap 관리 시스템은 비활성화하는 것을 추천합니다:

1. 기존 zram 정리 및 비활성화

디바이스 번호는 사용 중인 수만큼 반복해주세요 (zram0, zram1, …)

2. 설정 파일 제거

3. zram-tools 패키지 제거

4. 재부팅 (깨끗한 상태로 만들기 위해)

5. zram 재설치

6. 설정 파일 작성

예시 설정 (4GB RAM 기준):

7. 서비스 시작 및 활성화

8. 정상 동작 확인

/etc/dnsmasq.conf에 추가:

]]> https://korduck.duckdns.org/253/feed/ 0 https://korduck.duckdns.org/248/ https://korduck.duckdns.org/248/#comments Thu, 27 Mar 2025 03:13:33 +0000 https://korduck.duckdns.org/?p=248 더 읽기]]> 1. Apache Reverse Proxy 개념

Apache의 mod_proxy 모듈을 이용하면, HTTP 사이트를 HTTPS로 변환하여 Nextcloud에서 안전하게 iframe으로 표시할 수 있습니다.

• 외부 HTTP 사이트 → Apache Reverse Proxy → HTTPS 변환 후 Nextcloud에 제공

• 이 방식은 브라우저의 Mixed Content Policy 문제를 해결하고, HTTPS 환경에서 안전하게 iframe을 사용할 수 있도록 도와줍니다.

2. Apache Reverse Proxy 설정 방법

1) Apache에 Reverse Proxy 모듈 활성화

Ubuntu/Debian 기준으로 아래 명령어를 실행하여 Proxy 관련 모듈을 활성화합니다.

모듈을 활성화한 후 Apache를 재시작합니다.

2) Virtual Host 파일 설정 (Reverse Proxy 구성)

이제 Reverse Proxy를 설정할 가상 호스트 파일을 생성 및 수정합니다.

1. /etc/apache2/sites-available/reverse-proxy.conf 파일을 만듭니다.

2. 다음 내용을 추가합니다.

   • your-nextcloud.com → Nextcloud의 도메인

   • proxy.your-nextcloud.com → Reverse Proxy로 사용할 서브도메인

   • http://your-external-site.com → iframe으로 표시할 HTTP 사이트

설정 설명

• ProxyPass와 ProxyPassReverse를 이용해 HTTP 사이트를 HTTPS로 변환

• X-Frame-Options "SAMEORIGIN" → Nextcloud에서 iframe으로 로드 가능하게 설정

• Content-Security-Policy → iframe에서 표시할 도메인 제한

3) Reverse Proxy 설정 적용

1. 가상 호스트 활성화

2. Apache 설정 오류 확인

"Syntax OK" 메시지가 나오면 설정이 정상입니다.

3. Apache 재시작

4) Nextcloud의 External Sites에 추가

이제 Nextcloud에서 External Sites 앱을 이용하여 iframe을 추가할 때,
기존 HTTP 사이트 대신 https://proxy.your-nextcloud.com/을 입력하면 됩니다.

예제

• 기존: http://your-external-site.com

• 변경 후: https://proxy.your-nextcloud.com

이제 Nextcloud에서 iframe으로 안전하게 표시될 것입니다.

추가 설정 (선택 사항)

1⃣ 만약 HTTP로 접근이 가능해야 한다면?

HTTPS가 아닌 HTTP에서도 프록시가 동작하도록 하려면, 다음 설정을 /etc/apache2/sites-available/reverse-proxy.conf에 추가하세요.

이렇게 하면 HTTP로 접근해도 자동으로 HTTPS로 리디렉트됩니다.

1⃣ 현재 SSL 인증서 확인

먼저 현재 설정된 인증서를 확인합니다.

출력 예시 (정상적인 경우)

출력 예시 (잘못된 경우, 다른 도메인일 때)

이 경우, SSL 인증서가 proxy.korduck.duckdns.org에 대해 발급되지 않았기 때문에 새로 발급해야 합니다.

2⃣ Let’s Encrypt 인증서 갱신 (재발급)

1. 기존 인증서 삭제

2. 새로운 인증서 발급

발급이 성공하면 다음과 같은 메시지가 나와야 함

3. Apache 설정 업데이트

설정 확인

4. Apache 재시작

3⃣ 올바른 인증서가 적용되었는지 다시 확인

출력이 다음과 같으면 정상 작동

이제 다시 브라우저에서 https://proxy.korduck.duckdns.org 접속 테스트하거나,

실행하여 HTTP 200 응답이 오는지 확인하세요.

2⃣ 새로운 도메인(proxy.korduck.duckdns.org)으로 SSL 인증서 갱신

방법 1: 기존 도메인 + 새로운 도메인 함께 인증

이렇게 하면 하나의 인증서에 두 개의 도메인이 포함됨.

또는,

방법 2: 기존 인증서 삭제 후 새로운 도메인만 인증

3⃣ Apache/Nginx SSL 설정 수정

변경해야 할 부분

저장 후 Apache 재시작

먼저, 라즈베리파이의 패키지를 최신 상태로 유지하는 것이 중요해.

2. 필요한 패키지 설치

DokuWiki는 PHP 기반이므로, 웹 서버(Apache 또는 Nginx)와 PHP가 필요해.

(1) Apache + PHP 설치

설치 후, Apache를 시작하고 자동 실행되도록 설정:

1⃣ Apache에서 PHP 모듈이 활성화되지 않음

먼저, PHP가 제대로 설치되고 Apache에서 활성화되었는지 확인해 보자.

위 명령어를 실행했을 때 PHP 버전이 출력되지 않으면 PHP가 설치되지 않은 것이야.
설치하려면 다음 명령을 실행하면 돼.

설치 후 PHP 모듈을 활성화하고 Apache를 다시 시작:

<LocationMatch "/(data|conf|bin|inc|vendor)/">
    Order allow,deny
    Deny from all
    Satisfy All
</LocationMatch>

Prometheus → 데이터를 수집하고 저장
Node Exporter → 라즈베리파이의 CPU, 메모리, 네트워크, 디스크 상태를 Prometheus로 전송
Grafana → Prometheus에서 데이터를 가져와 웹 대시보드로 시각화

2. 설치 및 설정

(1) Prometheus 설치 (라즈베리파이에서 실행)

설치 확인:

prometheus, version 2.x.x 확인되면 정상 설치됨

(2) Node Exporter 설치 (라즈베리파이 모니터링용)

CPU, 메모리, 디스크, 네트워크 데이터를 수집하는 Exporter

Node Exporter 실행 및 자동 시작 설정

실행 확인:

(3) Prometheus 설정 변경 (Node Exporter 연결)

설정 파일 /etc/prometheus/prometheus.yml 수정:

기본 설정에서 scrape_configs 섹션을 아래처럼 수정:

localhost:9100 → Node Exporter가 실행 중인 포트

설정 적용을 위해 Prometheus 재시작:

http://라즈베리파이IP:9090에 접속하여 Prometheus 웹 UI 확인 가능

(4) Grafana 설치 및 설정

Grafana 설치

설치 확인:

Grafana 실행 및 자동 시작 설정

http://라즈베리파이IP:3000으로 접속하면 Grafana 로그인 화면 확인 가능
기본 계정:

• 아이디: admin
• 비밀번호: admin (첫 로그인 시 변경해야 함)

3. Grafana에서 Prometheus 데이터 연동

1⃣ Grafana에 로그인 후 “Add Data Source” 클릭
2⃣ “Prometheus” 선택
3⃣ URL에 http://localhost:9090 입력 후 “Save & Test” 클릭
4⃣ 데이터가 정상적으로 수집되면 성공 메시지 확인

4. Grafana 대시보드 추가

(1) 기본 Node Exporter 대시보드 가져오기

1⃣ Grafana → “Create” → “Import” 클릭
2⃣ “Dashboard ID”에 1860 입력 후 “Load” 클릭
3⃣ “Prometheus Data Source”를 선택한 후 “Import” 클릭
4⃣ CPU, 메모리, 디스크, 네트워크 사용량을 실시간 대시보드에서 확인 가능!

http://라즈베리파이IP:3000에서 대시보드 확인 가능

라즈베리파이에서 grafana 패키지를 찾을 수 없는 경우, 공식 Grafana 저장소를 추가해야 합니다.
아래 단계에 따라 Grafana를 올바르게 설치해보세요.

1. APT 저장소 업데이트

먼저 시스템 패키지를 업데이트하세요.

2. Grafana 공식 저장소 추가

Debian 계열(라즈비안 포함)에서 Grafana를 설치하려면 공식 패키지 저장소를 추가해야 합니다.

(1) GPG 키 추가

(2) 저장소 추가 (Stable 버전)

3. 패키지 목록 업데이트 및 Grafana 설치

grafana-server --version 실행하여 버전 확인 가능

4. Grafana 실행 및 부팅 시 자동 실행 설정

http://라즈베리파이IP:3000으로 접속하여 정상 작동하는지 확인하세요.

먼저 docker ps 명령어로 OpenProject 컨테이너가 실행 중인지 확인하세요.

출력 예시:

2. 포트가 제대로 열려 있는지 확인

호스트에서 OpenProject 컨테이너의 포트가 정상적으로 열려 있는지 확인합니다.

또는

출력 예시:

1. OpenProject 환경 변수 확인

먼저, OpenProject 컨테이너의 환경 변수를 확인하세요.

출력 결과 예시:

해결 방법:
만약 OPENPROJECT_HTTPS=true로 설정되어 있다면, 이를 비활성화해야 합니다.

환경 변수 수정 방법 (docker-compose.yml 확인 & 수정)

아래 항목을 찾아서 수정하세요.

수정 전 (문제의 원인)

수정 후 (HTTPS 강제 리디렉션 해제)

수정 후 컨테이너 재시작

이제 다시 HTTP로 접속(http://172.18.0.2) 해보세요.

2. 브라우저 캐시 및 HSTS 문제 해결

한 번이라도 HTTPS로 리디렉션되었을 경우, 브라우저가 이를 기억(HSTS)하여 계속 HTTPS로 접근할 수 있습니다.

해결 방법:

1. 브라우저 강제 새로고침:
   • Ctrl + Shift + R 또는 Cmd + Shift + R (Mac)
2. 브라우저 캐시 삭제
   • Ctrl + Shift + Del을 눌러 캐시 삭제 후 다시 시도
3. HSTS 설정 초기화 (Chrome 기준)
   • chrome://net-internals/#hsts 접속
   • Delete domain security policies에서 172.18.0.2 입력 후 삭제

이후 http://172.18.0.2로 다시 접속을 시도하세요.

1-1. 라즈베리파이 환경 확인

출력 결과가 aarch64라면 64비트 OS를 사용 중이며, armv7l이면 32비트 OS입니다. OpenProject는 64비트 ARM 환경에서만 동작하므로, 32비트 OS를 사용 중이라면 64비트 OS(Raspberry Pi OS 64-bit)로 교체하세요.

1-2. Docker 및 Docker Compose 설치

Docker 설치

설치 확인:

Docker Compose 설치

2. OpenProject 설치

2-1. Docker Compose 파일 생성

설치할 폴더로 이동하고, docker-compose.yml 파일을 생성합니다.

다음 내용을 복사하여 붙여넣습니다.

주의: openproject/community:12는 arm64에서 실행이 가능한 최신 버전입니다.
SECRET_KEY_BASE는 임의의 문자열을 넣어주세요. (openssl rand -hex 32 명령어로 생성 가능)

2-2. 컨테이너 실행

실행 확인:

4⃣ 자동 로그 관리

자동으로 로그를 관리하려면 logrotate 외에도, cron을 활용하여 주기적으로 오래된 로그 파일을 삭제하는 스크립트를 만들 수 있습니다.

1. 크론 잡(Cron Job) 설정

/etc/cron.daily/ 폴더에 자동으로 로그를 정리하는 스크립트를 추가할 수 있습니다.

예를 들어, /etc/cron.daily/clean_old_logs라는 이름으로 로그 정리 스크립트를 작성합니다.

스크립트에 실행 권한을 추가합니다.

이렇게 설정하면 매일 오래된 로그 파일을 자동으로 삭제합니다.

2⃣ 로그 회전(Log Rotation) 설정

로그 파일이 커지지 않도록 로그 회전(log rotation)을 설정하는 것이 중요합니다. logrotate는 로그 파일을 자동으로 회전시키고 오래된 로그를 압축하거나 삭제해줍니다.

1. logrotate 기본 설정

logrotate는 일반적으로 /etc/logrotate.conf 파일을 사용하여 시스템 로그 회전 설정을 관리합니다. 개별 로그 파일에 대한 설정은 /etc/logrotate.d/ 폴더 내에서 관리됩니다.

예시:

이 설정은 /var/log/*.log 패턴에 맞는 로그 파일을 매일 회전시키고 7일간 보관한 후 압축합니다. 이와 같은 설정은 기본적으로 대부분의 시스템 로그 파일에 적용됩니다.

2. /etc/logrotate.d/에서 특정 로그 회전 설정

웹 서버, 데이터베이스, 애플리케이션 로그 등 각 서비스 별로도 세부적인 로그 회전 설정을 관리할 수 있습니다.

예를 들어, Apache 서버의 로그 회전 설정은 /etc/logrotate.d/apache2 파일에 있을 수 있습니다.