OCI Oracle Linux로
기간제 수업 자료실 만들기

oracle.com/cloud/free 에서 "Start for free" 버튼을 클릭합니다.

가입 화면에서 국가를 South Korea로 선택합니다. 이렇게 하면 나중에 서울 리전을 홈 리전으로 쓸 수 있습니다.

화면에 나오는 순서대로 이메일 인증 코드, 계정 비밀번호, 휴대폰 문자 인증을 차례로 진행합니다.

홈 리전을 고르라는 화면이 나오면 South Korea Central (Seoul)을 선택합니다.

카드 정보를 입력하고 가입을 완료하면, OCI 콘솔(관리 화면)에 로그인할 수 있게 됩니다.

OCI 콘솔 왼쪽 상단 메뉴(☰)에서 Compute → Instances로 들어가서 Create Instance를 클릭합니다.

Name 칸에 class-materials-server 처럼 알아보기 쉬운 이름을 입력합니다.

"Image and shape" 영역에서 Edit를 눌러 다음과 같이 설정합니다.

"Add SSH keys" 영역에서 Generate a key pair for me를 선택하고, Save private key 버튼으로 개인 키 파일(.key 확장자)을 다운로드합니다. 이 파일이 있어야 서버에 접속할 수 있으므로 잘 보관합니다.

나머지는 기본값 그대로 두고 화면 맨 아래 Create를 클릭합니다. 1~2분 정도 지나면 인스턴스 상태가 RUNNING으로 바뀝니다.

인스턴스 상세 화면에서 Public IP Address를 찾아 메모해 둡니다. 앞으로 이 주소로 서버에 접속합니다. (예: 132.145.xxx.xxx)

인스턴스 상세 화면에서 Primary VNIC 아래 Subnet 이름을 클릭한 뒤, Security Lists → Default Security List를 클릭합니다.

Add Ingress Rules를 클릭하고 아래와 같이 입력합니다.

같은 방식으로 규칙을 한 번 더 추가하되, Destination Port Range만 443으로 바꿔서 저장합니다. (SSH용 22번 포트는 기본값으로 이미 열려 있습니다.)

터미널을 열고 다운로드한 키 파일이 있는 폴더로 이동한 뒤 아래 명령을 실행합니다.

# 키 파일 권한을 본인만 읽을 수 있게 제한
chmod 400 ssh-key-오늘날짜.key

ssh -i ssh-key-오늘날짜.key opc@서버의_Public_IP

처음 접속하면 "계속 연결하시겠습니까? (yes/no)" 라고 물어보는데 yes를 입력하고 엔터를 누릅니다.

프롬프트가 [opc@class-materials-server ~]$ 형태로 바뀌면 접속에 성공한 것입니다. 이제부터 나오는 모든 명령어는 이 화면(서버 안)에서 입력합니다.

sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --permanent --add-service=https
sudo firewall-cmd --reload

sudo firewall-cmd --list-all

services에 http https ssh가 보이는지 확인합니다. --permanent로 추가했으므로 재부팅 후에도 유지됩니다.

sudo swapoff /.swapfile
sudo fallocate -l 2G /.swapfile
sudo chmod 600 /.swapfile
sudo mkswap -f /.swapfile
sudo swapon /.swapfile
swapon --show

기존 /.swapfile이 있는 OCI 이미지 기준입니다. 스왑 사용 중이거나 파일명이 다르면 먼저 swapon --show로 확인하세요.

sudo nice -n 19 ionice -c3 dnf \
  --setopt=ip_resolve=4 \
  --disablerepo='*' \
  --enablerepo=ol9_baseos_latest,ol9_appstream \
  install -y nginx httpd-tools policycoreutils-python-utils

sudo systemctl enable --now nginx
sudo nginx -t

브라우저에서 http://서버의_Public_IP로 접속해 기본 화면이 보이면 정상입니다.

duckdns.org에 접속해 Google/GitHub 계정으로 로그인합니다. 먼저 주황색 reCaptcha 버튼의 인증을 완료해야 domain 영역이 나타납니다. dataclass만 입력하고 add domain을 누르면 dataclass.duckdns.org가 만들어집니다.

DuckDNS 페이지의 도메인 옆 IP 입력칸에 2단계에서 메모한 Public IP를 입력하고 update ip를 클릭합니다.

브라우저에서 http://dataclass.duckdns.org로 접속했을 때 Nginx 화면이 보이면 정상입니다. 등록 직후 이름을 찾지 못하면 잠시 기다리거나 Windows에서 ipconfig /flushdns를 실행합니다.

