LinuxでFlaskアプリを動かす入門｜PythonウェブアプリをWSL2やVPSにデプロイする方法

この記事のポイント

・venvで仮想環境を作りFlaskをインストールして最初のアプリを動かせる
・flask runで開発サーバーを起動してブラウザからアクセスする方法がわかる
・gunicorn + Nginxで本番公開する基本的な構成が理解できる
・「Address already in use」などよくあるエラーの対処法も解説する

$ python3 --version
Python 3.12.3

# アプリ用のディレクトリを作成
$ mkdir myapp && cd myapp

# 仮想環境を作成（venvという名前のディレクトリに作られる）
$ python3 -m venv venv

# 仮想環境を有効化（有効化するとプロンプトの先頭に(venv)が付く）
$ source venv/bin/activate
(venv) $

(venv) $ pip install flask
Collecting flask
  Downloading flask-3.1.0-py3-none-any.whl.metadata (2.9 kB)
Collecting Werkzeug>=3.1 (from flask)
...（中略）...
Successfully installed Jinja2-3.1.4 MarkupSafe-2.1.5 Werkzeug-3.1.3 blinker-1.8.2 click-8.1.7 flask-3.1.0 itsdangerous-2.2.0

(venv) $ nano app.py

from flask import Flask

app = Flask(__name__)

@app.route("/")
def index():
    return "Hello, Linux!"

if __name__ == "__main__":
    app.run(debug=True)

(venv) $ flask run
 * Debug mode: off
WARNING: This is a development server. Do not use it in a production deployment.
 * Running on http://127.0.0.1:5000
Press CTRL+C to quit

127.0.0.1 - - [23/Aug/2026 09:14:32] "GET / HTTP/1.1" 200 -

(venv) $ pip install gunicorn

# app.pyのappオブジェクトをgunicornで起動（4プロセス）
(venv) $ gunicorn -w 4 -b 127.0.0.1:8000 app:app
[2026-08-23 09:20:10 +0900] [12345] [INFO] Starting gunicorn 23.0.0
[2026-08-23 09:20:10 +0900] [12345] [INFO] Listening at: http://127.0.0.1:8000 (12345)
[2026-08-23 09:20:10 +0900] [12345] [INFO] Worker booting (pid: 12346)
[2026-08-23 09:20:10 +0900] [12345] [INFO] Worker booting (pid: 12347)

server {
    listen 80;
    server_name example.com;   # 自分のドメインまたはIPアドレスに変更

    location / {
        proxy_pass http://127.0.0.1:8000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

# シンボリックリンクを作成して設定を有効化
$ sudo ln -s /etc/nginx/sites-available/myapp /etc/nginx/sites-enabled/

# 設定ファイルの文法チェック
$ sudo nginx -t
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

# Nginxを再起動
$ sudo systemctl restart nginx

# ポート5000を使っているプロセスを調べる
$ ss -tlnp | grep 5000
LISTEN  0  128  127.0.0.1:5000  0.0.0.0:*  users:(("python3",pid=99999,fd=5))

# プロセスを終了する
$ kill 99999

# myappディレクトリに移動してから仮想環境を有効化
$ cd myapp
$ source venv/bin/activate
(venv) $ flask run

# 開発・テスト用のみ。本番ではgunicorn + Nginxを使うこと
(venv) $ flask run --host 0.0.0.0
 * Running on all addresses (0.0.0.0)
 * Running on http://127.0.0.1:5000
 * Running on http://203.0.113.10:5000