디렉터리 구조 표

각 디렉터리 상세 설명

/

리눅스에서 모든 파일과 디렉터리는 **루트 디렉터리 /**를 기준으로 계층 구조를 갖습니다. 모든 경로는 /에서 시작하며, Windows의 C:\와 비슷한 역할을 하지만, 드라이브 개념이 없고 모든 장치가 여기 아래로 마운트됩니다.

/bin

시스템 부팅과 사용자 작업에 필수적인 기본 명령어가 저장됩니다.

예: ls, cp, mv, cat. 싱글 유저 모드에서도 실행 가능하도록 필수 명령어를 제공합니다.

• ls, cp, mv – 파일 작업
• cat, grep – 텍스트 도구
• bash – 쉘(Shell)

/boot

부팅 관련 파일이 저장됩니다.

커널 파일(이미)(vmlinuz), 초기 램디스크(initrd/initramfs), 부트로더 설정(grub.cfg) 등이 포함되어 있으며,

부트로더(GRUB)는 이 파일들을 사용해 커널을 메모리에 올립니다.

GNU GRUB(Grand Unified Bootloader), 커널 파일 – 운영체제의 심장

/dev

시스템의 장치 파일을 모아두는 디렉터리입니다.

하드디스크, 터미널, 프린터, 가상 장치 등이 모두 파일로 표현됩니다.

예: /dev/sda는 첫 번째 디스크, /dev/null은 데이터를 버리는 장치입니다.

• /dev/sda1 – 하드 드라이브 파티션
• /dev/null – 데이터를 삼켜버리는 유명한 “블랙홀”
• /dev/random – 난수 생성기

/etc

시스템의 전역 설정 파일이 있는 디렉터리입니다.

리눅스 시스템의 설정 본부입니다. 모든 설정, 규칙, 시스템 기본 설정이 이곳에 저장됩니다.

초기에는 “et cetera”(잡다한 설정) 의미였으며, 현재는 시스템 설정을 담당합니다.

예: /etc/passwd(사용자 계정), /etc/fstab(파일 시스템 마운트 정보).

• 사용자 계정 (passwd, shadow)
• 네트워크 설정 (hosts, resolv.conf)
• 서비스 설정 (SSH, Apache 등)
• 시작 스크립트 및 시스템 규칙

/home

일반 사용자들의 홈 디렉터리입니다.

각 사용자는 /home/username 디렉터리를 갖습니다.

root 계정은 /root를 사용합니다. 보안과 안정성을 위해 일반 사용자 폴더(/home)와 분리되어 있습니다.

/lib, /lib64

실행 파일이 필요로 하는 공유 라이브러리를 저장합니다.

/bin과 /sbin 프로그램들이 실행되기 위해 필요한 공통 함수들을 제공합니다.

/media

USB, CD-ROM 등 이동식 미디어를 자동 마운트하는 디렉터리입니다.

사용자가 장치를 연결하면 시스템이 /media 아래에 장치를 자동으로 연결합니다.

/mnt

관리자가 수동으로 장치를 마운트할 때 사용하는 임시 디렉터리입니다. 테스트용 외장 하드나 파티션 마운트 시 사용됩니다.

/opt

선택적 소프트웨어를 설치하는 디렉터리입니다.

표준 레이아웃을 따르지 않는 상용 프로그램이나 독립 패키지를 /opt 아래에 설치하는 방식이 일반적입니다.

/proc

가상 파일 시스템으로, 커널과 프로세스 상태 정보를 제공합니다.

/proc/cpuinfo(CPU 정보), /proc/meminfo(메모리 사용 현황)처럼 실제 파일은 없고 커널이 동적으로 생성합니다.

• /proc/cpuinfo – CPU 상세 정보
• /proc/meminfo – 메모리 사용량
• /proc/[PID]/ – 실행 중인 프로세스 정보

/root

root(관리자) 계정의 홈 디렉터리입니다. 일반 사용자 홈 디렉터리는 /home에 있습니다.

/run

실행 중 생성되는 상태 파일을 저장합니다.

예: 서비스 PID 파일, 소켓 파일, 현재 세션 정보 등…

/sbin

시스템 관리용 실행 파일을 저장합니다.

예: fsck, reboot, ifconfig. 일반 사용자는 주로 접근하지 않습니다.

• mount – 파일시스템 마운트
• iptables – 방화벽 관리

/srv

시스템에서 제공하는 서비스 데이터를 담습니다. 예: 웹 서버의 웹 페이지 데이터 /srv/www.

/sys

커널 객체 정보를 제공하는 가상 파일 시스템(sysfs)입니다.

하드웨어와 장치 드라이버 관련 정보를 확인하고 설정할 때 사용합니다.

커널 및 하드웨어 정보와 상호작용하는 더 새롭고 깔끔한 방식의 디렉토리입니다.

/tmp

임시 파일 저장소입니다.

프로그램 실행 중 생성되는 임시 데이터를 저장하며, 시스템 재부팅 시 대부분 삭제됩니다.

/usr

사용자 프로그램과 라이브러리 저장소입니다.

원래는 “user” 디렉터리였으나, 지금은 응용 프로그램, 라이브러리, 공유 데이터를 담습니다.

User System Resources의 약자로, 대부분의 프로그램이 설치되는 곳입니다.

• /usr/bin – 사용자 프로그램 (Firefox, LibreOffice 등)
• /usr/lib – 프로그램 라이브러리
• /usr/local – 사용자가 직접 설치한 커스텀 소프트웨어

/var

끊임없이 변하는 가변 데이터를 저장하는 디렉터리입니다.

로그(/var/log), 메일, 캐시, 스풀, 데이터베이스 파일 등 수시로 변경되는 데이터를 저장합니다.

• /var/log – 시스템 로그 (문제 해결의 보물창고!)
• /var/cache – 애플리케이션 캐시

/lost+found

파일 시스템 손상 복구를 위해 존재합니다. fsck 실행 시 깨진 inode나 위치를 잃은 파일을 이곳에 모아 복구 작업에 사용합니다.

The post Linux Default Directory Structure (기본 디렉터리 구조) appeared first on 어제와 내일의 나 그 사이의 이야기.

LVM의 계층 구조와 주요 개념

LVM(Logical Volume Manager)은 리눅스 및 유닉스 계열 시스템에서 사용자가 논리적인 볼륨 저장소를 설정하고 제어할 수 있도록 하는 운영 체제 명령, 라이브러리 및 도구 세트입니다. (Manager)

이는 실제 물리적 디스크와 응용 프로그램 사이에 장치 드라이버 계층을 두어, 물리적 디스크 구조와 무관하게 스토리지 공간을 논리적으로 관리할 수 있게 해줍니다.

(여러 물리적인 디스크들을 하나의 논리적인 디스크처럼 다룰 수 있게 함 – 고용량, 고속, 데이터의 무결성 등을 실현 가능)

• LVM이 필요한 이유?

기존 파티션 기반 스토리지 관리 방식은 용량 확장이나 재구성이 복잡하고 다운 타임이 발생할 수 있다.

그러나 LVM을 사용하면 하드 드라이브를 재분할할 필요 없이 논리 볼륨을 생성, 크기 조정, 이동 및 삭제할 수 있습니다.

LVM의 진정한 매력은 논리 볼륨과 볼륨 그룹의 크기를 실시간으로 조정할 수 있다는 점에 있습니다.

예를 들어) 갑자기 데이터베이스 용량 필요하다고 해도 LVM을 사용하면 운영 중단 없이 손쉽게 공간을 확장할 수 있습니다.

LVM은 하드 디스크 위에 얇은 소프트웨어 계층을 덧씌워 하드 드라이브 관리의 연속성과 편의성을 추상화한 것이라고 생각하면 될 것 같습니다.

1. 물리적 계층: PV (Physical Volume) 및 PP (Physical Partition)

PV (Physical Volume)

LVM에서 인식하는 물리적 디스크 드라이브 자체를 의미하며, AIX 시스템에서는 hdisk0, hdisk1과 같은 이름으로 표시됩니다.

하나의 PV는 반드시 하나의 VG에만 속할 수 있습니다.

PP (Physical Partition)

PV를 일정한 크기로 나눈 최소의 물리적 단위입니다.

PP의 크기는 1MB에서 1GB까지 설정 가능하며, 동일한 VG 내의 모든 PV는 동일한 크기의 PP를 가집니다.

관련 명령어

# 하드 디스크 총 개수, 파티션 수, 저장 용량 및 사용 가능 용량을 확인
- Linux
lsblk
- AIX
lsdev -Cc disk

# Physical Volumes 총 개수
- Linux
pvs
pvdisplay
- AIX
lspv
lspv hdisk0

2. 논리적 그룹 계층: VG (Volume Group)

VG (Volume Group)

하나 이상의 PV들을 논리적으로 묶은 집합체입니다.

VG 내의 디스크들은 PP라는 단위로 쪼개져 관리되며, 이를 통해 여러 물리적 디스크에 걸쳐 있는 논리적 볼륨을 생성하는 등 유연한 관리가 가능해집니다.

데이터 보호를 위해 미러링을 설정하면, 하나의 LP가 2개 또는 3개의 PP에 대응되어 동일한 데이터 사본을 여러 곳에 저장하게 됩니다.

관련 명령어

# Volume groups 확인
- Linux
vgs
vgdisplay
- AIX
lsvg
lsvg vgname

3. 논리적 할당 계층: LV (Logical Volume) 및 LP (Logical Partition) / 미러링(Mirroring)

LV (Logical Volume)

사용자가 실제 데이터를 저장하기 위해 VG 내에서 정의하는 논리적인 저장 공간입니다.

LV는 사용자에게는 연속된 공간으로 보이지만, 실제 물리적 위치(PP)는 디스크 상에서 흩어져 있거나 여러 PV에 걸쳐 있을 수 있습니다.

LP (Logical Partition)

LV를 구성하는 최소 논리 단위로, 하나 이상의 PP에 대응됩니다.

※ 참고: AIX에서는 LP/PP라는 용어를 사용하며,
Linux LVM에서는 LE/PE(Extent)라는 용어를 사용한다.

미러링(Mirroring)

데이터 보호를 위해 미러링을 설정하면, 하나의 LP가 2개 또는 3개의 PP에 대응되어 동일한 데이터 사본을 여러 곳에 저장하게 됩니다.

관련 명령어

# Logical volumes 확인
- Linux
lvs
lvdisplay
- AIX
lslv
lslv lvname

4. 계층 구조의 상위 단계: 파일 시스템(File System)

File System

LV 위에 구축되어 사용자가 실제 파일을 저장하고 접근할 수 있도록 하는 논리적인 구조입니다.

생성된 LV 위에는 JFS 또는 JFS2와 같은 파일 시스템이 구축되거나, 페이징 공간(Paging Space)으로 사용됩니다.

운영체제는 이러한 파일 시스템을 통해 파일을 저장하고 관리합니다.

주요 개념 요약

계층 구조

PV(PP) → VG → LV(LP) → 파일 시스템

유연성

LVM을 사용하면 운영 중에 파일 시스템의 용량을 늘리거나 줄이는 것이 가능하며, 
물리적인 디스크 한계를 넘어 스토리지를 효율적으로 관리할 수 있습니다

데이터 무결성

VGDA(Volume Group Descriptor Area)와 같은 영역에 LVM 구조 정보를 저장하여 관리하며, 
쿼럼(Quorum) 메커니즘을 통해 디스크 장애 시에도 데이터의 무결성을 보장합니다.

The post LVM(Logical Volume Manager) 구조 및 개념 appeared first on 어제와 내일의 나 그 사이의 이야기.

Development Tools (개발 도구 모음) ?

Linux에서 소프트웨어를 개발하고 컴파일하는 데 필요한 도구들의 패키지입니다.

예를 들어 “VMware Tools”처럼 C/C++ 소스 코드로 작성된 프로그램을 설치할 때 반드시 필요합니다.

설치 명령

rocky linux

dnf groupinstall "Development Tools" -y

// vm-tool 설치 (Rocky Linux 공식 저장소에서 설치, ISO 방식이 아님)
sudo dnf install open-vm-tools open-vm-tools-desktop -y

설치 시간 및 용량

• 예상 시간: 3-5분
• 설치 크기: ~1GB
• 필요 디스크: ~2GB

설치 결과

20260217 설치 결과는 Rocky Linux 버전 및 시간에 따라 다를 수 있습니다.

--------------

Installed:
  annobin-docs-12.99-1.el10.noarch                 annobin-plugin-gcc-12.99-1.el10.x86_64               asciidoc-10.2.0-12.el10.noarch                   autoconf-2.71-13.el10.noarch                                   
  automake-1.16.5-20.el10.noarch                   bison-3.8.2-9.el10.x86_64                            boost-atomic-1.83.0-5.el10.x86_64                boost-filesystem-1.83.0-5.el10.x86_64                          
  boost-regex-1.83.0-5.el10.x86_64                 boost-system-1.83.0-5.el10.x86_64                    boost-thread-1.83.0-5.el10.x86_64                byacc-2.0.20230521-7.el10.x86_64                               
  cmake-filesystem-3.30.5-3.el10_0.x86_64          cpp-14.3.1-2.1.el10.x86_64                           debugedit-5.1-8.el10.x86_64                      diffstat-1.66-3.el10.x86_64                                    
  docbook-dtds-1.0-92.el10.noarch                  docbook-style-xsl-1.79.2-30.el10.noarch              dwz-0.16-1.el10.x86_64                           dyninst-13.0.0-1.el10.x86_64                                   
  efi-srpm-macros-6-7.el10.noarch                  efivar-libs-39-3.el10.x86_64                         elfutils-0.193-1.el10.rocky.0.1.x86_64           elfutils-debuginfod-client-devel-0.193-1.el10.rocky.0.1.x86_64 
  elfutils-devel-0.193-1.el10.rocky.0.1.x86_64     elfutils-libelf-devel-0.193-1.el10.rocky.0.1.x86_64  flex-2.6.4-19.el10.x86_64                        fonts-srpm-macros-1:2.0.5-18.el10.noarch                       
  forge-srpm-macros-0.4.0-6.el10.noarch            gcc-14.3.1-2.1.el10.x86_64                           gcc-c++-14.3.1-2.1.el10.x86_64                   gcc-plugin-annobin-14.3.1-2.1.el10.x86_64                      
  gdb-16.3-2.el10.x86_64                           gdb-headless-16.3-2.el10.x86_64                      gettext-common-devel-0.22.5-6.el10.noarch        gettext-devel-0.22.5-6.el10.x86_64                             
  git-2.47.3-1.el10.x86_64                         git-core-2.47.3-1.el10.x86_64                        git-core-doc-2.47.3-1.el10.noarch                glibc-devel-2.39-58.el10_1.7.x86_64                            
  go-srpm-macros-3.6.0-4.el10.noarch               graphviz-9.0.0-15.el10.x86_64                        intltool-0.51.0-29.el10.noarch                   javapackages-filesystem-6.4.0-1.el10.noarch                    
  jna-5.14.0-7.el10.x86_64                         kernel-devel-6.12.0-124.35.1.el10_1.x86_64           kernel-headers-6.12.0-124.35.1.el10_1.x86_64     kernel-srpm-macros-1.0-26.el10.noarch                          
  libipt-2.1-5.el10.x86_64                         libstdc++-devel-14.3.1-2.1.el10.x86_64               libtool-2.4.7-13.el10.x86_64                     libxcrypt-devel-4.4.36-10.el10.x86_64                          
  libzstd-devel-1.5.5-9.el10.x86_64                ltrace-0.7.91-52.el10.x86_64                         lua-srpm-macros-1-15.el10.noarch                 m4-1.4.19-11.el10.x86_64                                       
  make-1:4.4.1-9.el10.x86_64                       mokutil-2:0.7.2-1.el10.x86_64                        nss-tools-3.112.0-4.el10_0.x86_64                ocaml-srpm-macros-10-4.el10.noarch                             
  openblas-srpm-macros-2-19.el10.noarch            openssl-devel-1:3.5.1-7.el10_1.x86_64                package-notes-srpm-macros-0.5-13.el10.noarch     patch-2.7.6-26.el10.x86_64                                     
  patchutils-0.4.2-15.el10.x86_64                  perl-Clone-0.46-10.el10.x86_64                       perl-Compress-Raw-Bzip2-2.212-512.el10.x86_64    perl-Compress-Raw-Zlib-2.212-513.el10_1.x86_64                 
  perl-Data-Dump-1.25-13.el10.noarch               perl-Digest-HMAC-1.04-12.el10.noarch                 perl-Digest-SHA-1:6.04-512.el10.x86_64           perl-Encode-Locale-1.05-31.el10.noarch                         
  perl-Error-1:0.17029-18.el10.noarch              perl-Fedora-VSP-0.001-36.el10.noarch                 perl-File-Compare-1.100.800-512.2.el10_0.noarch  perl-File-Copy-2.41-512.2.el10_0.noarch                        
  perl-File-Listing-6.16-5.el10.noarch             perl-Git-2.47.3-1.el10.noarch                        perl-HTML-Parser-3.82-3.el10.x86_64              perl-HTML-Tagset-3.20-59.el10.noarch                           
  perl-HTTP-Cookies-6.11-5.el10.noarch             perl-HTTP-Date-6.06-6.el10.noarch                    perl-HTTP-Message-6.45-5.el10.noarch             perl-HTTP-Negotiate-6.01-40.el10.noarch                        
  perl-I18N-Langinfo-0.24-512.2.el10_0.x86_64      perl-IO-Compress-2.212-512.el10.noarch               perl-IO-HTML-1.004-14.el10.noarch                perl-LWP-MediaTypes-6.04-19.el10.noarch                        
  perl-Module-Load-1:0.36-511.el10.noarch          perl-NTLM-1.09-41.el10.noarch                        perl-Net-HTTP-6.23-6.el10.noarch                 perl-TermReadKey-2.38-24.el10.x86_64                           
  perl-Thread-Queue-3.14-511.el10.noarch           perl-TimeDate-1:2.33-16.el10.noarch                  perl-Try-Tiny-0.31-12.el10.noarch                perl-WWW-RobotRules-6.02-41.el10.noarch                        
  perl-XML-Parser-2.47-6.el10.x86_64               perl-generators-1.16-7.el10.noarch                   perl-lib-0.65-512.2.el10_0.x86_64                perl-libwww-perl-6.76-3.el10.noarch                            
  perl-macros-4:5.40.2-512.2.el10_0.noarch         perl-srpm-macros-1-57.el10.noarch                    perl-subs-1.04-512.2.el10_0.noarch               perl-threads-1:2.40-511.el10.x86_64                            
  perl-threads-shared-1.69-511.el10.x86_64         perl-version-8:0.99.32-4.el10.x86_64                 pesign-116-6.el10.x86_64                         pyproject-srpm-macros-1.16.2-1.el10.noarch                     
  python-srpm-macros-3.12-10.el10.noarch           qt6-srpm-macros-6.9.1-1.el10.noarch                  redhat-rpm-config-293-1.el10.rocky.0.2.noarch    rpm-build-4.19.1.1-20.el10.x86_64                              
  rpm-sign-4.19.1.1-20.el10.x86_64                 rust-toolset-srpm-macros-1.88.0-1.el10.noarch        sgml-common-0.6.3-65.el10.noarch                 source-highlight-3.1.9-25.el10.x86_64                          
  systemd-rpm-macros-257-13.el10.rocky.0.1.noarch  systemtap-5.3-3b.el10.x86_64                         systemtap-client-5.3-3b.el10.x86_64              systemtap-devel-5.3-3b.el10.x86_64                             
  systemtap-runtime-5.3-3b.el10.x86_64             tbb-2021.11.0-7.el10.x86_64                          valgrind-1:3.25.1-3.el10.x86_64                  valgrind-devel-1:3.25.1-3.el10.x86_64                          
  valgrind-docs-1:3.25.1-3.el10.x86_64             valgrind-gdb-1:3.25.1-3.el10.x86_64                  valgrind-scripts-1:3.25.1-3.el10.x86_64          xz-devel-1:5.6.2-4.el10_0.x86_64                               
  zlib-ng-compat-devel-2.2.3-3.el10_1.x86_64       zstd-1.5.5-9.el10.x86_64                            

Complete!

주요 설치 파일 (C/C++ 기준)

컴파일러 (Compiler)

소스 코드(.c, .cpp) → 기계어 실행파일로 변환

gcc-14.3.1           → C 언어 컴파일러
gcc-c++-14.3.1       → C++ 언어 컴파일러

빌드 도구 (Build Tools)

컴파일러 옵션 자동 설정 / 복잡한 빌드 과정 자동화 / 어떤 파일을 먼저 컴파일할지 관리 등…

make-4.4.1           → 자동 빌드 관리
autoconf-2.71        → 자동 설정 생성
automake-1.16.5      → Makefile 자동 생성

커널 개발 패키지 (Kernel Development)

역할: 커널과 상호작용하는 모듈 작성 가능

kernel-devel-6.12.0-124.35.1
kernel-headers-6.12.0-124.35.1
-----------------------------------------------
설치 명령어
sudo dnf install kernel-devel kernel-headers -y 

라이브러리 개발 패키지 (Library Development)

역할: 컴파일된 코드를 실행 가능 파일로 연결 (링킹)

glibc-devel-2.39           → C 표준 라이브러리
libstdc++-devel-14.3.1     → C++ 표준 라이브러리
-----------------------------------------------
모든 C/C++ 프로그램의 기본 함수 제공
printf(), malloc() 등의 함수 구현

추가 개발 도구

Git: 소스 코드 변경 이력 관리, GDB: 프로그램 실행 중 오류 추적, libtool: 공유 라이브러리(.so) 빌드

git-2.47.3           → 소스 코드 버전 관리
gdb-16.3             → 프로그램 디버거
libtool-2.4.7        → 라이브러리 빌드 도구

참고 및 주의사항

groupinstall vs install

#  잘못된 방법 (의존성 부족 가능)
sudo dnf install gcc

#  올바른 방법 (모든 관련 도구 자동 설치)
sudo dnf groupinstall "Development Tools" -y

설치 확인

# 컴파일러 확인
gcc --version

# Make 확인
make --version

# 커널 헤더 확인
ls /usr/src/kernels/

오류 발생 시

네트워크 오류:

sudo dnf clean all
sudo dnf groupinstall "Development Tools" -y

의존성 충돌:

sudo dnf groupinstall "Development Tools" --allowerasing -y

The post Linux Development Tools Install appeared first on 어제와 내일의 나 그 사이의 이야기.

문제 상황

Unity 에디터의 Package Manager에서 Services Core 패키지가 빨간색 경고와 함께 “Invalid Signature” 표시

광고 초기화 실패(Gateway communication failure) 등의 문제가 발생

이는 패키지 자체의 손상이 아니라 Package Manager의 서명 검증 시스템 오류

오류의 의미와 영향

Package Manager의 서명 검증 실패

Unity Package Manager는 모든 패키지의 디지털 서명을 확인하는 검증 메커니즘을 가지고 있

“Invalid Signature”는 Package Manager의 서명 검증 로직이 정상적인 패키지를 잘못 거부하는 버그

실제 패키지는 정상이지만, Package Manager가 잘못된 판단을 내리고 있는 상태로 생각됨

Unity Ads 초기화 실패와의 연결

Services Core는 단순한 라이브러리가 아니라 Unity Ads를 포함한 모든 유니티 서비스의 핵심 패키지입니다.

이 패키지가 손상되면:

• Unity Ads 초기화 실패 Gateway communication failure 오류 발생 광고 로드 및 표시 불가 기타 Unity Services(Analytics, Crash Reporting 등) 동작 불능

해결 방법 (개인적인)

Package Manager 캐시 삭제

로컬에 저장된 손상된 패키지 캐시를 강제로 삭제

Unity 에디터를 완전히 종료합니다 다음 폴더로 이동:

• Windows: %AppData%/Local/Unity/cache/upm
• Mac: ~/Library/Caches/Unity/upm
• Linux: ~/.cache/unity/upm

upm 폴더 전체를 삭제합니다

Unity 에디터를 다시 열면 Package Manager가 서버에서 패키지를 새로 다운로드하고 서명을 다시 검증

주의: 이 작업은 안전하며, 폴더를 다시 열면 필요한 캐시가 자동으로 재생성됩니다.

Reset Packages to Defaults (마지막 수단)

프로젝트의 패키지 설정이 꼬인 경우 초기화가 필요합니다.

Unity 상단 메뉴: Help > Reset Packages to defaults 선택

확인 대화상자에서 “Yes” 클릭

프로젝트의 manifest.json이 기본값으로 되돌려집니다

주의: 이 작업은 프로젝트의 패키지 설정을 초기화하므로:

수동으로 추가했던 다른 패키지가 있다면 다시 설치해야 합니다

Packages/manifest.json 파일이 변경됩니다

The post Unity Package Manager “Invalid Signature” appeared first on 어제와 내일의 나 그 사이의 이야기.

1. 모든 데이터베이스별 총 용량 확인

현재 서버에 있는 모든 DB의 크기를 한눈에 비교하고 싶을 때 사용합니다.

용량이 큰 순서대로 정렬되어 출력됩니다.

SELECT 
    table_schema AS 'Database Name',
    ROUND(SUM(data_length + index_length) / 1024 / 1024, 2) AS 'Size (MB)',
    ROUND(SUM(data_free) / 1024 / 1024, 2) AS 'Free Space (MB)'
FROM 
    information_schema.tables
GROUP BY 
    table_schema
ORDER BY 
    (SUM(data_length + index_length)) DESC;

2. 특정 데이터베이스 내의 테이블별 용량 상세 확인

“어떤 테이블이 용량을 다 잡아먹고 있지?”라는 궁금증이 생겼을 때 사용합니다.

데이터 크기와 인덱스 크기를 구분해서 보여줍니다.

데이터 크기와 인덱스 크기를 구분

SELECT 
    table_name AS 'Table Name',
    table_rows AS 'Total Rows',
    ROUND(data_length / 1024 / 1024, 2) AS 'Data Size (MB)',
    ROUND(index_length / 1024 / 1024, 2) AS 'Index Size (MB)',
    ROUND((data_length + index_length) / 1024 / 1024, 2) AS 'Total Size (MB)'
FROM 
    information_schema.tables
WHERE 
    table_schema = '데이터베이스명' -- 여기에 DB 이름 입력
ORDER BY 
    (data_length + index_length) DESC;

3. 전체 서버의 총 합계 용량 확인

서버 전체에서 MySQL이 사용하는 총 디스크 용량만 깔끔하게 보고 싶을 때 유용합니다.

SELECT 
    ROUND(SUM(data_length + index_length) / 1024 / 1024 / 1024, 2) AS 'Total Global Size (GB)'
FROM 
    information_schema.tables;

4. 참고

• data_length: 실제 데이터가 들어있는 물리적 크기입니다.
• index_length: 인덱스(색인)가 차지하는 크기입니다. 데이터는 적은데 인덱스가 너무 크면 최적화(OPTIMIZE TABLE)를 고려해야 합니다.
• data_free: DELETE 등으로 삭제된 행이 차지하던 ‘비어있는 공간’입니다. 이 값이 너무 크면 디스크 공간 낭비가 심하다는 뜻입니다.

The post MySQL 데이터베이스 & 테이블 용량 확인 appeared first on 어제와 내일의 나 그 사이의 이야기.

MySQL 서비스 상태 확인 및 관리

# 서비스 상태 확인
sudo systemctl status mysql

# MySQL 서비스 시작
sudo systemctl start mysql

# MySQL 서비스 중지
sudo systemctl stop mysql

# MySQL 서비스 재시작
sudo systemctl restart mysql

# 부팅 시 자동 시작 설정
sudo systemctl enable mysql

# 자동 시작 해제
sudo systemctl disable mysql

MySQL 접속

로컬 접속

# root 사용자로 접속
sudo mysql -u root -p

# 특정 사용자로 접속
mysql -u username -p

# 데이터베이스 지정하여 접속
mysql -u username -p database_name

원격 접속

# 원격 서버 접속
mysql -h hostname_or_ip -u username -p

# 포트 지정 접속
mysql -h hostname_or_ip -P 3306 -u username -p

사용자 계정 관리

사용자 생성

-- 로컬 접속만 허용하는 사용자 생성
CREATE USER 'username'@'localhost' IDENTIFIED BY 'password';

-- 특정 IP에서만 접속 허용
CREATE USER 'username'@'192.168.1.100' IDENTIFIED BY 'password';

-- 특정 도메인에서만 접속 허용
CREATE USER 'username'@'%.example.com' IDENTIFIED BY 'password';

-- 모든 호스트에서 접속 허용 (보안상 주의)
CREATE USER 'username'@'%' IDENTIFIED BY 'password';

-- 패스워드 없는 사용자 생성
CREATE USER 'username'@'localhost';

사용자 목록 조회

-- 모든 사용자 조회
SELECT user, host FROM mysql.user;

-- 특정 사용자 조회
SELECT user, host FROM mysql.user WHERE user = 'username';

-- 현재 접속 중인 사용자 확인
SELECT USER();
SELECT CURRENT_USER();

-- 사용자의 권한 정보와 함께 조회
SELECT user, host, password_expired, account_locked FROM mysql.user;

사용자 삭제

-- 사용자 삭제
DROP USER 'username'@'host';

-- 여러 사용자 동시 삭제
DROP USER 'user1'@'localhost', 'user2'@'%';

-- 존재하지 않을 수도 있는 사용자 삭제 (에러 방지)
DROP USER IF EXISTS 'username'@'localhost';

계정 잠금/해제

-- 계정 잠금
ALTER USER 'username'@'host' ACCOUNT LOCK;

-- 계정 해제
ALTER USER 'username'@'host' ACCOUNT UNLOCK;

-- 잠금 상태 확인
SELECT user, host, account_locked FROM mysql.user WHERE user = 'username';

웹 애플리케이션용 사용자 생성

-- 데이터베이스 생성
CREATE DATABASE webapp_db;

-- 사용자 생성 및 권한 부여
CREATE USER 'webapp_user'@'localhost' IDENTIFIED BY 'secure_password123';
GRANT SELECT, INSERT, UPDATE, DELETE ON webapp_db.* TO 'webapp_user'@'localhost';
FLUSH PRIVILEGES;

읽기 전용 사용자 생성

-- 읽기 전용 사용자
CREATE USER 'readonly_user'@'%' IDENTIFIED BY 'readonly_password';
GRANT SELECT ON *.* TO 'readonly_user'@'%';
FLUSH PRIVILEGES;

백업 전용 사용자 생성

-- 백업 사용자 생성
CREATE USER 'backup_user'@'localhost' IDENTIFIED BY 'backup_password';
GRANT SELECT, LOCK TABLES, SHOW VIEW, EVENT, TRIGGER ON *.* TO 'backup_user'@'localhost';
FLUSH PRIVILEGES;

비밀번호 관리

비밀번호 변경

-- 현재 사용자의 비밀번호 변경
ALTER USER USER() IDENTIFIED BY 'new_password';

-- 특정 사용자의 비밀번호 변경 (MySQL 8.0 이상 권장)
ALTER USER 'username'@'host' IDENTIFIED BY 'new_password';

-- 이전 버전의 MySQL
SET PASSWORD FOR 'username'@'host' = PASSWORD('new_password');

root 비밀번호 초기화

# 1. MySQL 서비스 중지
sudo systemctl stop mysql

# 2. 권한 테이블 없이 MySQL 시작
sudo mysqld_safe --skip-grant-tables &

# 3. root로 비밀번호 없이 접속
mysql -u root

# 4. MySQL 내부에서 비밀번호 변경 (MySQL 8.0 기준)
mysql> FLUSH PRIVILEGES;
mysql> ALTER USER 'root'@'localhost' IDENTIFIED BY 'new_password';

# 5. MySQL 종료 후 정상 재시작
mysql> exit
sudo systemctl restart mysql

권한 관리

권한 부여

-- 모든 데이터베이스 목록 보기
SHOW DATABASES;

-- 특정 사용자의 권한이 있는 데이터베이스 확인
SHOW GRANTS FOR 'username'@'host';

-- 모든 데이터베이스에 모든 권한 부여
GRANT ALL PRIVILEGES ON *.* TO 'username'@'host';

-- 특정 데이터베이스에 모든 권한 부여
GRANT ALL PRIVILEGES ON database_name.* TO 'username'@'host';

-- 특정 테이블에 권한 부여
GRANT SELECT, INSERT, UPDATE ON database_name.table_name TO 'username'@'host';

-- 읽기 전용 권한
GRANT SELECT ON database_name.* TO 'username'@'host';

-- 특정 컬럼에만 권한 부여
GRANT SELECT (column1, column2) ON database_name.table_name TO 'username'@'host';

-- WITH GRANT OPTION (다른 사용자에게 권한 부여 가능)
GRANT ALL PRIVILEGES ON database_name.* TO 'username'@'host' WITH GRANT OPTION;

권한 조회

-- 특정 사용자의 권한 조회
SHOW GRANTS FOR 'username'@'host';

-- 현재 사용자의 권한 조회
SHOW GRANTS;

-- 모든 사용자의 권한 요약
SELECT user, host, Select_priv, Insert_priv, Update_priv, Delete_priv 
FROM mysql.user;

권한 제거

-- 특정 권한 제거
REVOKE INSERT, UPDATE ON database_name.* FROM 'username'@'host';

-- 모든 권한 제거
REVOKE ALL PRIVILEGES ON *.* FROM 'username'@'host';

-- GRANT OPTION 제거
REVOKE GRANT OPTION ON database_name.* FROM 'username'@'host';

권한 적용

-- 권한 변경사항 즉시 적용
-- 권한 관련 오류 시 권한 테이블 새로고침
FLUSH PRIVILEGES;

주요 권한 종류

The post MySQL 사용자 관리 명령어 (Ubuntu) appeared first on 어제와 내일의 나 그 사이의 이야기.

Nginx를 리버스 프록시로, Apache를 백엔드 웹서버로 사용하는 구성 방법

Nginx가 SSL/TLS 처리와 클라이언트 요청을 담당하고, Apache는 WordPress 애플리케이션을 실행

• Nginx:
  – 정적 파일(이미지, CSS, JS) 처리에 매우 빠르고 동시 접속 처리에 강함
  – Nginx는 Apache보다 훨씬 적은 메모리 사용
  – Nginx는 이벤트 기반 구조로 수천 개의 동시 연결을 적은 리소스로 처리
• Apache: PHP 처리와 .htaccess 지원이 우수하고, WordPress 같은 PHP 애플리케이션과 호환성이 좋음

아키텍처 구조

클라이언트 → Nginx (80/443포트) → Apache (5050포트) → WordPress
           ↓
      SSL/TLS 처리
      HTTPS 강제

1. WordPress 설정

파일 위치

wp-config.php (WordPress 루트 디렉토리)

설정 목적

Nginx 리버스 프록시 환경에서 WordPress가 HTTPS를 올바르게 인식하도록 설정

코드 추가 위치

/* That's all, stop editing! Happy blogging. */ 주석 위에 다음 코드를 추가

