휴고 블로그 서버 구축 가이드 (초보자용)

hugo version

sudo snap install hugo --channel=extended

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

#!/bin/bash
# 빌드 결과를 화면에도 보여주고, 로그 파일에도 같이 남긴다 (나중에 로그 대시보드에서 확인하기 위함)
LOGFILE=/home/master/hugo-build.log
{
  echo "===== Build started: $(date '+%Y-%m-%d %H:%M:%S') ====="
  # public/resources를 매번 지우고 새로 빌드해야, 옛날 CSS/이미지 캐시 때문에
  # "분명 고쳤는데 안 바뀐다" 같은 문제가 안 생긴다
  rm -rf ~/blog.snsoz.com/public ~/blog.snsoz.com/resources
  cd ~/blog.snsoz.com
  hugo
  # nginx(웹서버)가 파일을 읽을 수 있도록 소유권/권한 정리
  sudo chown -R master:www-data ~/blog.snsoz.com/public
  chmod -R 755 ~/blog.snsoz.com/public
  echo "✅ Hugo build complete. $(date '+%Y-%m-%d %H:%M:%S')"
} 2>&1 | tee -a "$LOGFILE"

/usr/local/bin/hugo.sh

cd ~/blog.snsoz.com

# 기존 테마 삭제
rm -rf themes/FixIt

# Congo 설치 (git submodule 방식 — 테마 자체를 별도 git 저장소로 관리)
git submodule add -b stable https://github.com/jpanther/congo.git themes/congo
git submodule update --init --recursive

