운영체제를 이해했다면, 이제는 직접 만져볼 차례입니다.
Linux는 “읽는 것”보다 “직접 입력해보는 것”이 훨씬 중요합니다.

이 글에서는 실제로 가장 많이 사용하는 명령어 위주로 실습을 진행해보겠습니다.

👉 실습 환경: Ubuntu / NAS / Orange Pi / 가상머신 모두 가능

1️⃣ 현재 시스템 상태 확인하기

📌 현재 위치 확인

pwd

현재 내가 있는 디렉토리 경로를 보여줍니다.

📌 파일 목록 보기

ls
ls -al

• -a : 숨김 파일 포함
• -l : 상세 정보 표시

👉 서버 운영에서 가장 기본이 되는 명령어입니다.

2️⃣ 디렉토리(폴더) 다루기

📌 디렉토리 이동

cd /home
cd ..
cd ~

• .. → 상위 폴더
• ~ → 내 홈 디렉토리

📌 디렉토리 생성

mkdir test_folder

📌 디렉토리 삭제

rm -r test_folder

⚠ -r 옵션은 하위 폴더까지 삭제
⚠ 서버에서 매우 조심해야 합니다

3️⃣ 파일 다루기 실습

📌 파일 생성

touch test.txt

📌 파일 내용 확인

cat test.txt

📌 파일 편집 (nano 사용)

nano test.txt

• 수정 후 → Ctrl + X
• Y → 저장

📌 파일 복사

cp test.txt copy.txt

📌 파일 이동 / 이름 변경

mv copy.txt newname.txt

4️⃣ 권한(Permission) 이해하기

파일 상세 보기:

ls -l

출력 예시:

-rwxr-xr--

구조:

[소유자][그룹][기타 사용자]

📌 권한 변경

chmod 755 test.txt

755 의미:

• 7 → 읽기+쓰기+실행
• 5 → 읽기+실행
• 5 → 읽기+실행

👉 서버 보안의 기본입니다.

5️⃣ 프로세스 확인하기

📌 실행 중인 프로세스 보기

ps aux

📌 실시간 모니터링

top

종료: q

👉 CPU 사용률, 메모리 확인 가능

6️⃣ 서비스 관리 (서버 운영 핵심)

Linux는 대부분 systemd 기반입니다.

📌 서비스 상태 확인

systemctl status nginx

📌 서비스 시작

systemctl start nginx

📌 부팅 시 자동 실행 설정

systemctl enable nginx

👉 NAS, AI 서버 자동 실행 시 필수 개념

7️⃣ 로그 확인하기 (장애 분석 기본)

tail -f /var/log/syslog

실시간 로그 확인

👉 장애 발생 시 가장 먼저 보는 영역

8️⃣ 패키지 설치 (Ubuntu 기준)

sudo apt update
sudo apt install htop

설치 후 실행:

htop

top보다 보기 편한 시스템 모니터링 도구

9️⃣ 네트워크 확인

📌 IP 확인

ip addr

📌 포트 확인

netstat -tulnp

👉 어떤 서비스가 어떤 포트를 사용하는지 확인 가능

🔟 실습 루틴 추천

매일 10분씩 아래를 반복해보세요:

1. 폴더 만들기
2. 파일 생성/수정
3. 권한 변경
4. 프로세스 확인
5. 서비스 재시작
6. 로그 확인

2주만 해도 서버 감각이 생깁니다.

📌 Linux 실습을 하면 생기는 변화

✔ 서버가 무섭지 않습니다
✔ NAS 관리가 쉬워집니다
✔ 자동화가 이해됩니다
✔ 장애 분석이 가능해집니다
✔ Docker 구조가 이해됩니다

Linux는 “암기”가 아니라 “반복 실습”입니다.

게시물 Linux 기초 실습 가이드이 하우인포-IT·테크에 처음 등장했습니다.

아침에 알람이 울리긴 하는데…
“몇 시인지 말로 알려주면 진짜 바로 일어나겠는데?” 싶을 때가 있죠.

이번 글에서는 오렌지파이5 + Ubuntu 환경에서, 파이썬으로 말하는 음성 알람을 만드는 방법을 정리했습니다.