// Nginx 리버스 프록시 환경에서 HTTPS를 강제 인식시키는 코드
if (
    (isset($_SERVER['HTTP_X_FORWARDED_PROTO']) && $_SERVER['HTTP_X_FORWARDED_PROTO'] === 'https') ||
    (isset($_SERVER['HTTP_X_FORWARDED_SSL']) && $_SERVER['HTTP_X_FORWARDED_SSL'] === 'on')
) {
    $_SERVER['HTTPS'] = 'on';
}

설명

• Nginx가 전달하는 X-Forwarded-Proto 헤더를 확인
• HTTPS 요청임을 감지하면 $_SERVER['HTTPS']를 'on'으로 설정
• WordPress의 리다이렉트 루프 및 Mixed Content 문제 해결

2. Nginx 설정

파일 위치

/etc/nginx/sites-available/test.conf

주요 명령어

# 문법 검사
sudo nginx -t

# 설정 활성화 (심볼릭 링크 생성)
sudo ln -s /etc/nginx/sites-available/test.conf /etc/nginx/sites-enabled/

# 설정 비활성화 (심볼릭 링크 제거)
sudo rm /etc/nginx/sites-enabled/test.conf

# Nginx 상태 확인
sudo systemctl status nginx

# Nginx 재시작
sudo systemctl restart nginx

