오픈소스 업무 도구 직접 돌려보기
팀 업무에 쓰는 오픈소스 도구를 도커로 직접 띄워 보고 확인한 기록입니다. 문서 사이트, 서비스 감시, 비밀번호 관리, 웹훅 자동화, 문서 변환, 암호화 백업, 리버스 프록시를 다룹니다.
오픈소스 업무 도구
- MkDocs Material로 팀 문서 사이트 만들기: 빌드, 엄격 모드, 로컬 미리보기
마크다운 파일 몇 개를 MkDocs Material로 정적 사이트로 빌드하고, 깨진 링크를 --strict 옵션으로 잡고, mkdocs serve로 미리 봅니다. 문서를 코드처럼 저장소에서 관리하는 방식의 최소 구성을 실행 결과로 확인합니다.
- Uptime Kuma로 서비스 상태 감시하기: 도커 실행, 감시 대상 추가, 정상과 장애 확인
오픈소스 모니터링 도구 Uptime Kuma를 도커로 localhost에만 열어 띄우고, 감시 대상 두 개를 등록해 정상(UP)과 장애(DOWN)가 각각 기록되는 것을 확인합니다. 데이터가 도커 볼륨에 남는 방식도 함께 봅니다.
- Vaultwarden으로 비밀번호 관리 서버 띄우기: 도커 실행, 상태 확인, 데이터 백업
Bitwarden과 호환되는 오픈소스 서버 Vaultwarden을 도커로 localhost에만 열어 띄우고, 상태 확인 주소와 데이터 파일을 살펴봅니다. 컨테이너를 멈추고 데이터베이스를 복사해 백업한 뒤 다시 시작해도 서버가 살아나는지 확인합니다.
- n8n으로 웹훅 자동화 만들기: 도커 실행, 워크플로 가져오기, 호출 확인
오픈소스 자동화 도구 n8n을 도커로 localhost에만 열어 띄우고, 웹훅을 받아 JSON을 돌려주는 워크플로를 명령줄로 가져와 게시합니다. 게시 전후의 차이, 재시작이 필요했던 점, 한글과 빈 입력과 GET 요청 결과를 확인합니다.
- Pandoc으로 마크다운을 Word와 HTML로 바꾸기: 한글 문서 변환 확인
마크다운 보고서를 pandoc/core 이미지로 docx와 html로 변환하고, docx를 압축 해제해 제목, 표, 굵은 글씨가 들어갔는지 확인합니다. PDF 변환은 LaTeX가 없어 실패한 결과 그대로 기록합니다.
- restic으로 암호화 백업 만들기: 증가분 저장, 복원 검증, 손상 감지까지
오픈소스 백업 도구 restic을 도커로 실행해 암호화 저장소를 만들고, 두 번째 백업에서 바뀐 부분만 저장되는지, 복원본이 원본과 같은지, 저장소 파일 일부를 일부러 망가뜨렸을 때 어떤 점검이 잡는지 확인합니다.
- Caddy 리버스 프록시에 HTTPS와 기본 인증 걸기
인증이 없는 내부 웹 서비스 앞에 Caddy를 리버스 프록시로 세워 자체 HTTPS 인증서, 기본 인증, 보안 헤더, HTTP 리다이렉트를 설정하고 curl로 하나씩 확인합니다. 인증서가 왜 브라우저에서 경고를 내는지, 뒤쪽 앱이 바깥에 열리지 않는지까지 실행해 봅니다.