• 06:00부터 10분 단위로 06:30까지
• “주인님 일어나세요. 현재 시간 06시 10분입니다.” 같은 문장을 TTS로 말해주고
• 설정파일 1개로 매일/평일/1회 + 공휴일 제외까지 제어하고
• EdgeTTS 캐시(재생 빠름) + 중복 재생 방지(안전) + **systemd 자동 실행(운영 편함)**까지 묶었습니다.

목표 동작 요약

• 알람 시간: 06:00, 06:10, 06:20, 06:30
• 출력: 스피커로 음성 재생(mp3)
• 스케줄 방식: 설정파일(JSON) 기반
• 운영 안정성:
  • 같은 분에 두 번 울리는 것 방지(상태파일 기록)
  • TTS는 캐시(mp3 재사용)로 속도/안정성 개선
  • systemd로 부팅 후 자동 실행

준비물

• Orange Pi 5 (또는 Ubuntu 머신)
• Ubuntu 22.04/24.04 계열
• 스피커(3.5mm/USB/블루투스 등)

설치(필수 패키지)

sudo apt update
sudo apt install -y python3-pip mpg123
pip3 install edge-tts holidays

• edge-tts : 텍스트 → 음성(mp3) 생성
• mpg123 : mp3를 바로 재생(가볍고 안정적)
• holidays : 한국 공휴일 제외(선택처럼 보이지만 “휴일 제외”를 쓰려면 필요)

1) 설정파일 1개로 알람 규칙 관리하기

프로젝트 폴더를 만들고, 설정파일을 준비합니다.

mkdir -p ~/edge_alarm
cd ~/edge_alarm
nano alarm_config.json

alarm_config.json

{
  "mode": "weekdays",
  "times": ["06:00", "06:10", "06:20", "06:30"],
  "message_template": "주인님 일어나세요. 현재 시간 {hh}시 {mm}분입니다.",
  "voice": "ko-KR-SunHiNeural",
  "rate": "+0%",
  "volume": 100,
  "exclude_public_holidays": true,
  "country_holidays": "KR",
  "once_date": "2026-02-12"
}

핵심 옵션 설명

• mode
  • daily : 매일
  • weekdays : 평일만(토/일 제외)
  • once : 특정 날짜 once_date에만 1회 실행
• times : 울릴 시간을 배열로 관리
• message_template : {hh}, {mm}가 현재 시각으로 자동 치환
• exclude_public_holidays : 공휴일 제외 여부
• country_holidays : 한국은 "KR"

2) 파이썬 실행 코드(alarm_tts.py)

이 코드는 아래 3가지를 “운영 가능한 수준”으로 묶는 게 포인트입니다.

1. EdgeTTS 캐시: 같은 문장은 mp3를 저장해 재사용
2. 중복방지: YYYY-MM-DD_HH:MM 키로 “이미 울림” 기록
3. 자동실행: systemd로 부팅 시 자동 기동

아래 파일을 저장하세요.

nano alarm_tts.py
chmod +x alarm_tts.py

alarm_tts.py (한글 상세 주석 포함)

#!/usr/bin/env python3
# -*- coding: utf-8 -*-

"""
[EdgeTTS 음성 알람 스크립트]
- 설정 파일(alarm_config.json) 하나만 수정해서 운영 가능
- EdgeTTS로 MP3 생성 후 스피커로 재생(mpg123 사용)
- MP3 캐시 저장(같은 문장 재사용) -> 빠르고 안정적
- 상태 파일 기록(같은 분 중복 재생 방지)
- systemd 서비스로 등록하면 부팅 후 자동 실행 가능
"""

import asyncio
import json
import os
import sys
import time
import hashlib
import subprocess
from datetime import datetime, date, timedelta

# EdgeTTS 라이브러리 import
try:
    import edge_tts
except ImportError:
    print("edge-tts가 설치되어 있지 않습니다. `pip3 install edge-tts`를 실행하세요.")
    sys.exit(1)

# 공휴일 제외 기능을 위한 라이브러리(없으면 공휴일 판단 기능이 비활성)
try:
    import holidays as holidays_lib
except ImportError:
    holidays_lib = None