설정 구조

(1) HTTP → HTTPS 리다이렉트 (포트 80)

server {
    listen 80;
    listen [::]:80;
    server_name test.com www.test.com;

    # 모든 HTTP 요청을 HTTPS로 301 영구 이동
    return 301 https://$host$request_uri;
}

기능:

• 모든 HTTP 요청을 HTTPS로 강제 리다이렉트
• SEO 및 보안 향상

(2) HTTPS 요청 처리 및 프록시 (포트 443)

server {
    listen 443 ssl http2;
    listen [::]:443 ssl http2;
    server_name test.com www.test.com;

    # SSL/TLS 인증서 설정 (Let's Encrypt)
    ssl_certificate /etc/letsencrypt/live/test.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/test.com/privkey.pem;
    include /etc/letsencrypt/options-ssl-nginx.conf;

    # 보안 헤더 설정
    add_header Strict-Transport-Security "max-age=63072000; includeSubDomains; preload" always;
    add_header X-Content-Type-Options nosniff always;
    add_header X-Frame-Options SAMEORIGIN always;

    # Apache로 프록시
    location / {
        proxy_pass http://127.0.0.1:5050;
        
        # 클라이언트 원본 정보 전달
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        
        # HTTPS 정보 전달 (필수)
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header X-Forwarded-Port 443;
        
        proxy_redirect off;
    }

    # .ht 파일 보안 차단
    location ~ /\.ht {
        deny all;
    }
}

