alpine linux에 한글 설치하기

docker로 실행된 것이라면 아래와 같이 docker 명령어로 쉘에 접속하여 apk 명령어로 한글을 설치한다.

docker exec -i -t --user root container_name sh


apk update && \
    apk add --no-cache fontconfig font-noto-cjk font-noto ttf-dejavu && \
    apk add --no-cache msttcorefonts-installer && \
    update-ms-fonts && \
    fc-cache -fv

---

apk update

이 명령어는 Alpine Linux의 패키지 색인(index)을 업데이트합니다. apk는 Alpine Package Keeper의 약자로, Alpine Linux의 기본 패키지 관리 도구입니다. 이 명령을 실행하면 시스템이 소프트웨어 저장소(repository)에서 사용 가능한 최신 패키지 정보를 가져옵니다. 새로운 패키지를 설치하거나 기존 패키지를 업그레이드하기 전에 항상 실행하는 것이 좋습니다.

---

apk add --no-cache fontconfig font-noto-cjk font-noto ttf-dejavu

이 명령어는 다양한 폰트 및 폰트 관련 유틸리티를 설치합니다.

• apk add: 지정된 패키지를 설치합니다.
• --no-cache: 패키지 다운로드 시 임시 캐시 파일을 저장하지 않도록 합니다. 이는 특히 도커(Docker) 이미지와 같이 최종 이미지 크기를 최소화해야 하는 환경에서 유용합니다.
• fontconfig: 폰트 구성 및 캐싱을 위한 핵심 라이브러리입니다. 시스템이 폰트를 효율적으로 찾고 관리할 수 있도록 돕습니다.
• font-noto-cjk: Noto CJK (Chinese, Japanese, Korean) 폰트 패키지입니다. 한중일 문자를 포함하여 동아시아 언어의 올바른 표시를 위해 필수적입니다.
• font-noto: 구글 Noto 폰트 패키지입니다. "No Tofu" (깨진 글자 없는)를 목표로 다양한 언어를 지원합니다.
• ttf-dejavu: DejaVu 트루타입 폰트 패키지입니다. 리눅스 환경에서 널리 사용되는 범용 폰트 세트로, 가독성이 좋습니다.

---

apk add --no-cache msttcorefonts-installer

이 명령어는 Microsoft TrueType 핵심 폰트를 설치하기 위한 도우미 스크립트를 설치합니다.

• msttcorefonts-installer: 직접 폰트 파일을 설치하는 것이 아니라, Microsoft의 라이선스 제약 때문에 이 패키지는 해당 폰트들을 다운로드하고 설치하는 스크립트를 제공합니다. 예를 들어, Times New Roman, Arial, Courier New 등과 같은 폰트들이 여기에 포함될 수 있습니다.

---

update-ms-fonts

이 명령어는 바로 위에서 설치된 msttcorefonts-installer 패키지의 실제 폰트 다운로드 및 설치 스크립트를 실행합니다. 이 명령이 실행되어야만 Microsoft 핵심 폰트들이 시스템에 제대로 설치됩니다.

---

fc-cache -fv

이 명령어는 시스템의 폰트 캐시를 업데이트하고 재구성합니다.

• fc-cache: fontconfig 라이브러리의 일부로, 시스템이 설치된 폰트를 효율적으로 찾고 사용하도록 돕는 폰트 정보 캐시 파일을 생성하거나 업데이트합니다.
• -f (force): 캐시 파일이 이미 존재하거나 최신 상태로 보일지라도 강제로 캐시를 다시 생성하도록 지시합니다.
• -v (verbose): 명령어 실행 중 상세한 정보(verbose output)를 출력하여 어떤 디렉토리를 스캔하고 어떤 폰트 파일을 찾았는지 등을 보여줍니다.

---

종합적인 의미

이 일련의 명령어들은 주로 다음과 같은 목적으로 사용됩니다:

1. 시스템의 폰트 지원 강화: 특히 한글을 포함한 다국어 환경 및 일반적인 문서 작업에 필요한 다양한 폰트(Noto CJK, Noto, DejaVu, Microsoft Core Fonts)를 설치합니다.
2. 폰트 시스템 최적화: fontconfig 및 fc-cache를 통해 새로 설치된 폰트들이 애플리케이션에서 즉시 인식되고 효율적으로 사용될 수 있도록 시스템 폰트 캐시를 최신 상태로 유지합니다.

이 명령어들을 실행하면 Alpine Linux 환경에서 텍스트 기반 애플리케이션이나 그래픽 환경에서 다양한 언어와 스타일의 폰트가 올바르게 표시되고 입력될 수 있도록 기반을 마련하게 됩니다.