# -----------------------------
# 파일 경로(환경변수로 오버라이드 가능)
# -----------------------------
CONFIG_PATH = os.environ.get("ALARM_CONFIG", "./alarm_config.json")  # 설정 파일
STATE_PATH  = os.environ.get("ALARM_STATE", "./alarm_state.json")    # 중복방지 상태 파일
CACHE_DIR   = os.environ.get("ALARM_CACHE", "./tts_cache")           # TTS mp3 캐시 폴더


def load_json(path: str, default):
    """JSON 파일 로딩. 파일이 없으면 default 반환"""
    if not os.path.exists(path):
        return default
    with open(path, "r", encoding="utf-8") as f:
        return json.load(f)


def save_json(path: str, obj):
    """
    JSON 저장을 안전하게 하기 위한 방식
    - 임시 파일(.tmp)에 먼저 저장한 뒤 os.replace로 교체
    - 저장 중 전원 문제 등으로 파일이 깨질 위험을 줄임
    """
    tmp = path + ".tmp"
    with open(tmp, "w", encoding="utf-8") as f:
        json.dump(obj, f, ensure_ascii=False, indent=2)
    os.replace(tmp, path)


def ensure_dir(p: str):
    """폴더가 없으면 생성"""
    os.makedirs(p, exist_ok=True)


def is_public_holiday(d: date, country_code: str) -> bool:
    """
    특정 국가 공휴일 여부 판단
    - holidays 라이브러리가 없으면 False 처리(공휴일 제외 비활성)
    """
    if holidays_lib is None:
        return False

    try:
        h = holidays_lib.country_holidays(country_code)
        return d in h
    except Exception:
        return False


def should_run_today(cfg: dict, today: date) -> bool:
    """
    오늘 알람을 동작시킬지 판단
    - mode(daily/weekdays/once)
    - 공휴일 제외 옵션
    """
    mode = cfg.get("mode", "daily").lower()

    # once 모드: 특정 날짜에만 동작
    if mode == "once":
        once_date = cfg.get("once_date")
        if not once_date:
            return False
        try:
            od = datetime.strptime(once_date, "%Y-%m-%d").date()
            return today == od
        except ValueError:
            return False

    # weekdays 모드: 토/일이면 동작 안 함
    if mode == "weekdays":
        if today.weekday() >= 5:
            return False

    # 공휴일 제외 옵션
    if cfg.get("exclude_public_holidays", False):
        cc = cfg.get("country_holidays", "KR")
        if is_public_holiday(today, cc):
            return False

    return True


def parse_times(cfg: dict):
    """
    설정 times(["06:00","06:10"...])를 (hh,mm) 튜플 리스트로 변환
    - 잘못된 값은 무시
    - 중복 제거 + 정렬
    """
    times = cfg.get("times", [])
    parsed = []
    for t in times:
        try:
            hh, mm = t.split(":")
            parsed.append((int(hh), int(mm)))
        except Exception:
            pass
    return sorted(set(parsed))


def make_message(cfg: dict, now: datetime) -> str:
    """설정 템플릿에서 멘트 생성({hh},{mm} 치환)"""
    tpl = cfg.get("message_template", "주인님 일어나세요. 현재 시간 {hh}시 {mm}분입니다.")
    return tpl.format(hh=now.strftime("%H"), mm=now.strftime("%M"))


def tts_cache_path(text: str, voice: str, rate: str) -> str:
    """
    같은 텍스트/목소리/속도 조합은 mp3를 재사용하기 위해 해시 파일명으로 캐시 저장
    """
    key = f"{voice}|{rate}|{text}".encode("utf-8")
    h = hashlib.sha256(key).hexdigest()[:24]
    return os.path.join(CACHE_DIR, f"{h}.mp3")


async def synthesize_mp3(text: str, voice: str, rate: str, out_path: str):
    """EdgeTTS로 mp3 생성(비동기)"""
    communicate = edge_tts.Communicate(text=text, voice=voice, rate=rate)
    await communicate.save(out_path)


def play_mp3(path: str, volume: int = 100):
    """
    mpg123로 mp3 재생
    - volume(0~100)을 gain으로 완만하게 반영
    """
    gain = max(0, min(32768, int(volume) * 80))
    subprocess.run(["mpg123", "-q", "-f", str(gain), path], check=False)