주요 기능:

• SSL/TLS 처리: Nginx가 HTTPS 암호화/복호화 담당
• 보안 헤더: HSTS, XSS 보호, 클릭재킹 방지
• 프록시 헤더: Apache가 실제 클라이언트 정보를 알 수 있도록 전달
• X-Forwarded-Proto: WordPress가 HTTPS를 인식하는 데 필수

3. Apache 설정

포트 설정

파일: /etc/apache2/ports.conf

Listen 5050

설명:

• Apache는 외부 접근 불가능한 내부 포트 5050에서만 대기
• Nginx만 이 포트로 요청 전달 가능

VirtualHost 설정

파일: /etc/apache2/sites-available/test.conf

<VirtualHost *:5050>
    ServerName test.com
    ServerAlias www.test.com

    DocumentRoot /path/to/wordpress/

    ErrorLog ${APACHE_LOG_DIR}/test_error_444.log
    CustomLog ${APACHE_LOG_DIR}/test_access_444.log combined
</VirtualHost>

주요 명령어

# 사이트 활성화
sudo a2ensite test.conf

# 사이트 비활성화
sudo a2dissite test.conf

# Apache 설정 다시 로드
sudo systemctl reload apache2

4. 전체 설정 흐름

초기 설정 순서

1. Apache 포트 변경 sudo vim /etc/apache2/ports.conf # Listen 5050 추가
2. Apache VirtualHost 생성 sudo vim /etc/apache2/sites-available/test.conf sudo a2ensite test.conf sudo systemctl reload apache2
3. WordPress 설정 수정 sudo vim /path/to/wordpress/wp-config.php # 프록시 인식 코드 추가
4. Nginx 설정 생성 sudo vim /etc/nginx/sites-available/test.conf sudo nginx -t sudo ln -s /etc/nginx/sites-available/test.conf /etc/nginx/sites-enabled/ sudo systemctl restart nginx
5. SSL 인증서 발급 (Let’s Encrypt) sudo certbot --nginx -d test.com -d www.test.com

