Flask 앱을 Linux에서 백그라운드로 실행

Flask 앱을 Linux에서 백그라운드로 실행하면서 로그를 저장하는 방법은 매우 자주 사용되는 실전 작업입니다. 아래는 가장 실용적인 단계별 가이드입니다.

---

✅ 1. flask run 명령을 직접 사용하는 경우

nohup flask run --host=0.0.0.0 --port=5000 > flask.log 2>&1 &

• nohup: 터미널 종료되어도 실행 유지
• --host=0.0.0.0: 외부 접속 허용
• > flask.log 2>&1: 로그 파일로 표준 출력 및 에러 저장
• &: 백그라운드 실행

📌 환경 변수 설정 필요

export FLASK_APP=app.py
export FLASK_ENV=development  # 선택 사항

---

✅ 2. python app.py 직접 실행 (권장 방식)

app.py 파일이 있다면 이렇게 실행하는 것도 일반적입니다:

nohup python3 app.py > flask.log 2>&1 &

→ flask run보다 더 유연하고 실제 배포 환경에서도 많이 사용됩니다.

---

✅ 3. 실행 중인 프로세스 확인 / 종료

확인:

ps aux | grep python

종료:

kill -9 <PID>

---

✅ 4. 로그 실시간 확인

tail -f flask.log

---

✅ (선택) Flask 앱 코드에서 로그 직접 설정하기

import logging

logging.basicConfig(
    filename='flask.log',
    level=logging.INFO,
    format='%(asctime)s %(levelname)s:%(message)s'
)

from flask import Flask
app = Flask(__name__)

@app.route('/')
def hello():
    app.logger.info("Hello route accessed")
    return "Hello, Flask!"

---

🔒 보안 및 운영 팁

• --host=0.0.0.0은 외부 접속을 허용하므로, 방화벽에서 포트(예: 5000)를 열어야 함
• flask run은 개발용 서버입니다. 실제 운영 환경에서는 gunicorn, uWSGI, systemd 등을 사용해야 합니다.

---

✅ 운영 환경에서 gunicorn + nohup 예시

nohup gunicorn -w 4 -b 0.0.0.0:5000 app:app > gunicorn.log 2>&1 &

• -w 4: 워커 4개
• -b: 바인딩 주소
• app:app: 파일명:Flask 인스턴스명

---

필요하시면 systemd 서비스 등록이나 gunicorn + nginx 구성도 도와드릴 수 있어요. 어떤 환경에 배포할 건지 알려주시면 거기에 맞게 설정 예시 드릴게요.