def minute_key(d: date, hh: int, mm: int) -> str:
    """중복방지 키: YYYY-MM-DD_HH:MM"""
    return f"{d.isoformat()}_{hh:02d}:{mm:02d}"


def next_trigger_datetime(now: datetime, times):
    """
    현재 시각 기준으로 다음 알람 시각 찾기
    - 오늘~모레까지 탐색(안전장치)
    """
    for day_offset in range(0, 3):
        base = now.date() + timedelta(days=day_offset)
        for hh, mm in times:
            dt = datetime.combine(base, datetime.min.time()).replace(hour=hh, minute=mm)
            if dt > now:
                return dt
    return None


async def main():
    """메인 루프"""
    ensure_dir(CACHE_DIR)

    cfg = load_json(CONFIG_PATH, default={})
    state = load_json(STATE_PATH, default={"fired": {}})

    times = parse_times(cfg)
    if not times:
        print("times 설정이 비어 있거나 형식이 잘못되었습니다.")
        return

    voice = cfg.get("voice", "ko-KR-SunHiNeural")
    rate = cfg.get("rate", "+0%")
    volume = int(cfg.get("volume", 100))

    print(f"[alarm] 시작 mode={cfg.get('mode')} times={cfg.get('times')} voice={voice}")

    while True:
        now = datetime.now()
        today = now.date()

        # 오늘 동작 조건이 아니면 내일 새벽까지 대기
        if not should_run_today(cfg, today):
            tomorrow = datetime.combine(today + timedelta(days=1), datetime.min.time()).replace(minute=1)
            sleep_sec = max(5, int((tomorrow - now).total_seconds()))
            print(f"[alarm] 오늘({today}) 스킵. {sleep_sec}초 후 재확인")
            time.sleep(sleep_sec)
            continue

        # 다음 알람 시각 계산
        nxt = next_trigger_datetime(now, times)
        if not nxt:
            time.sleep(10)
            continue

        # 다음 알람까지 대기(너무 길게 한번에 sleep하지 않도록 최대 60초 단위로 쪼갬)
        sleep_sec = (nxt - now).total_seconds()
        if sleep_sec > 1:
            time.sleep(min(60, sleep_sec))
            continue

        # 중복방지: 같은 분에 이미 울렸으면 스킵
        k = minute_key(nxt.date(), nxt.hour, nxt.minute)
        if state.get("fired", {}).get(k):
            time.sleep(1)
            continue

        # 현재 시간 안내가 정확하도록 "울리는 순간"의 시간을 기준으로 멘트 생성
        speak_time = datetime.now()
        text = make_message(cfg, speak_time)

        # 캐시 mp3가 있으면 재사용, 없으면 새로 생성
        cache_path = tts_cache_path(text, voice, rate)
        if not os.path.exists(cache_path):
            try:
                await synthesize_mp3(text, voice, rate, cache_path)
            except Exception as e:
                print("[alarm] TTS 생성 실패:", e)
                time.sleep(2)
                continue

        print(f"[alarm] 울림 {k} => {text}")
        play_mp3(cache_path, volume=volume)

        # 상태 기록(이 분에는 이미 울렸음)
        state.setdefault("fired", {})[k] = True
        save_json(STATE_PATH, state)

        # once 모드면 오늘 남은 알람이 없을 때 종료
        if cfg.get("mode", "").lower() == "once":
            remaining = []
            for hh, mm in times:
                dt = datetime.combine(today, datetime.min.time()).replace(hour=hh, minute=mm)
                if dt > speak_time:
                    remaining.append(dt)
            if not remaining:
                print("[alarm] once 모드 완료. 종료")
                return

        time.sleep(1)


if __name__ == "__main__":
    try:
        asyncio.run(main())
    except KeyboardInterrupt:
        print("\n[alarm] 사용자에 의해 종료됨")

3) 실행 방법(수동 테스트)

cd ~/edge_alarm
python3 alarm_tts.py

당장 테스트하고 싶으면 times를 현재 시간 기준으로 1~2분 뒤로 잠깐 바꿔보면 바로 확인됩니다.

