Hướng dẫn deploy dự án Python Flask lên hosting miễn phí PythonAnywhere (từng bước, có ảnh)

Lập Trình

Trong bài này
  1. Chuẩn bị: dự án Flask mẫu
  2. Phần 1: Đăng ký tài khoản PythonAnywhere miễn phí
  3. Bước 1. Vào trang chủ PythonAnywhere
  4. Bước 2. Chọn gói miễn phí Beginner
  5. Bước 3. Điền form đăng ký
  6. Bước 4. Xác nhận email và đăng nhập
  7. Phần 2: Tạo Web app Flask
  8. Bước 5. Mở tab Web → Add a new web app
  9. Bước 6. Tên miền
  10. Bước 7. Chọn framework Flask
  11. Bước 8. Chọn phiên bản Python
  12. Bước 9. Khai báo đường dẫn file Flask
  13. Bước 10. Web app đã được tạo
  14. Phần 3: Upload code của bạn lên
  15. Bước 11. Upload file app.py
  16. Bước 12. Tạo thư mục templates
  17. Bước 13. Upload index.html vào templates
  18. Phần 4: Kiểm tra WSGI, Reload và chạy thử
  19. Bước 14. Kiểm tra file WSGI
  20. Bước 15. Bấm Reload
  21. Bước 16. Mở website 🎉
  22. Gặp lỗi thì xử lý thế nào?
  23. Giới hạn của gói miễn phí cần biết
  24. Tóm tắt nhanh

Bạn đã viết xong một ứng dụng Python Flask chạy ngon lành trên máy mình ở localhost:5000, giờ muốn gửi link cho bạn bè, thầy cô hay nhà tuyển dụng xem? Bài này hướng dẫn từng bước, có ảnh chụp màn hình cách đưa dự án Flask lên hosting miễn phí PythonAnywhere — không cần thẻ tín dụng, không cần cài đặt server, làm hoàn toàn trên trình duyệt trong khoảng 15 phút.

Kết quả cuối cùng: website của bạn chạy tại địa chỉ https://<username>.pythonanywhere.com. Ví dụ trong bài: huuhuybn.pythonanywhere.com.

Chuẩn bị: dự án Flask mẫu

Nếu bạn đã có dự án riêng thì dùng luôn. Nếu chưa, hãy tạo dự án mẫu gồm 2 file với cấu trúc sau:

flask_demo/
├── app.py
└── templates/
    └── index.html

File app.py — tạo đối tượng app, một trang chủ dùng template và một route động /hello/<name>:

from flask import Flask, render_template

app = Flask(__name__)


@app.route("/")
def home():
    return render_template("index.html", title="Flask Demo")


@app.route("/hello/<name>")
def hello(name):
    return f"<h2>Xin chào, {name}! 👋</h2><p>Ứng dụng Flask đang chạy trên PythonAnywhere.</p>"


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

File templates/index.html — giao diện trang chủ (Flask tự tìm template trong thư mục templates):