업로드하기 전에 내 컴퓨터의 자료 폴더가 아래처럼 정리되어 있는지 확인합니다. 7개 과정 폴더가 최상위에 나란히 있어야 합니다.

내 컴퓨터의 터미널(서버 접속 전 화면)에서 아래 명령을 실행합니다. -i 뒤에는 SSH 키 파일 경로를, IP 자리에는 서버 주소를 넣습니다.

scp -i ssh-key-오늘날짜.key -r ./class-materials opc@서버의_Public_IP:/home/opc/

sudo mkdir -p /var/www/class-materials
sudo cp -a /home/opc/class-materials/. /var/www/class-materials/
sudo chown -R root:nginx /var/www/class-materials
sudo find /var/www/class-materials -type d -exec chmod 755 {} +
sudo find /var/www/class-materials -type f -exec chmod 644 {} +
sudo semanage fcontext -a -t httpd_sys_content_t '/var/www/class-materials(/.*)?'
sudo restorecon -RF /var/www/class-materials

Oracle Linux의 SELinux가 Enforcing 상태이므로 파일 권한뿐 아니라 웹 콘텐츠 컨텍스트도 설정해야 합니다.

sudo nano /usr/local/sbin/sync-course-access를 열어 다음 내용을 저장합니다.

#!/usr/bin/env bash
set -euo pipefail

DB=/etc/nginx/course-access.db
AUTH_DIR=/etc/nginx/course-auth
SUBJECTS="SQL ADSQL SQLT ADMIN BRW PTW AI"
now=$(date +%s)

install -d -o root -g nginx -m 750 "$AUTH_DIR"
touch "$DB"
chmod 600 "$DB"

# 만료된 계정은 원본 DB에서도 삭제한다.
db_tmp=$(mktemp)
trap 'rm -f "$db_tmp"' EXIT
awk -F'|' -v now="$now" 'NF == 5 && $3 > now' "$DB" > "$db_tmp"
install -o root -g root -m 600 "$db_tmp" "$DB"

for course in $SUBJECTS; do
  auth_tmp=$(mktemp "$AUTH_DIR/.${course}.XXXXXX")
  awk -F'|' -v c="$course" -v now="$now" \
    '$1 == c && $2 <= now && now < $3 { print $4 ":" $5 }' "$DB" > "$auth_tmp"
  chown root:nginx "$auth_tmp"
  chmod 640 "$auth_tmp"
  mv -f "$auth_tmp" "$AUTH_DIR/${course}.htpasswd"
done

sudo chmod 750 /usr/local/sbin/sync-course-access

sudo nano /root/create-course-access를 열어 다음 전체 내용을 저장합니다. 비밀번호 원문은 저장하지 않고 bcrypt 해시만 DB에 기록합니다.

#!/usr/bin/env bash
set -euo pipefail

DB=/etc/nginx/course-access.db
SYNC=/usr/local/sbin/sync-course-access

if [[ $EUID -ne 0 ]]; then
  echo "sudo로 실행해 주세요: sudo $0" >&2
  exit 1
fi

echo "아이디를 생성할 과목:"
echo "1. SQL"
echo "2. ADSQL"
echo "3. SQLT"
echo "4. ADMIN"
echo "5. BRW"
echo "6. PTW"
echo "7. AI"
read -r -p "번호 선택 (1-7): " course_number
case "$course_number" in
  1) course=SQL ;;
  2) course=ADSQL ;;
  3) course=SQLT ;;
  4) course=ADMIN ;;
  5) course=BRW ;;
  6) course=PTW ;;
  7) course=AI ;;
  *) echo "1~7 사이의 숫자를 입력해 주세요." >&2; exit 1 ;;
esac

read -r -p "시작 일 (YYYYMMDD): " start_input
read -r -p "종료 일 (YYYYMMDD): " end_input
read -r -p "아이디: " username
read -r -s -p "비밀번호: " password
echo
read -r -s -p "비밀번호 확인: " password_confirm
echo

if [[ ! $start_input =~ ^[0-9]{8}$ ]] || [[ ! $end_input =~ ^[0-9]{8}$ ]]; then
  echo "날짜는 YYYYMMDD 형식이어야 합니다. 예: 20260720" >&2
  exit 1
fi
start_date="${start_input:0:4}-${start_input:4:2}-${start_input:6:2}"
end_date="${end_input:0:4}-${end_input:4:2}-${end_input:6:2}"