5. 트러블슈팅

일반적인 문제

문제 1: WordPress 리다이렉트 루프

원인: WordPress가 HTTPS를 인식하지 못함
해결: wp-config.php에 프록시 인식 코드 확인

문제 2: Mixed Content 경고

원인: HTTP 리소스가 HTTPS 페이지에 로드됨
해결: WordPress 설정 > 사이트 주소를 https://로 변경

문제 3: 502 Bad Gateway

원인: Apache가 5050 포트에서 실행되지 않음
해결:

sudo systemctl status apache2
sudo netstat -tlnp | grep 5050

문제 4: SSL 인증서 오류

원인: 인증서 경로가 올바르지 않음
해결: Nginx 설정에서 인증서 경로 확인

6. 보안 체크리스트

• [ ] HTTP → HTTPS 강제 리다이렉트 작동
• [ ] Apache는 localhost(127.0.0.1)에서만 접근 가능
• [ ] SSL 인증서 자동 갱신 설정
• [ ] 보안 헤더(HSTS, X-Frame-Options 등) 적용
• [ ] .ht 파일 접근 차단
• [ ] 방화벽에서 5050 포트 외부 차단

7. 성능 최적화 팁

1. Nginx 캐싱 활성화: 정적 파일을 Nginx에서 직접 서빙
2. Gzip 압축: 텍스트 기반 콘텐츠 압축
3. HTTP/2 활성화: 이미 설정됨 (http2 옵션)
4. Keep-Alive 설정: 연결 재사용

참고 사항

• 도메인: 실제 도메인으로 test.com 변경 필요
• 경로: WordPress 설치 경로에 맞게 수정
• 포트: 5050 포트는 예시이며, 다른 포트 사용 가능 (보안을 위해 비표준 포트 권장)
• 로그: 각 설정 파일에 명시된 로그 경로에서 문제 진단 가능

The post Nginx + Apache / Reverse Proxy appeared first on 어제와 내일의 나 그 사이의 이야기.

1단계: Node.js 및 npm 설치

• Gemini CLI는 Node.js 버전 20 이상을 권장

(1) NVM (Node Version Manager)을 이용한 설치 (추천)

// Node.js 20 이상인지 확인
node -v
npm -v

// NVM 설치 (버전 번호는 최신 버전으로 바뀔 수 있음):
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

// 터미널 재시작 또는 적용:
source ~/.bashrc 
# 또는 새 터미널 창을 엽니다.

// 최신 LTS Node.js 설치:
nvm install --lts
nvm use --lts

(2) apt를 통한 기본 설치

// Node.js 20 이상인지 확인
node -v
npm -v

sudo apt update
sudo apt install -y nodejs npm

2단계: Gemini CLI 설치

• Node.js와 npm이 준비되었다면, npm을 사용하여 Gemini CLI를 전역으로 설치

sudo npm install -g @google/gemini-cli

3단계: Gemini CLI 실행 및 인증

설치가 완료되면, 터미널에 gemini 명령어를 입력하여 실행

gemini

최초 실행 시 다음과 같은 설정 및 인증 과정이 진행됩니다.

1. 테마 선택: 터미널에서 원하는 CLI 테마를 선택합니다.
2. 인증 방법 선택:
   • Google 로그인 (권장):
     개인 Google 계정으로 로그인하여 사용합니다.
     브라우저 창이 열리면 로그인 및 인증을 완료하세요.
     무료 등급에서는 Gemini 2.5 Pro 모델에 대한 충분한 요청 횟수(예: 분당 60회, 일일 1,000회)가 제공됩니다.
   • API 키 사용:
     Google AI Studio 등에서 발급받은 API 키를 사용하려면 환경 변수로 설정하거나 이 옵션을 선택합니다.
     (예: export GEMINI_API_KEY="YOUR_API_KEY")

인증이 성공적으로 완료되면, Gemini CLI 프롬프트(gemini >)가 나타나며 바로 Gemini를 사용할 수 있습니다.

