🐍 Python 파일을 우분투 서버 systemd 서비스로 등록하고 실행하기

우분투 서버에서 Python 스크립트를 단순히 실행하는 것을 넘어, 시스템 서비스로 등록하여 백그라운드 실행, 자동 재시작, 서버 부팅 시 자동 실행까지 가능하게 만드는 방법을 소개합니다.

예시는 telegram_bot.py라는 봇 파일을 등록하는 기준이지만, 모든 Python 스크립트에 적용할 수 있는 일반적인 가이드입니다.

---

1️⃣ pip 설치 및 패키지 설치

pip 설치

sudo apt-get install python3-pip

필요한 패키지 설치 예시 (python-telegram-bot 등)

pip install python-telegram-bot

---

2️⃣ 파이썬 파일 직접 실행

일반 실행

python3 your_script.py

백그라운드 실행 (로그 저장 포함)

nohup python3 your_script.py > output.log 2>&1 &

• nohup: 터미널 종료 시에도 실행 유지
• > output.log 2>&1: 표준 출력과 오류를 모두 output.log에 저장

---

3️⃣ systemd 서비스로 등록

Python 스크립트를 정식 서비스처럼 등록하려면 systemd 서비스 파일을 만들어야 합니다.

① 서비스 파일 생성

sudo nano /etc/systemd/system/telegrambot.service

② 서비스 파일 내용

[Unit]
Description=Telegram Bot Service
After=network.target

[Service]
ExecStart=/usr/bin/python3 /home/telegrambot/telegram_bot.py
WorkingDirectory=/home/telegrambot
StandardOutput=file:/home/telegrambot/output.log
StandardError=file:/home/telegrambot/output.log
TimeoutStopSec=10
Restart=on-failure
User=eventor

[Install]
WantedBy=multi-user.target

🔹 ExecStart 경로와 User는 자신의 환경에 맞게 수정하세요.

---

4️⃣ 서비스 등록 및 실행

서비스 리로드

sudo systemctl daemon-reload

서비스 시작

sudo systemctl start telegrambot.service

서비스 상태 확인

sudo systemctl status telegrambot.service

부팅 시 자동 실행 설정

sudo systemctl enable telegrambot.service

---

5️⃣ 시스템 시간대 설정 (한국 KST로 설정)

현재 시간대 확인

timedatectl

한국 시간대로 변경

sudo timedatectl set-timezone Asia/Seoul

---

6️⃣ 기타: 사용자 sudo 권한 부여

서비스 실행을 위한 사용자에게 sudo 권한을 부여하려면 아래와 같이 합니다.

sudo usermod -aG sudo 사용자명

현재 사용자 확인

whoami

---

✅ 마무리

이제 Python 스크립트가 서비스처럼 동작합니다!

• 서버가 재부팅되어도 자동 실행
• 예외 발생 시 자동 재시작
• 로그 파일을 통한 실시간 확인 가능