<!doctype html>
<html lang="vi">
<head>
  <meta charset="utf-8">
  <title>{{ title }}</title>
  <style>
    body { font-family: system-ui, sans-serif; background:#f4f7fb; display:flex; align-items:center; justify-content:center; height:100vh; margin:0; }
    .card { background:#fff; padding:40px 56px; border-radius:16px; box-shadow:0 10px 30px rgba(0,0,0,.08); text-align:center; }
    h1 { color:#2563eb; margin-top:0; }
    a { color:#2563eb; }
  </style>
</head>
<body>
  <div class="card">
    <h1>🚀 Flask Demo đã lên hosting!</h1>
    <p>Dự án Python Flask được deploy miễn phí trên <b>PythonAnywhere</b>.</p>
    <p>Thử route động: <a href="/hello/HocVien">/hello/HocVien</a></p>
  </div>
</body>
</html>

Chạy thử trên máy bằng lệnh python app.py rồi mở http://127.0.0.1:5000 để chắc chắn code không lỗi trước khi đưa lên mạng.

💡 Lưu ý quan trọng: biến Flask phải tên là app (dòng app = Flask(__name__)) và phần app.run() phải nằm trong if __name__ == "__main__":. Trên hosting, server WSGI sẽ tự import biến app, không chạy app.run().

Phần 1: Đăng ký tài khoản PythonAnywhere miễn phí

Bước 1. Vào trang chủ PythonAnywhere

Mở trình duyệt, truy cập www.pythonanywhere.com. Đây là dịch vụ hosting chuyên cho Python (thuộc Anaconda). Ở góc trên bên phải, bấm Pricing & signup.

Trang chủ PythonAnywhere - dịch vụ hosting Python miễn phí
Trang chủ PythonAnywhere – bấm “Pricing & signup” ở góc trên bên phải

Bước 2. Chọn gói miễn phí Beginner

Trang Plans and pricing hiện các gói trả phí (Developer, Custom). Bạn kéo xuống dưới tới mục Explore with a limited account và bấm nút Create a Beginner account. Gói Beginner giá $0/tháng, cho bạn 1 web app tại username.pythonanywhere.com và 512 MB dung lượng — quá đủ cho bài tập và dự án cá nhân.

Trang Pricing - mục Explore with a limited account và nút Create a Beginner account
Kéo xuống mục “Explore with a limited account” → bấm “Create a Beginner account”

Bước 3. Điền form đăng ký

Form Create your account gồm 4 ô:

  • Username: tên đăng nhập. Chọn kỹ vì nó sẽ thành tên miền website: username.pythonanywhere.com. Nên đặt ngắn, không dấu, dễ nhớ.
  • Email: email thật của bạn (sẽ nhận thư xác nhận và thư nhắc gia hạn).
  • Password và Password (again): mật khẩu, nhập 2 lần giống nhau.
Form đăng ký tài khoản PythonAnywhere
Form đăng ký tài khoản

Tick vào ô I agree to the Terms and Conditions… rồi bấm Register.

Điền username, email, mật khẩu và tick đồng ý điều khoản
Ví dụ đã điền username, email và tick đồng ý điều khoản – sau đó bấm Register

Bước 4. Xác nhận email và đăng nhập

Sau khi đăng ký, PythonAnywhere gửi một email xác nhận — mở hộp thư và bấm vào link trong email để kích hoạt (nhớ kiểm tra cả thư mục Spam). Những lần sau, bạn đăng nhập tại trang Log in bằng username/email và mật khẩu.

Trang đăng nhập PythonAnywhere
Trang đăng nhập PythonAnywhere

Đăng nhập thành công bạn sẽ thấy Dashboard. Thanh menu phía trên có các tab quan trọng: Consoles (mở terminal Bash/Python), Files (quản lý file), Web (cấu hình website).

Dashboard PythonAnywhere sau khi đăng nhập
Dashboard – trang tổng quan sau khi đăng nhập

Phần 2: Tạo Web app Flask

Bước 5. Mở tab Web → Add a new web app

Bấm tab Web trên menu. Tài khoản mới chưa có web app nào, bấm nút xanh Add a new web app bên trái.

Tab Web - nút Add a new web app
Tab Web – bấm “Add a new web app”

Bước 6. Tên miền

Gói miễn phí không dùng được tên miền riêng, web của bạn sẽ ở địa chỉ username.pythonanywhere.com. Bấm Next ».

Bước chọn tên miền miễn phí username.pythonanywhere.com
Tên miền miễn phí username.pythonanywhere.com – bấm Next

Bước 7. Chọn framework Flask

Trong danh sách framework (Django, web2py, Flask, Bottle, Manual configuration), bấm Flask.

Chọn framework Flask
Chọn Flask

Bước 8. Chọn phiên bản Python

Chọn phiên bản Python mới nhất, ví dụ Python 3.13 (Flask 3.0.3). Flask đã được cài sẵn, bạn không cần pip install flask.

Chọn phiên bản Python 3.13
Chọn Python 3.13

Bước 9. Khai báo đường dẫn file Flask

Ô Path là nơi đặt file Python chứa biến app. Mặc định là /home/username/mysite/flask_app.py. Để khớp với dự án mẫu, mình sửa thành:

/home/<username>/flask_demo/app.py

(thay <username> bằng username của bạn). Bấm Next ». PythonAnywhere sẽ tạo thư mục flask_demo, một file app.py “Hello World” mẫu và file cấu hình WSGI tương ứng. File mẫu này lát nữa sẽ được thay bằng code của bạn.

Nhập đường dẫn file Flask /home/username/flask_demo/app.py
Sửa Path thành /home//flask_demo/app.py rồi bấm Next

Bước 10. Web app đã được tạo

Thông báo xanh “All done! Your web app is now set up” hiện ra cùng trang cấu hình. Lưu ý mục Best before date: site miễn phí sẽ bị tạm tắt sau 1 tháng nếu bạn không đăng nhập và bấm nút vàng Run until 1 month from today để gia hạn (PythonAnywhere sẽ gửi email nhắc trước 1 tuần).

Web app đã được tạo - trang cấu hình
Trang cấu hình web app – nút Reload và nút gia hạn “Run until 1 month from today”

Kéo xuống mục Code để xem: thư mục mã nguồn (Source code), file cấu hình WSGI configuration file và phiên bản Python.

Mục Code: Source code, WSGI configuration file, Python version
Mục Code – Source code: /home//flask_demo

Phần 3: Upload code của bạn lên

Bước 11. Upload file app.py

Bấm tab Files, đi vào thư mục /home/<username>/flask_demo (hoặc bấm Go to directory ở mục Code). Bạn sẽ thấy file app.py mẫu. Bấm nút vàng Upload a file và chọn file app.py trên máy bạn — file mới sẽ ghi đè file mẫu.

Thư mục flask_demo trong tab Files với file app.py
Thư mục flask_demo – nút “Upload a file” màu vàng

Bước 12. Tạo thư mục templates

Ở cột Directories bên trái, gõ templates vào ô Enter new directory name rồi bấm New directory. Tên thư mục phải đúng chính xác templates (chữ thường, có “s”) thì Flask mới tìm thấy file HTML.

Tạo thư mục templates bằng ô New directory
Gõ “templates” rồi bấm New directory

Bước 13. Upload index.html vào templates

Sau khi tạo, bạn được chuyển vào thư mục flask_demo/templates. Bấm Upload a file và chọn file index.html.

Upload file index.html vào thư mục templates
File index.html đã nằm trong flask_demo/templates

💡 Dự án nhiều file? Cách nhanh hơn: nén dự án thành file .zip, upload lên, rồi mở Bash console (link Open Bash console here) và chạy unzip ten_file.zip. Hoặc nếu code đã có trên GitHub thì dùng git clone https://github.com/ban/du-an.git ngay trong Bash console.

Phần 4: Kiểm tra WSGI, Reload và chạy thử

Bước 14. Kiểm tra file WSGI

Quay lại tab Web, bấm vào link WSGI configuration file (dạng /var/www/username_pythonanywhere_com_wsgi.py). Vì ta chọn Flask ở bước 7, file này đã được tạo sẵn với nội dung đúng:

import sys

# thêm thư mục dự án vào sys.path
project_home = '/home/huuhuybn/flask_demo'
if project_home not in sys.path:
    sys.path = [project_home] + sys.path

# import biến app trong app.py và đặt tên là "application" cho WSGI
from app import app as application  # noqa
Nội dung file WSGI tự sinh cho Flask
File WSGI tự sinh – trỏ tới thư mục flask_demo và import app từ app.py

Hiểu đơn giản: server sẽ thêm thư mục dự án vào sys.path, rồi chạy from app import app — tức là import biến app trong file app.py. Nếu file của bạn tên khác (ví dụ main.py) thì sửa thành from main import app as application và bấm Save.

Bước 15. Bấm Reload

Mỗi khi thay đổi code, bạn bắt buộc phải vào tab Web và bấm nút xanh lá Reload username.pythonanywhere.com, nếu không web vẫn chạy code cũ. Chờ vài giây đến khi biểu tượng quay tròn biến mất.

Bấm nút Reload để khởi động lại web app
Bấm Reload – chờ vài giây để web app khởi động lại

Bước 16. Mở website 🎉

Truy cập https://<username>.pythonanywhere.com. Trang chủ Flask của bạn đã chạy trên Internet, có cả HTTPS miễn phí:

Trang chủ ứng dụng Flask chạy trên huuhuybn.pythonanywhere.com
Trang chủ ứng dụng Flask đã chạy trên PythonAnywhere

Thử luôn route động /hello/HocVien:

Route động /hello/HocVien hoạt động
Route /hello/HocVien trả về lời chào

Gặp lỗi thì xử lý thế nào?

  • “Something went wrong :-( — Error code: 502-backend”: thường do web app vừa Reload chưa khởi động xong. Đợi 10–20 giây rồi tải lại trang.
  • Lỗi 500 / “Unhandled Exception”: vào tab Web → mục Log files → mở error log, kéo xuống cuối để xem dòng lỗi Python mới nhất.
  • TemplateNotFound: index.html: kiểm tra thư mục tên đúng là templates và nằm cùng cấp với app.py.
  • ModuleNotFoundError khi dùng thêm thư viện (requests, pandas…): mở Bash console và cài bằng pip3.13 install --user ten_thu_vien (đúng phiên bản Python đã chọn), sau đó Reload.
  • Sửa code mà web không đổi: bạn quên bấm Reload.

Giới hạn của gói miễn phí cần biết

  • 1 web app tại username.pythonanywhere.com, không dùng tên miền riêng.
  • 512 MB dung lượng, CPU giới hạn theo ngày.
  • Code chỉ gọi được ra Internet tới các trang trong whitelist của PythonAnywhere (các API phổ biến vẫn dùng được).
  • Phải đăng nhập và bấm Run until 1 month from today mỗi tháng để site không bị tắt.

Tóm tắt nhanh

  1. Đăng ký tài khoản Beginner miễn phí tại pythonanywhere.com.
  2. Tab Web → Add a new web app → Flask → Python 3.13 → đặt Path /home/<username>/flask_demo/app.py.
  3. Tab Files → upload app.py, tạo thư mục templates, upload index.html.
  4. Kiểm tra file WSGI import đúng app.
  5. Bấm Reload → mở https://<username>.pythonanywhere.com.

Chúc các bạn deploy thành công! Có lỗi gì cứ để lại bình luận bên dưới kèm ảnh chụp error log, thầy sẽ hỗ trợ. 🚀

Ảnh Nguyễn Hữu Huy

Tác giả

Giảng viên Khoa Công nghệ Thông tin, Cao đẳng FPT Polytechnic

Thầy Huy dạy lập trình tại Cao đẳng FPT Polytechnic, chia sẻ kiến thức về Android, Unity/C#, AI và lập trình backend qua blog dotplays và kênh YouTube Thầy Huy One Champ. Tác giả các ứng dụng dotsave, getvidfb và taptik.