The post Ubuntu에 Gemini CLI 설치 appeared first on 어제와 내일의 나 그 사이의 이야기.

기본 설정 확인

Apache 상태 및 설정 검증

# Apache 서비스 상태 확인
sudo systemctl status apache2

# 설정 파일 문법 검사
sudo apache2ctl configtest

# 활성화된 가상호스트 목록 확인
sudo apache2ctl -S

# Apache 버전 확인
apache2 -v

# 로드된 모듈 확인
apache2ctl -M

필수 모듈 활성화

# 프록시 및 SSL 관련 모듈 활성화
sudo a2enmod proxy
sudo a2enmod proxy_http
sudo a2enmod ssl
sudo a2enmod rewrite
sudo a2enmod headers

# 변경사항 적용
sudo systemctl restart apache2

가상호스트 생성

1. 설정 파일 생성

# 새 가상호스트 설정 파일 생성
sudo vim /etc/apache2/sites-available/testdomain.conf

2. 기본 HTTP 가상호스트

<VirtualHost *:80>
    ServerName testdomain.com
    ServerAlias www.testdomain.com
    ServerAdmin admin@testdomain.com
    
    DocumentRoot /var/www/testdomain
    
    <Directory /var/www/testdomain>
        Options -Indexes +FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>
    
    ErrorLog ${APACHE_LOG_DIR}/testdomain_error.log
    CustomLog ${APACHE_LOG_DIR}/testdomain_access.log combined
</VirtualHost>

3. HTTP → HTTPS 리다이렉트

<VirtualHost *:80>
    ServerName testdomain.com
    ServerAlias www.testdomain.com
    
    # 모든 HTTP 요청을 HTTPS로 리다이렉트
    RewriteEngine On
    RewriteCond %{HTTPS} off
    RewriteRule ^ https://%{SERVER_NAME}%{REQUEST_URI} [R=301,L]
    
    ErrorLog ${APACHE_LOG_DIR}/testdomain_http_error.log
    CustomLog ${APACHE_LOG_DIR}/testdomain_http_access.log combined
</VirtualHost>

4. HTTPS 가상호스트 (정적 파일)

<VirtualHost *:443>
    ServerName testdomain.com
    ServerAlias www.testdomain.com
    ServerAdmin admin@testdomain.com
    
    DocumentRoot /var/www/testdomain
    
    <Directory /var/www/testdomain>
        Options -Indexes +FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>
    
    # SSL 설정
    SSLEngine on
    Include /etc/letsencrypt/options-ssl-apache.conf
    SSLCertificateFile /etc/letsencrypt/live/testdomain.com/fullchain.pem
    SSLCertificateKeyFile /etc/letsencrypt/live/testdomain.com/privkey.pem
    
    # 보안 헤더
    Header always set Strict-Transport-Security "max-age=63072000; includeSubDomains; preload"
    Header always set X-Content-Type-Options nosniff
    Header always set X-Frame-Options SAMEORIGIN
    Header always set X-XSS-Protection "1; mode=block"
    
    ErrorLog ${APACHE_LOG_DIR}/testdomain_https_error.log
    CustomLog ${APACHE_LOG_DIR}/testdomain_https_access.log combined
</VirtualHost>

다양한 설정 예제

리버스 프록시

<VirtualHost *:443>
    ServerName api.testdomain.com
    
    # SSL 설정
    SSLEngine on
    SSLProxyEngine on
    Include /etc/letsencrypt/options-ssl-apache.conf
    SSLCertificateFile /etc/letsencrypt/live/api.testdomain.com/fullchain.pem
    SSLCertificateKeyFile /etc/letsencrypt/live/api.testdomain.com/privkey.pem
    
    # 프록시 설정
    ProxyPreserveHost On
    ProxyPass / http://localhost:3000/
    ProxyPassReverse / http://localhost:3000/
    
    # 프록시 헤더 설정
    RequestHeader set X-Forwarded-Proto "https"
    RequestHeader set X-Forwarded-Port "443"
    ProxyAddHeaders On
    
    # 타임아웃 설정
    ProxyTimeout 300
    
    # 요청 크기 제한 해제
    LimitRequestBody 0
    LimitRequestLine 65536
    LimitRequestFieldSize 65536
    
    ErrorLog ${APACHE_LOG_DIR}/api_error.log
    CustomLog ${APACHE_LOG_DIR}/api_access.log combined
</VirtualHost>

WebSocket 프록시

<VirtualHost *:443>
    ServerName ws.testdomain.com
    
    SSLEngine on
    SSLProxyEngine on
    Include /etc/letsencrypt/options-ssl-apache.conf
    SSLCertificateFile /etc/letsencrypt/live/ws.testdomain.com/fullchain.pem
    SSLCertificateKeyFile /etc/letsencrypt/live/ws.testdomain.com/privkey.pem
    
    # WebSocket 지원을 위한 프록시 설정
    ProxyPreserveHost On
    RewriteEngine On
    RewriteCond %{HTTP:Upgrade} =websocket [NC]
    RewriteRule /(.*)           ws://localhost:8080/$1 [P,L]
    RewriteCond %{HTTP:Upgrade} !=websocket [NC]
    RewriteRule /(.*)           http://localhost:8080/$1 [P,L]
    
    ProxyPassReverse / http://localhost:8080/
    
    ErrorLog ${APACHE_LOG_DIR}/ws_error.log
    CustomLog ${APACHE_LOG_DIR}/ws_access.log combined
</VirtualHost>

여러 백엔드로 로드 밸런싱

sudo a2enmod proxy_balancer
sudo a2enmod lbmethod_byrequests

<Proxy balancer://mycluster>
    BalancerMember http://localhost:3001
    BalancerMember http://localhost:3002
    BalancerMember http://localhost:3003
    ProxySet lbmethod=byrequests
</Proxy>

<VirtualHost *:443>
    ServerName testdomain.com
    
    SSLEngine on
    Include /etc/letsencrypt/options-ssl-apache.conf
    SSLCertificateFile /etc/letsencrypt/live/testdomain.com/fullchain.pem
    SSLCertificateKeyFile /etc/letsencrypt/live/testdomain.com/privkey.pem
    
    ProxyPreserveHost On
    ProxyPass / balancer://mycluster/
    ProxyPassReverse / balancer://mycluster/
    
    ErrorLog ${APACHE_LOG_DIR}/testdomain_error.log
    CustomLog ${APACHE_LOG_DIR}/testdomain_access.log combined
</VirtualHost>

경로별 다른 백엔드 라우팅

<VirtualHost *:443>
    ServerName testdomain.com
    
    SSLEngine on
    Include /etc/letsencrypt/options-ssl-apache.conf
    SSLCertificateFile /etc/letsencrypt/live/testdomain.com/fullchain.pem
    SSLCertificateKeyFile /etc/letsencrypt/live/testdomain.com/privkey.pem
    
    # API 요청은 백엔드 서버로
    ProxyPass /api http://localhost:8000/api
    ProxyPassReverse /api http://localhost:8000/api
    
    # 정적 파일은 직접 제공
    DocumentRoot /var/www/testdomain
    <Directory /var/www/testdomain>
        Require all granted
    </Directory>
    
    ErrorLog ${APACHE_LOG_DIR}/testdomain_error.log
    CustomLog ${APACHE_LOG_DIR}/testdomain_access.log combined
</VirtualHost>

특정 IP만 접근 허용

<VirtualHost *:443>
    ServerName admin.testdomain.com
    
    SSLEngine on
    Include /etc/letsencrypt/options-ssl-apache.conf
    SSLCertificateFile /etc/letsencrypt/live/admin.testdomain.com/fullchain.pem
    SSLCertificateKeyFile /etc/letsencrypt/live/admin.testdomain.com/privkey.pem
    
    DocumentRoot /var/www/admin
    
    <Directory /var/www/admin>
        # 특정 IP만 허용
        Require ip 192.168.1.0/24
        Require ip 10.0.0.5
    </Directory>
    
    ErrorLog ${APACHE_LOG_DIR}/admin_error.log
    CustomLog ${APACHE_LOG_DIR}/admin_access.log combined
</VirtualHost>

SSL/HTTPS 설정

Certbot으로 SSL 인증서 발급

# 자동 설정 (권장)
sudo certbot --apache -d testdomain.com -d www.testdomain.com

# 인증서만 발급 (수동 설정)
sudo certbot certonly --standalone -d testdomain.com -d www.testdomain.com

# 와일드카드 인증서 발급
sudo certbot certonly --manual --preferred-challenges dns -d testdomain.com -d *.testdomain.com

# 인증서 갱신 테스트
sudo certbot renew --dry-run

# 인증서 강제 갱신
sudo certbot renew --force-renewal

# 인증서 자동 갱신 크론잡 설정
sudo crontab -e
# 매일 새벽 2시에 갱신 확인
0 2 * * * certbot renew --quiet