4) systemd 자동 실행(부팅 시 자동 시작)

1) 서비스 파일 생성

sudo nano /etc/systemd/system/edge-alarm.service

2) 아래 내용 입력(경로는 본인 계정에 맞게 수정)

[Unit]
Description=Edge TTS Alarm (EdgeTTS cache + dedup + systemd)
After=network.target sound.target

[Service]
Type=simple
WorkingDirectory=/home/orangepi/edge_alarm
ExecStart=/usr/bin/python3 /home/orangepi/edge_alarm/alarm_tts.py
Restart=always
RestartSec=3

[Install]
WantedBy=multi-user.target

3) 적용 및 실행

sudo systemctl daemon-reload
sudo systemctl enable --now edge-alarm.service
sudo systemctl status edge-alarm.service

운영 팁(실제로 써보면 도움이 되는 부분)

• 네트워크가 잠깐 끊겨도 이미 만들어둔 mp3 캐시가 있으면 재생은 계속 됩니다.
• “같은 시간에 두 번 울림”이 싫다면 상태파일(alarm_state.json) 방식이 꽤 든든합니다.
• 멘트/시간/평일여부는 코드가 아니라 설정파일 하나로 운영하면 나중에 유지보수가 편해요.

FAQ

Q. 공휴일 제외는 어떻게 동작해요?
A. holidays 라이브러리에서 KR 공휴일을 체크해서 해당 날짜면 스킵합니다.

Q. 스피커가 USB/블루투스면 안 나올 때가 있어요.
A. 대부분 “기본 출력 장치”가 다르게 잡혀서 생깁니다. 먼저 Ubuntu 사운드 출력 장치를 확인해 주세요.

Q. 멘트를 바꾸려면 코드를 수정해야 하나요?
A. 아니요. message_template만 바꾸면 됩니다.

게시물 파이썬으로 음성 알람 만들기: EdgeTTS 캐시 + 중복방지 + systemd 자동실행이 하우인포-IT·테크에 처음 등장했습니다.

• “이거 한 줄만 물어보면 되는데… 다시 브라우저 열기 귀찮다”
• “답변은 길어질 것 같은데, 화면 보는 대신 그냥 읽어줬으면 좋겠다”
• “업무 중에 손은 키보드/마우스에 묶여 있는데, 짧게 대화하듯 확인하고 싶다”

그래서 저는 아주 단순한 목표로 시작했어요.

터미널에 질문을 치면 GPT가 답하고, 그 답을 바로 한국어 음성으로 읽어주는 작은 비서

이번 글에서는 제가 실제 소스를 기준으로, 설치부터 운영 팁까지 한 번에 정리해볼게요.

1) 이 스크립트가 하는 일 (한 줄 요약)

나> 질문 입력 → GPT 답변 생성 → Edge TTS로 mp3 생성 → mpg123로 즉시 재생

핵심은 “대화가 끊기지 않게” 만드는 거예요.
기존 버전에서는 답변이 길어지면 500자에서 뚝 잘려서 읽히는 문제가 있었는데, 이 소스에서는 문장 단위로 나눠서 끝까지 읽는 방식으로 개선했습니다.

2) 왜 이소스가 실무에 더 편하냐면

제가 실제로 써보니, 딱 두 가지가 중요했어요.

✅ (1) 답변이 길어져도 끝까지 읽어줌

업무 질문은 생각보다 길게 답이 나오는 경우가 많아요.
“요약 + 근거 + 단계별 명령어” 같은 답변이 나오면 500자 제한으로 끊기는 순간 흐름이 무너집니다.

답변을 문장 단위로 쪼개서 자연스럽게 이어 읽어요.

✅ (2) asyncio.run() 반복 호출 제거

환경에 따라(특히 이벤트 루프가 이미 돌아가는 환경) asyncio.run()을 반복하면 충돌이 날 때가 있어요.
이 소스에서는 이벤트 루프를 한 번만 만들고 계속 재사용하는 방식이라 안정성이 좋아집니다.

3) 준비물 (Ubuntu/Orange Pi 기준)

• Python 3.9+ (대부분 OK)
• 패키지: openai, edge-tts
• 재생기: mpg123
• 그리고 가장 중요한 OpenAI API Key