if [[ ! $username =~ ^[A-Za-z0-9._-]{3,64}$ ]]; then
  echo "아이디는 영문, 숫자, 점, 밑줄, 하이픈으로 3~64자여야 합니다." >&2
  exit 1
fi
if (( ${#password} < 8 )); then
  echo "비밀번호는 8자 이상이어야 합니다." >&2
  exit 1
fi
if [[ $password != "$password_confirm" ]]; then
  echo "비밀번호가 일치하지 않습니다." >&2
  exit 1
fi
unset password_confirm

start_epoch=$(TZ=Asia/Seoul date -d "$start_date 00:00:00" +%s) || {
  echo "유효하지 않은 시작일입니다." >&2; exit 1;
}
expire_epoch=$(TZ=Asia/Seoul date -d "$end_date +1 day 00:00:00" +%s) || {
  echo "유효하지 않은 종료일입니다." >&2; exit 1;
}
if (( expire_epoch <= start_epoch )); then
  echo "종료일은 시작일보다 빠를 수 없습니다." >&2
  exit 1
fi

entry=$(htpasswd -nbB "$username" "$password")
hash=${entry#*:}
unset password entry

if [[ ! -e $DB ]]; then
  install -o root -g root -m 600 /dev/null "$DB"
fi
tmp=$(mktemp)
trap 'rm -f "$tmp"' EXIT
awk -F'|' -v c="$course" -v u="$username" \
  '!( $1 == c && $4 == u )' "$DB" > "$tmp"
printf '%s|%s|%s|%s|%s\n' \
  "$course" "$start_epoch" "$expire_epoch" "$username" "$hash" >> "$tmp"
install -o root -g root -m 600 "$tmp" "$DB"

"$SYNC"

echo "계정 등록 완료"
echo "과목: $course"
echo "아이디: $username"
echo "활성 기간: $start_date 00:00 ~ $end_date 23:59 (Asia/Seoul)"

sudo chmod 700 /root/create-course-access
sudo bash -n /root/create-course-access

/etc/systemd/system/course-access-sync.service:

[Unit]
Description=Synchronize active Nginx course accounts

[Service]
Type=oneshot
ExecStart=/usr/local/sbin/sync-course-access

/etc/systemd/system/course-access-sync.timer:

[Unit]
Description=Refresh course access accounts every minute

[Timer]
OnCalendar=*-*-* *:*:00
Persistent=true
AccuracySec=5s

[Install]
WantedBy=timers.target

sudo /usr/local/sbin/sync-course-access
sudo systemctl daemon-reload
sudo systemctl enable --now course-access-sync.timer
systemctl list-timers course-access-sync.timer

sudo /root/create-course-access

과정 번호, 20260720 형식의 시작일·종료일, 아이디, 비밀번호와 비밀번호 확인을 입력합니다. 같은 과정/아이디를 다시 등록하면 기존 일정과 비밀번호가 교체됩니다.

sudo nano /etc/nginx/conf.d/class-materials.conf

Oracle Linux Nginx는 /etc/nginx/conf.d/*.conf를 자동으로 읽습니다. 아래 설정은 실제 도메인 dataclass.duckdns.org와 Public IP를 함께 받습니다.

server {
    listen 80;
    server_name dataclass.duckdns.org 서버의_Public_IP;
    root /var/www/class-materials;
    index index.html;

    location / {
        try_files $uri $uri/ =404;
    }

    location /SQL/ {
        auth_basic "SQL course materials";
        auth_basic_user_file /etc/nginx/course-auth/SQL.htpasswd;
    }

    location /ADSQL/ {
        auth_basic "ADSQL course materials";
        auth_basic_user_file /etc/nginx/course-auth/ADSQL.htpasswd;
    }

    location /SQLT/ {
        auth_basic "SQLT course materials";
        auth_basic_user_file /etc/nginx/course-auth/SQLT.htpasswd;
    }

    location /ADMIN/ {
        auth_basic "ADMIN course materials";
        auth_basic_user_file /etc/nginx/course-auth/ADMIN.htpasswd;
    }

    location /BRW/ {
        auth_basic "BRW course materials";
        auth_basic_user_file /etc/nginx/course-auth/BRW.htpasswd;
    }

    location /PTW/ {
        auth_basic "PTW course materials";
        auth_basic_user_file /etc/nginx/course-auth/PTW.htpasswd;
    }

    location /AI/ {
        auth_basic "AI course materials";
        auth_basic_user_file /etc/nginx/course-auth/AI.htpasswd;
    }
}

붙여넣은 뒤 Ctrl+O → Enter (저장) → Ctrl+X (닫기)로 빠져나옵니다.

sudo /usr/local/sbin/sync-course-access
sudo ls -l /etc/nginx/course-auth

아직 활성 계정이 없다면 7개 파일이 크기 0으로 생성되고 과목 페이지는 401로 차단됩니다.

sudo nginx -t
sudo systemctl enable --now nginx
sudo systemctl reload nginx

syntax is ok, test is successful 문구가 보이면 정상입니다.

sudo nice -n 19 ionice -c3 dnf \
  --setopt=ip_resolve=4 \
  --disablerepo='*' \
  --enablerepo=ol9_baseos_latest,ol9_appstream,ol9_developer_EPEL \
  install -y certbot python3-certbot-nginx

sudo certbot --nginx -d dataclass.duckdns.org
sudo systemctl enable --now certbot-renew.timer
sudo certbot certificates

이메일 입력과 약관 동의를 거치면 인증서를 발급받아 Nginx에 적용합니다. 이후 https://dataclass.duckdns.org로 접속할 수 있습니다.

브라우저 시크릿(비공개) 창을 열고 https://dataclass.duckdns.org로 접속합니다.

이번 설정에서는 허브 페이지(index.html) 자체는 비밀번호 없이 누구나 볼 수 있습니다. 아이디/비밀번호 창 없이 7개 과정 카드가 바로 보이면 정상입니다.

SQL / ADSQL / SQLT / ADMIN / BRW / PTW / AI 카드를 하나씩 클릭해봅니다. 이때마다 아이디/비밀번호 창이 뜹니다. 9단계에서 만든 그 과정의 계정으로만 로그인이 되는지, 다른 과정 계정으로 로그인을 시도하면 실패하는지 확인합니다. 로그인 후 각 페이지와 이미지가 정상적으로 열리는지도 함께 확인합니다.

scp -i ssh-key-오늘날짜.key ./새파일.html opc@서버IP:/home/opc/

sudo mv /home/opc/새파일.html /var/www/class-materials/SQL/
sudo chown root:nginx /var/www/class-materials/SQL/새파일.html
sudo chmod 644 /var/www/class-materials/SQL/새파일.html
sudo restorecon -F /var/www/class-materials/SQL/새파일.html

위 예시는 SQL 과정에 새 파일을 추가하는 경우입니다. 다른 과정에 추가하려면 SQL/ 자리를 해당 과정 폴더명(ADSQL/, SQLT/, ADMIN/, BRW/, PTW/, AI/ 중 하나)으로 바꿔 주세요. Nginx는 재시작할 필요 없이 파일이 바뀌면 즉시 반영됩니다. 목차 페이지(각 과정의 index.html)에 새 카드를 추가하는 것도 같은 방식으로 파일만 교체하면 됩니다.

sudo tar czf /home/opc/class-materials-backup-$(date +%Y%m%d).tar.gz \
  /var/www/class-materials \
  /etc/nginx/conf.d/class-materials.conf \
  /etc/nginx/course-access.db \
  /root/create-course-access \
  /usr/local/sbin/sync-course-access \
  /etc/systemd/system/course-access-sync.service \
  /etc/systemd/system/course-access-sync.timer

생성된 백업 파일은 scp로 관리자 PC에 내려받고 서버 외부에도 보관합니다. Let’s Encrypt 개인키는 일반 자료 백업과 분리해 보호하세요.

systemctl is-active nginx course-access-sync.timer certbot-renew.timer
sudo nginx -t
sudo journalctl -u course-access-sync.service --since today
sudo tail -n 100 /var/log/nginx/error.log
sudo certbot certificates

sudo cat /etc/nginx/course-access.db
sudo /usr/local/sbin/sync-course-access
systemctl list-timers course-access-sync.timer certbot-renew.timer

DB에는 과정, 시작 epoch, 만료 epoch, 아이디, bcrypt 해시만 저장됩니다. 비밀번호 원문은 복구할 수 없으므로 잊었다면 같은 과정/아이디로 다시 등록해 교체합니다.

Ephemeral Public IP는 Stop/Start 뒤 바뀔 수 있습니다. IP가 바뀌면 DuckDNS에서 새 IP로 update하거나 OCI Reserved Public IP 사용을 검토하세요. 예산 알림을 설정하고 부트 볼륨·백업·트래픽 등 무료 한도 밖 자원이 생기지 않았는지 정기적으로 확인합니다.