mkdir -p config/_default
cp -r themes/congo/exampleSite/config/_default/* config/_default/

mkdir -p ~/blog.snsoz.com/layouts/shortcodes
nano ~/blog.snsoz.com/layouts/shortcodes/admonition.html

nano ~/blog.snsoz.com/layouts/shortcodes/figure.html

nano ~/blog.snsoz.com/layouts/partials/extend-footer.html

# 공식 설치 스크립트 실행 (단일 실행파일이 /usr/local/bin에 설치됨)
curl -fsSL https://raw.githubusercontent.com/filebrowser/get/master/get.sh | bash

sudo nano /etc/systemd/system/filebrowser.service

[Unit]
Description=File Browser
After=network.target

[Service]
User=master
# -r / : 탐색 시작 폴더 (전체 서버를 다 보이게 하려면 /, 특정 폴더만 보이게 하려면 그 경로)
# -a 127.0.0.1 : 외부에서 직접 접근 못 하게, 이 서버 내부에서만 열리게 함 (안전장치)
# -p 8080 : 내부적으로 쓰는 포트 번호
ExecStart=/usr/local/bin/filebrowser -r / -a 127.0.0.1 -p 8080 -d /home/master/filebrowser.db
Restart=always

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable --now filebrowser

sudo nano /etc/nginx/sites-available/files.snsoz.com

server {
    listen 80;
    server_name files.snsoz.com;

    location / {
        # 이 서버로 들어온 요청을 그대로 내부 8080 포트(File Browser)로 전달
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

# 심볼릭 링크로 활성화
sudo ln -s /etc/nginx/sites-available/files.snsoz.com /etc/nginx/sites-enabled/
# 문법 오류 있는지 먼저 검사 (틀린 설정으로 nginx 껐다 켜면 사이트 전체가 죽을 수 있어서 꼭 먼저 확인)
sudo nginx -t
sudo systemctl reload nginx

# DNS(files.snsoz.com → 이 서버 IP)가 먼저 연결되어 있어야 성공함
sudo certbot --nginx -d files.snsoz.com

sudo mkdir -p /opt/hugodash
sudo chown master:master /opt/hugodash
nano /opt/hugodash/index.php

<?php
// 어떤 로그를 보여줄지 목록으로 미리 정의해둠
$logs = [
  'nginx_access' => ['label' => 'Nginx 접속 로그', 'type' => 'file', 'path' => '/var/log/nginx/access.log'],
  'nginx_error'  => ['label' => 'Nginx 에러 로그', 'type' => 'file', 'path' => '/var/log/nginx/error.log'],
  'hugo_build'   => ['label' => 'Hugo 빌드 로그', 'type' => 'file', 'path' => '/home/master/hugo-build.log'],
  'letsencrypt'  => ['label' => 'SSL 인증서(Certbot) 로그', 'type' => 'file', 'path' => '/var/log/letsencrypt/letsencrypt.log'],
  'nginx_status' => ['label' => 'Nginx 서비스 상태', 'type' => 'journal', 'unit' => 'nginx'],
  'filebrowser_status' => ['label' => 'File Browser 서비스 상태', 'type' => 'journal', 'unit' => 'filebrowser'],
];

// 파일 로그는 tail 명령으로 마지막 500줄만, journal 로그는 journalctl로 최근 200줄만 읽음
// (전체를 다 읽으면 느리고, 어차피 최근 기록이 제일 중요하므로)

function highlightLog($text) {
  // 에러 흔적이 전혀 없으면 굳이 빈 화면 대신 "이상 없음" 메시지를 보여줌
  if (trim($text) === '') {
    return '<span class="log-ok">✅ 최근 에러/기록 없음</span>';
  }
  $text = htmlspecialchars($text); // HTML 특수문자 깨짐 방지
  $lines = explode("\n", $text);
  foreach ($lines as &$line) {
    // error, denied, failed, 5xx 상태코드 → 빨간 배경
    if (preg_match('/\b(error|denied|failed|stopped|terminated|crit|fatal)\b/i', $line)
        || preg_match('/" (5\d\d) /', $line)) {
      $line = '<span class="log-err">' . $line . '</span>';
    // warn, 4xx 상태코드 → 주황 배경
    } elseif (preg_match('/\b(warn|warning)\b/i', $line)
        || preg_match('/" (4\d\d) /', $line)) {
      $line = '<span class="log-warn">' . $line . '</span>';
    }
  }
  return implode("\n", $lines);
}

<script>
  // 페이지 열릴 때, 저장된 테마가 있으면 그걸로, 없으면 dark를 기본값으로 적용
  (function() {
    var saved = localStorage.getItem('dashTheme') || 'dark';
    document.documentElement.setAttribute('data-theme', saved);
  })();
  function toggleTheme() {
    var cur = document.documentElement.getAttribute('data-theme');
    var next = cur === 'dark' ? 'light' : 'dark';
    document.documentElement.setAttribute('data-theme', next);
    localStorage.setItem('dashTheme', next); // 다음 방문 때도 기억하도록 저장
  }
</script>

sudo nano /etc/systemd/system/hugodash.service

[Unit]
Description=Hugo Server Log Dashboard
After=network.target

[Service]
User=master
WorkingDirectory=/opt/hugodash
# PHP 내장 웹서버를 8082 포트로 띄움 (내부 전용, 외부는 nginx를 거쳐야 접근 가능)
ExecStart=/usr/bin/php -S 127.0.0.1:8082 -t /opt/hugodash
Restart=always

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable --now hugodash

# apache2-utils는 이름만 apache일 뿐, htpasswd라는 비밀번호 생성 도구만 들어있는 패키지.
# 아파치 웹서버 자체가 설치되는 게 아니라서 nginx와 충돌하지 않음
sudo apt install apache2-utils -y
sudo htpasswd -c /etc/nginx/.htpasswd master

server {
    listen 80;
    server_name status.snsoz.com;

    location / {
        auth_basic "Restricted";                       # 이 두 줄이 로그인 팝업을 띄워줌
        auth_basic_user_file /etc/nginx/.htpasswd;
        proxy_pass http://127.0.0.1:8082;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

sudo ln -s /etc/nginx/sites-available/status.snsoz.com /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx
sudo certbot --nginx -d status.snsoz.com

sudo apt install acl -y
# 파일 자체를 읽을 수 있게
sudo setfacl -m u:master:r /var/log/letsencrypt/letsencrypt.log
# 폴더 자체가 잠겨있으면 파일 권한을 열어도 소용없으므로, 폴더를 "통과"할 권한도 열어줌
sudo setfacl -m u:master:x /var/log/letsencrypt/

# 1. 일단 시뮬레이션으로 뭐가 실패하는지 확인
sudo certbot renew --dry-run

# 2. 문제의 인증서가 어떤 도메인들을 포함하고, 언제 만료됐는지 확인
sudo certbot certificates | grep -A3 snsox.com

# 메일서버 쪽에서 실행 (이 블로그 서버가 아니라 메일서버 VM에서!)
sudo certbot certificates

sudo certbot delete --cert-name snsox.com

sudo certbot renew --dry-run