4) 설치 (실제로 이대로 하면 됩니다)

4-1) mpg123 설치

sudo apt-get update
sudo apt-get install -y mpg123

4-2) 파이썬 라이브러리 설치

pip install -U openai edge-tts

4-3) API 키 설정

export OPENAI_API_KEY="sk-여기에_키_입력"

실무 팁: 매번 export 치기 귀찮으면
~/.bashrc 또는 ~/.profile에 넣어두면 편합니다.

5) 실행 (가장 기본 세팅)

python3 text_gpt_edge_tts_v4.py

실행하면 터미널에 이렇게 뜹니다.

• 나> 프롬프트가 나오고,
• 입력하면 GPT> 답변이 출력되고,
• 이어서 바로 음성으로 재생됩니다.

6) 자주 쓰는 튜닝 포인트 (환경변수로 조절)

실무에서 “한 번 만들어두고 계속 쓰는 도구”가 되려면, 튜닝이 쉬워야 해요.
이 스크립트는 대부분 환경변수로 바꿀 수 있게 해놨습니다.

✅ 모델 바꾸기

export GPT_MODEL="gpt-4o-mini"

✅ 목소리 바꾸기 (한국어)

export TTS_VOICE="ko-KR-SunHiNeural"

✅ 말하기 속도/볼륨

export TTS_RATE="+10%"
export TTS_VOLUME="+0%"

✅ “한 번에 읽는 길이” 조절 (청크 크기)

export MAX_SPEAK_CHARS="450"

• 너무 자주 끊기면 값을 올리고(500~700)
• 문장 끝이 어색하게 잘리면 조금 낮추는 게(350~500) 안정적이었습니다.

✅ TTS 모드 선택

export TTS_MODE="chunk"   # 기본: 끝까지 읽기
# export TTS_MODE="clamp" # 기존처럼 잘라 읽기

7) 운영하면서 “진짜 도움이 됐던” 사용 패턴

제가 실제로 써보면서 효과 있었던 사용 패턴을 몇 개 공유할게요.

(1) 짧은 업무 확인

• “이 로그 메시지 의미가 뭐야?”
• “nginx에서 502 나올 때 점검 순서 정리해줘”
• “이 에러는 보통 어디서 터지지?”

이런 것들은 화면으로 읽기보다 음성으로 들으면 손이 자유로워서 편합니다.

(2) 문서 초안/메일 초안 만들기

• “고객에게 보낼 공지 초안 부탁해”
• “실무적인 체크리스트 형태로 정리해줘”

이럴 때 답이 길어지는데 v4는 중간에 끊기지 않아서 좋았어요.

(3) “내가 지금 뭘 해야 하지?” 정리용

업무가 복잡해질수록, 오히려 이런 질문이 유용합니다.

• “지금 내가 해야 할 일을 5개로 줄여줘”
• “우선순위를 정해줘(긴급/중요 기준)”

음성으로 들으면 리듬이 생겨서 실행이 빨라져요.

8) 트러블슈팅 (운영하다 보면 꼭 만나는 것들)

✅ mpg123: command not found

→ 설치 안 된 상태입니다.

sudo apt-get install -y mpg123

✅ OPENAI_API_KEY 오류 / 401

→ 키가 없거나 잘못된 값입니다.

echo $OPENAI_API_KEY

출력이 비어 있으면 export가 적용 안 된 거예요.

✅ 음성은 생성되는데 소리가 안 난다

이건 환경이 다양해서 원인이 여러 개인데, 경험상 체크 순서는 이렇습니다.

1. 서버/장비에서 실제 오디오 출력 장치가 맞는지
2. mpg123가 소리를 낼 수 있는 상태인지 (권한/장치)
3. 헤드리스 환경이면 기본 오디오 장치가 비정상일 수 있음

9) 실무에서 꼭 챙길 보안 포인트

이런 스크립트는 “내 PC에서만 쓰는 작은 도구”처럼 보여도, 실무에서는 습관이 중요해요.

• API 키를 코드에 하드코딩하지 않기
  → 환경변수로 관리하는 게 기본입니다.