SSL 설정 최적화

# /etc/letsencrypt/options-ssl-apache.conf 참고
# 또는 직접 설정

SSLEngine on
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
SSLCipherSuite ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384
SSLHonorCipherOrder off
SSLSessionTickets off

# OCSP Stapling 활성화
SSLUseStapling on
SSLStaplingCache "shmcb:logs/stapling-cache(150000)"

가상호스트 관리

활성화/비활성화

# 가상호스트 활성화
sudo a2ensite testdomain.conf

# 가상호스트 비활성화
sudo a2dissite testdomain.conf

# 기본 사이트 비활성화
sudo a2dissite 000-default.conf

# 설정 적용 (다운타임 없음)
sudo systemctl reload apache2

# 설정 재시작 (다운타임 발생)
sudo systemctl restart apache2

모듈 관리

# 모듈 활성화
sudo a2enmod 모듈명

# 모듈 비활성화
sudo a2dismod 모듈명

# 자주 사용하는 모듈들
sudo a2enmod rewrite      # URL 재작성
sudo a2enmod headers      # HTTP 헤더 조작
sudo a2enmod proxy        # 프록시 기능
sudo a2enmod proxy_http   # HTTP 프록시
sudo a2enmod proxy_wstunnel  # WebSocket 프록시
sudo a2enmod ssl          # SSL/TLS
sudo a2enmod deflate      # 압축
sudo a2enmod expires      # 캐시 제어

문제 해결

로그 확인

# 실시간 에러 로그 모니터링
sudo tail -f /var/log/apache2/error.log

# 실시간 액세스 로그 모니터링
sudo tail -f /var/log/apache2/access.log

# 특정 가상호스트 로그
sudo tail -f /var/log/apache2/testdomain_error.log

# 마지막 100줄 확인
sudo tail -100 /var/log/apache2/error.log

