웹사이트 생성 · 2 min read · Oct 19, 2025

우분투 22.04에 Jekyll 정적 웹사이트 생성기 설치하는 방법

Jekyll은 루비로 작성된 무료 오픈 소스 정적 파일 생성기입니다. 이는 몇 분 안에 웹사이트를 만들기 위해 사용되는 간단하고 사용하기 쉬운 콘텐츠 관리 시스템입니다. 좋아하는 마크업 언어로 작성된 텍스트를 가져와 레이아웃을 사용하여 정적 웹사이트를 생성합니다. Jekyll의 내장 기능을 사용하여 사이트의 모양과 느낌, URL, 페이지에 표시되는 데이터 등을 조정할 수 있습니다. 영구 링크, 카테고리, 페이지, 게시물, 사용자 정의 레이아웃 등과 같은 많은 기능을 제공합니다.

이 튜토리얼에서는 우분투 22.04에 Jekyll CMS를 설치하는 방법을 보여줍니다.

필수 조건

  • 우분투 22.04를 실행하는 서버.
  • 서버에 루트 비밀번호가 설정되어 있어야 합니다.

시작하기

시작하기 전에 시스템을 최신 안정 버전으로 업데이트하는 것이 좋습니다. 다음 명령어로 업데이트할 수 있습니다:

apt update -y  
apt upgrade -y

시스템이 최신 상태가 되면 다음 명령어를 실행하여 필요한 다른 종속성을 설치합니다:

apt install make build-essential curl git tree -y

모든 종속성이 설치되면 다음 단계로 진행할 수 있습니다.

루비 설치

Jekyll은 루비로 작성되었으므로 시스템에 설치해야 합니다. 기본적으로 루비 패키지는 우분투 기본 저장소에 포함되어 있습니다.

루비를 설치하려면 다음 명령어를 실행합니다:

apt install ruby ruby-dev -y

설치가 완료되면 루비의 gem 패키지 관리자에게 gem을 사용자 홈 폴더에 배치하도록 지시해야 합니다.

다음과 같이 ~/.bashrc 파일을 편집하여 수행할 수 있습니다:

nano ~/.bashrc

파일의 끝에 다음 줄을 추가합니다:

export GEM_HOME=$HOME/gems
export PATH=$HOME/gems/bin:$PATH

파일을 저장하고 닫은 후, 다음 명령어로 환경 변수를 활성화합니다:

source ~/.bashrc

다음으로, 아래와 같이 gem 명령어를 사용하여 Jekyll과 bundler를 설치할 수 있습니다:

gem install jekyll bundler

설치가 완료되면 다음 단계로 진행할 수 있습니다.

Jekyll로 새 웹사이트 만들기

이 시점에서 Jekyll이 시스템에 설치되었습니다. 이제 다음 명령어를 실행하여 jekyll.example.com이라는 새 웹사이트를 만듭니다:

jekyll new jekyll.example.com

웹사이트가 생성되면 다음과 같은 출력을 얻어야 합니다:

  Bundler: Using jekyll 4.2.2
  Bundler: Fetching jekyll-seo-tag 2.8.0
  Bundler: Fetching jekyll-feed 0.16.0
  Bundler: Installing jekyll-feed 0.16.0
  Bundler: Installing jekyll-seo-tag 2.8.0
  Bundler: Fetching minima 2.5.1
  Bundler: Installing minima 2.5.1
  Bundler: Bundle complete! 7 Gemfile dependencies, 31 gems now installed.
  Bundler: Use `bundle info [gemname]` to see where a bundled gem is installed.Don't run Bundler as root. Bundler can ask for sudo if it is needed, and
  Bundler: installing your bundle as root will break this application for all non-root
  Bundler: users on this machine.
New jekyll site installed in /root/jekyll.example.com. 

다음으로, 다음 명령어를 사용하여 Jekyll이 생성한 모든 파일과 디렉토리를 나열합니다:

tree jekyll.example.com

다음과 같은 출력을 얻어야 합니다:

jekyll.example.com
??? 404.html
??? about.markdown
??? _config.yml
??? Gemfile
??? Gemfile.lock
??? index.markdown
??? _posts
    ??? 2022-09-25-welcome-to-jekyll.markdown

1 directory, 7 files

Jekyll 서버 시작

먼저 웹사이트 디렉토리로 이동하고 다음 명령어를 사용하여 webrick 종속성을 추가합니다:

cd jekyll.example.com  
bundle add webrick

다음으로, 다음 명령어를 실행하여 Jekyll 웹 서버를 시작합니다:

jekyll serve --host=0.0.0.0

서버가 성공적으로 시작되면 다음과 같은 출력을 얻어야 합니다:

Configuration file: /root/jekyll.example.com/_config.yml
            Source: /root/jekyll.example.com
       Destination: /root/jekyll.example.com/_site
 Incremental build: disabled. Enable with --incremental
      Generating... 
       Jekyll Feed: Generating feed for posts
                    done in 0.375 seconds.
 Auto-regeneration: enabled for '/root/jekyll.example.com'
    Server address: http://0.0.0.0:4000/
  Server running... press ctrl-c to stop.

Jekyll 웹사이트에 접근하기

이 시점에서 Jekyll이 시작되어 포트 4000에서 수신 대기하고 있습니다. 이제 웹 브라우저를 열고 URL http://your-server-ip:4000을 입력합니다. Jekyll 기본 페이지로 리디렉션됩니다:

Jekyll

결론

위 가이드에서는 우분투 22.04에 Jekyll을 설치하는 방법을 배웠습니다. 이제 Jekyll을 탐색하고 자동 생성된 콘텐츠를 사용하여 자신의 웹사이트를 만들 수 있습니다.

Share: X/Twitter LinkedIn

새 게시물을 받은 편지함에서 받기

스팸은 없습니다. 언제든지 구독 해지 가능합니다.