• 가능하면 .bashrc에 넣되, 공유/백업 파일에 키가 올라가지 않도록 주의
• 회사 자산/업무망 장비에서 돌릴 때는 로그/히스토리 저장 여부도 고려

10) 다음 단계 아이디어 (여기서부터가 확장 포인트)

여기까지는 “키보드 입력 기반 음성 비서”였고, 다음 단계는 이쪽이 재밌습니다.

• 마이크 입력(녹음) → Whisper(STT) → GPT → TTS
  완전한 음성 비서 형태로 확장 가능
• 답변을 읽는 동안 중간에 끊기(Stop) 기능 추가
• 질문/답변을 파일로 저장해서 업무 로그처럼 쌓기
• (저는 이걸 Note Station 자동 정리 파이프라인과 연결해서 “회의 음성 → STT → 요약 → 노트 자동 삽입”까지도 확장 중입니다)

파이썬 소스코드 아래

오렌지파이5에서 돌려봤는데 답변이 조금 늦습니다. 좀더 성능좋은 컴퓨터에서는 대화가 어느정도 되었습니다.

참고하세요.

게시물 터미널에서 바로 쓰는 한국어 음성 비서 만들기: GPT + Edge TTS (실무용)이 하우인포-IT·테크에 처음 등장했습니다.

이럴 때 가장 많이 쓰이는 도구가 바로 Docker입니다.
이 글에서는 Docker가 무엇인지부터
👉 Ubuntu에서 Docker를 설치하고 정상 동작 확인하는 방법까지
초보자 기준으로 차근차근 정리했습니다.

Docker란 무엇인가?

Docker는 **애플리케이션을 컨테이너(Container)**라는 단위로 실행할 수 있게 해주는 도구입니다.

쉽게 비유하면

• 예전 방식:
  👉 프로그램마다 직접 설치 (환경 충돌 잦음)
• Docker 방식:
  👉 프로그램 + 실행 환경을 한 박스에 담아서 실행

그래서 이런 장점이 있습니다.

Docker의 장점

• ✔ 설치/삭제가 매우 간단
• ✔ 서버 환경이 달라도 동일하게 실행
• ✔ 테스트·운영 환경 분리 쉬움
• ✔ 홈서버, NAS, 클라우드 모두 활용 가능

👉 요즘 홈서버, NAS, AI 서버에서 Docker는 거의 필수입니다.

Docker와 가상머신(VM)의 차이

👉 가볍고 빠른 서비스 운영이 목적이라면 Docker가 훨씬 유리합니다.

Docker 설치 전 확인 사항

아래 환경을 기준으로 설명합니다.

• ✔ Ubuntu 20.04 / 22.04 / 24.04
• ✔ sudo 권한 사용자
• ✔ 인터넷 연결

버전 확인:

lsb_release -a

Ubuntu에서 Docker 설치 방법

1️⃣ 기존 패키지 업데이트

sudo apt update
sudo apt upgrade -y

2️⃣ Docker 설치에 필요한 패키지 설치

sudo apt install -y ca-certificates curl gnupg lsb-release

3️⃣ Docker 공식 GPG 키 추가

sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | \
sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

4️⃣ Docker 공식 저장소 추가

echo \
"deb [arch=$(dpkg --print-architecture) \
signed-by=/etc/apt/keyrings/docker.gpg] \
https://download.docker.com/linux/ubuntu \
$(lsb_release -cs) stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

5️⃣ Docker 엔진 설치

sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Docker 정상 설치 확인

버전 확인

docker --version

정상이라면 아래처럼 출력됩니다.

Docker version XX.X.X, build XXXXX

테스트 컨테이너 실행

sudo docker run hello-world

✔ 정상 출력되면 Docker 설치 완료입니다.

sudo 없이 Docker 사용하기 (중요)

매번 sudo 붙이기 귀찮다면 사용자 권한을 추가합니다.

sudo usermod -aG docker $USER

적용을 위해 로그아웃 후 재로그인 또는 재부팅하세요.

확인:

docker ps

Docker Compose란?

Docker Compose는
👉 여러 개의 컨테이너를 한 번에 관리하기 위한 도구입니다.

예를 들면:

• 웹서버 + DB
• AI 서버 + API
• 홈서버 서비스 묶음