# 특정 키워드로 검색
sudo grep "testdomain" /var/log/apache2/*.log

# 에러만 필터링
sudo grep "error" /var/log/apache2/error.log

# 최근 에러 (systemd)
sudo journalctl -u apache2 -n 50

연결 테스트

# HTTP 응답 헤더 확인
curl -I http://testdomain.com/

# HTTPS 응답 헤더 확인
curl -I https://testdomain.com/

# 상세 디버깅 정보
curl -v https://testdomain.com/

# POST 요청 테스트
curl -X POST https://testdomain.com/api/endpoint \
  -H "Content-Type: application/json" \
  -d '{"key":"value"}'

# SSL 인증서 정보 확인
openssl s_client -connect testdomain.com:443 -servername testdomain.com < /dev/null

# 백엔드 서비스 테스트
curl -v http://localhost:3000/

포트 및 프로세스 확인

# 특정 포트 사용 확인
sudo netstat -tlnp | grep :80
sudo netstat -tlnp | grep :443
sudo netstat -tlnp | grep :3000

# 또는 ss 명령어 사용 (더 빠름)
sudo ss -tlnp | grep :80

# Apache 프로세스 확인
ps aux | grep apache2

# 열린 파일 확인
sudo lsof -i :80
sudo lsof -i :443

일반적인 문제 해결

포트 충돌 문제 체크

Apache + Nginx 동시 사용 시 자주 발생
특히 Certbot –apache 사용 시 충돌할 수 있음.

sudo ss -tlnp | grep :80
sudo ss -tlnp | grep :443

// 만약 Nginx가 잡고 있다면
sudo systemctl stop nginx
sudo systemctl disable nginx

403 Forbidden 오류

# Directory 권한 확인
<Directory /var/www/testdomain>
    Require all granted
    # 또는
    Options +Indexes
</Directory>

# 파일 시스템 권한 확인
sudo chmod -R 755 /var/www/testdomain
sudo chown -R www-data:www-data /var/www/testdomain

500 Internal Server Error

# 설정 문법 오류 확인
sudo apache2ctl configtest

# .htaccess 문제 확인
sudo tail -50 /var/log/apache2/error.log

# SELinux 확인 (CentOS/RHEL)
sudo setenforce 0  # 임시 비활성화

SSL 인증서 오류

# 인증서 파일 존재 확인
ls -la /etc/letsencrypt/live/testdomain.com/

# 인증서 유효기간 확인
sudo certbot certificates

# 인증서 갱신
sudo certbot renew

# SSL 인증서 권한 변경 주의
# SSLCertificateFile: file '/etc/letsencrypt/live/.../fullchain.pem' does not exist or is empty // 원인은 보통 인증서 폴더 권한 문제

sudo chmod 755 /etc/letsencrypt/live
sudo chmod 644 /etc/letsencrypt/live/DOMAIN/fullchain.pem
sudo chmod 600 /etc/letsencrypt/live/DOMAIN/privkey.pem

프록시 오류 (502 Bad Gateway)

# 백엔드 서비스 작동 확인
curl http://localhost:3000/

# SELinux 설정 (CentOS/RHEL)
sudo setsebool -P httpd_can_network_connect 1

# 프록시 타임아웃 늘리기
ProxyTimeout 600

Proxy 헤더 관련 ForwardedHeaders 추가

ASP.NET Core, Node.js, Django 모두 HTTPS 프록시 환경에서 필수

RequestHeader set X-Forwarded-For %{REMOTE_ADDR}s
RequestHeader set X-Forwarded-Proto https
RequestHeader set X-Forwarded-Host %{HTTP_HOST}s

# (예시) ASP.NET Core
app.UseForwardedHeaders(new ForwardedHeadersOptions
{
    ForwardedHeaders = ForwardedHeaders.XForwardedFor | ForwardedHeaders.XForwardedProto
});

보안 강화

보안 헤더 설정

<VirtualHost *:443>
    ServerName testdomain.com
    
    # ... SSL 설정 ...
    
    # HSTS (HTTP Strict Transport Security)
    Header always set Strict-Transport-Security "max-age=63072000; includeSubDomains; preload"
    
    # XSS 방지
    Header always set X-XSS-Protection "1; mode=block"
    
    # MIME 타입 스니핑 방지
    Header always set X-Content-Type-Options "nosniff"
    
    # 클릭재킹 방지
    Header always set X-Frame-Options "SAMEORIGIN"
    
    # Referrer 정책
    Header always set Referrer-Policy "strict-origin-when-cross-origin"
    
    # CSP (Content Security Policy)
    Header always set Content-Security-Policy "default-src 'self'; script-src 'self' 'unsafe-inline'; style-src 'self' 'unsafe-inline';"
    
    # 서버 정보 숨기기
    ServerTokens Prod
    ServerSignature Off
</VirtualHost>

접근 제어

# IP 기반 접근 제어
<Directory /var/www/admin>
    # 특정 IP만 허용
    Require ip 192.168.1.0/24
    Require ip 10.0.0.5
    
    # 또는 특정 IP 차단
    Require all granted
    Require not ip 192.168.1.100
</Directory>

# HTTP Basic 인증
<Directory /var/www/protected>
    AuthType Basic
    AuthName "Restricted Area"
    AuthUserFile /etc/apache2/.htpasswd
    Require valid-user
</Directory>

.htpasswd 파일 생성

# htpasswd 파일 생성 (첫 사용자)
sudo htpasswd -c /etc/apache2/.htpasswd username

# 추가 사용자 등록 (-c 옵션 제거)
sudo htpasswd /etc/apache2/.htpasswd username2

Rate Limiting (mod_ratelimit)

<Location /api>
    SetOutputFilter RATE_LIMIT
    SetEnv rate-limit 400
    SetEnv rate-initial-burst 100
</Location>

성능 최적화

캐싱 설정

<VirtualHost *:443>
    ServerName testdomain.com
    
    # ... 기본 설정 ...
    
    # 정적 파일 캐싱
    <IfModule mod_expires.c>
        ExpiresActive On
        
        # 이미지
        ExpiresByType image/jpg "access plus 1 year"
        ExpiresByType image/jpeg "access plus 1 year"
        ExpiresByType image/gif "access plus 1 year"
        ExpiresByType image/png "access plus 1 year"
        ExpiresByType image/webp "access plus 1 year"
        ExpiresByType image/svg+xml "access plus 1 year"
        
        # CSS/JS
        ExpiresByType text/css "access plus 1 month"
        ExpiresByType application/javascript "access plus 1 month"
        
        # 폰트
        ExpiresByType font/woff2 "access plus 1 year"
        ExpiresByType font/woff "access plus 1 year"
        
        # HTML
        ExpiresByType text/html "access plus 1 hour"
    </IfModule>
    
    # Cache-Control 헤더
    <FilesMatch "\.(jpg|jpeg|png|gif|webp|svg|css|js|woff|woff2)$">
        Header set Cache-Control "max-age=31536000, public"
    </FilesMatch>
</VirtualHost>

Gzip & Brotli 압축

<IfModule mod_deflate.c>
    # 압축 활성화
    AddOutputFilterByType DEFLATE text/html text/plain text/xml text/css
    AddOutputFilterByType DEFLATE application/javascript application/json
    AddOutputFilterByType DEFLATE application/xml application/xhtml+xml
    AddOutputFilterByType DEFLATE image/svg+xml
    
    # 이미지는 압축 제외 (이미 압축됨)
    SetEnvIfNoCase Request_URI \.(?:gif|jpe?g|png|webp)$ no-gzip
</IfModule>


sudo apt install libapache2-mod-brotli
sudo a2enmod brotli

<IfModule mod_brotli.c>
    BrotliCompressionQuality 5
    AddOutputFilterByType BROTLI_COMPRESS text/html text/plain text/css application/javascript application/json image/svg+xml
</IfModule>

KeepAlive 설정

# /etc/apache2/apache2.conf

# KeepAlive 활성화
KeepAlive On

# 최대 요청 수
MaxKeepAliveRequests 100

# 타임아웃 (초)
KeepAliveTimeout 5

MPM 설정 최적화

# /etc/apache2/mods-available/mpm_event.conf

<IfModule mpm_event_module>
    StartServers             2
    MinSpareThreads          25
    MaxSpareThreads          75
    ThreadLimit              64
    ThreadsPerChild          25
    MaxRequestWorkers        150
    MaxConnectionsPerChild   0
</IfModule>

디렉토리 구조

Apache 설정 파일 구조

/etc/apache2/
├── apache2.conf              # 메인 설정 파일
├── ports.conf                # 포트 설정
├── conf-available/           # 사용 가능한 설정
├── conf-enabled/             # 활성화된 설정
├── mods-available/           # 사용 가능한 모듈
├── mods-enabled/             # 활성화된 모듈 (심볼릭 링크)
├── sites-available/          # 사용 가능한 가상호스트
│   ├── 000-default.conf
│   ├── testdomain.conf
│   └── api.testdomain.conf
├── sites-enabled/            # 활성화된 가상호스트 (심볼릭 링크)
│   ├── 000-default.conf -> ../sites-available/000-default.conf
│   └── testdomain.conf -> ../sites-available/testdomain.conf
└── envvars                   # 환경 변수

웹 컨텐츠 디렉토리

/var/www/
├── html/                     # 기본 DocumentRoot
├── testdomain/               # 가상호스트 디렉토리
│   ├── public/
│   ├── index.html
│   └── .htaccess
└── logs/                     # 로그 (선택사항)

유용한 명령어 모음

빠른 참조

# 설정 테스트
sudo apache2ctl configtest

# 가상호스트 목록
sudo apache2ctl -S

# 설정 리로드 (무중단)
sudo systemctl reload apache2

# 재시작
sudo systemctl restart apache2

# 상태 확인
sudo systemctl status apache2

# 로그 실시간 모니터링
sudo tail -f /var/log/apache2/error.log

# 특정 도메인 설정 확인
sudo apache2ctl -D DUMP_VHOSTS | grep testdomain

# 활성화된 모듈 목록
apache2ctl -M

# 설정 파일 문법 체크
sudo apachectl -t

자주 사용하는 작업

# 새 가상호스트 생성부터 활성화까지
sudo vim /etc/apache2/sites-available/newsite.conf
sudo a2ensite newsite.conf
sudo apache2ctl configtest
sudo systemctl reload apache2

# SSL 인증서 발급 및 자동 설정
sudo certbot --apache -d newsite.com

# 로그 분석
sudo tail -1000 /var/log/apache2/access.log | grep "POST" | wc -l

# 디스크 사용량 확인
sudo du -sh /var/log/apache2/*

# 오래된 로그 정리
sudo find /var/log/apache2/ -name "*.log.*" -mtime +30 -delete

문제 상황별 체크리스트

사이트가 접속되지 않을 때

• [ ] Apache 서비스 작동 확인: sudo systemctl status apache2
• [ ] 포트 리스닝 확인: sudo netstat -tlnp | grep :80
• [ ] 방화벽 확인: sudo ufw status
• [ ] DNS 설정 확인: nslookup testdomain.com
• [ ] 가상호스트 활성화 확인: sudo apache2ctl -S
• [ ] 설정 문법 확인: sudo apache2ctl configtest

502 Bad Gateway 발생 시

• [ ] 백엔드 서비스 작동 확인: curl http://localhost:3000/
• [ ] 프록시 설정 확인: ProxyPass, ProxyPassReverse
• [ ] SELinux 설정 확인 (CentOS/RHEL)
• [ ] 타임아웃 설정 확인: ProxyTimeout
• [ ] 에러 로그 확인: sudo tail -50 /var/log/apache2/error.log

SSL 인증서 오류 시

• [ ] 인증서 파일 존재 확인
• [ ] 인증서 유효기간 확인: sudo certbot certificates
• [ ] 인증서 경로 확인
• [ ] 포트 443 리스닝 확인
• [ ] SSL 모듈 활성화 확인: apache2ctl -M | grep ssl

The post Apache Virtual Host Guide (Apache 가상 호스트 설정) appeared first on 어제와 내일의 나 그 사이의 이야기.

C# Switch 식(Expression)

C# 8.0(2019년 9월)부터 도입된 Switch 식(Switch Expression)은 기존의 switch-case 문을 획기적으로 줄여주는 강력한 기능

람다 표현식(=>)을 쓰는 것처럼 간결하고 직관적인 분기 처리가 가능

기존 방식 (Statement)

public string GetGrade(int score)
{
    string grade;
    switch (score)
    {
        case 90:
            grade = "A";
            break;
        case 80:
            grade = "B";
            break;
        default:
            grade = "C";
            break;
    }
    return grade;
}

새로운 방식 (Expression)

public string GetGrade(int score) => score switch
{
    90 => "A",
    80 => "B",
    _  => "C"
};


또는 다른 범위 방식으로 (결과는 다름) 
score switch
{
    >= 90 => "A",
    >= 80 => "B",
    >= 70 => "C",
    _     => "D"
};

• 위치 이동: switch 키워드가 변수 뒤로 이동 (score switch)
• 화살표 사용: case ... : 대신 람다 화살표 =>를 사용
• Default 처리: default: 대신 와일드카드 _를 사용
• 식(Expression): 그 자체가 ‘값’을 반환하므로 메서드의 리턴값으로 바로 사용할 수 있음

강력한 활용 패턴

C# 9.0(2020년 11월)부터 Switch 식이 단순 매핑이 아니라 패턴 매칭(Pattern Matching)과 결합됨

• Switch Expression 자체는 C# 8에서 처음 도입
• Pattern Matching 자체는 C# 7부터 지원
• Relational Pattern, Logical Pattern 등이 C# 9에서 추가

범위 비교 (Relational Pattern)

C# 9.0부터는 when 키워드 없이도 관계 연산자를 직접 사용

int temperature = 28;

string weather = temperature switch
{
    >= 30 => "폭염",
    >= 20 => "쾌적함",
    >= 10 => "쌀쌀함",
    _     => "추움"
};

여러 변수 동시에 비교 (Tuple Pattern)

두 개 이상의 상태를 조합해서 분기해야 할 때, if-else 중첩 없이 튜플 패턴으로 깔끔하게 해결

string state = "Running";
bool hasError = true;

// (상태, 에러여부)를 한 번에 검사
string message = (state, hasError) switch
{
    ("Running", false) => "정상 작동 중",
    ("Running", true)  => "작동 중이나 오류 발생",
    ("Stopped", _)     => "시스템 중지됨", // _는 true/false 상관없음
    _                  => "알 수 없는 상태"
};

객체 속성 비교 (Property Pattern)

객체 내부의 특정 프로퍼티 값에 따라 분기할 수도 있음

var user = new User { Role = "Admin", IsDeleted = false };

string accessLevel = user switch
{
    { Role: "Admin", IsDeleted: false } => "관리자 권한",
    { Role: "User", IsDeleted: false }  => "일반 사용자",
    { IsDeleted: true }                 => "삭제된 계정",
    _                                   => "접근 불가" // null 포함
};

// 객체가 null인 경우도 자동으로 _

리턴값이 없는 메서드(Action) 실행

Action 델리게이트를 반환받아 즉시 실행

switch expression은 “값”을 반환하므로 델리게이트(함수 포인터)를 반환하는 것도 가능

int command = 1;

// 1. 각 조건에 맞는 Action(행동)을 선택하고
// 2. 마지막의 ()로 즉시 실행합니다.
(command switch
{
    1 => (Action)(() => SaveData()),
    2 => () => LoadData(),
    _ => () => Console.WriteLine("대기")
})(); 
// 마지막 ()는 "반환된 델리게이트 실행"

The post C# Switch 식(Expression) appeared first on 어제와 내일의 나 그 사이의 이야기.