지금 설치한 Docker에는 Compose 플러그인이 이미 포함되어 있습니다.

확인:

docker compose version

Docker를 어디에 활용할 수 있을까?

Docker는 이런 곳에 특히 많이 쓰입니다.

• ✔ 홈서버 / NAS 서비스 운영
• ✔ 웹서버 (WordPress, Nginx)
• ✔ AI 서버 (Whisper, Stable Diffusion 등)
• ✔ 자동화 도구 (n8n, Home Assistant)
• ✔ 테스트 환경 구성

👉 한 번 익혀두면 서버 운영 난이도가 확 내려갑니다.

마무리 정리

• Docker는 환경 충돌 없이 서비스 실행을 가능하게 해주는 도구
• Ubuntu에서는 공식 저장소 설치가 가장 안정적
• sudo 없이 사용 설정하면 훨씬 편리
• Docker Compose까지 익히면 서버 관리가 쉬워짐

게시물 🐳 Docker 설치 방법 (Ubuntu 기준) – Docker 개념부터 설치까지 한 번에 정리이 하우인포-IT·테크에 처음 등장했습니다.

가볍고 빠르면서도 확장성이 뛰어나,
파이썬·웹·서버 관리까지 폭넓게 사용할 수 있어 우분투 사용자에게 특히 인기가 많습니다.

이번 글에서는 우분투(Ubuntu)에서 VS Code를 설치하는 가장 쉬운 방법을 정리해보겠습니다.

🐧 왜 우분투에서 VS Code를 많이 쓸까?

• 마이크로소프트 공식 지원
• 터미널·SSH·Docker 연동에 강함
• 확장 프로그램으로 IDE급 활용 가능
• 서버·홈서버·개발 환경에 잘 어울림

CLI 중심인 우분투와 VS Code는 궁합이 아주 좋은 조합입니다.

✅ 방법 1. 스냅(Snap)으로 설치하기 (가장 간단)

우분투 기본 패키지 관리자인 Snap을 이용하면 한 줄로 설치할 수 있습니다.

sudo snap install code --classic

장점

• 설치가 매우 간단
• 자동 업데이트 지원
• 공식 패키지

설치가 끝나면 앱 메뉴에서 Visual Studio Code를 바로 실행할 수 있습니다.

✅ 방법 2. 공식 .deb 패키지로 설치하기 (권장)

마이크로소프트에서 제공하는 공식 저장소를 등록해 설치하는 방법입니다.

1️⃣ 필수 패키지 설치

sudo apt update
sudo apt install wget gpg -y

2️⃣ 마이크로소프트 GPG 키 추가

wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > packages.microsoft.gpg
sudo install -o root -g root -m 644 packages.microsoft.gpg /usr/share/keyrings/

3️⃣ VS Code 저장소 추가

echo "deb [arch=amd64 signed-by=/usr/share/keyrings/packages.microsoft.gpg] \
https://packages.microsoft.com/repos/code stable main" | \
sudo tee /etc/apt/sources.list.d/vscode.list

4️⃣ 설치

sudo apt update
sudo apt install code -y

👉 이 방식은 apt 업데이트와 함께 관리할 수 있어 안정적입니다.

▶ 설치 확인 및 실행

터미널에서 아래 명령어를 입력해보세요.

code

정상적으로 실행되면 설치 성공입니다 🎉

🔧 설치 후 꼭 해볼 설정

• 한글 입력 문제 → ibus 설정 확인
• 확장 추천
  • Python
  • Remote – SSH
  • Docker
  • GitLens
• 테마 변경으로 가독성 개선

VS Code는 설치 후 설정에 따라 생산성이 크게 달라집니다.

✨ 마무리

우분투에서 VS Code를 설치하는 방법은 여러 가지가 있지만,
Snap 또는 공식 저장소 방식만 알아도 충분합니다.

개발, 서버 관리, 홈서버 운영까지
우분투 환경에서 VS Code 하나면 대부분의 작업을 커버할 수 있습니다.

게시물 우분투에서 비주얼 스튜디오 코드 설치 방법 (초보자도 OK)이 하우인포-IT·테크에 처음 등장했습니다.