PythonAnywhere 免费部署全指南：支持 Django、Flask 及静态网站

from fastapi import FastAPI

app = FastAPI()

@app.get("/hello")
def read_root():
    return {"msg": "Hello from PythonAnywhere!"}

② 部署步骤和 Flask 一致，WSGI 文件用 from api import app as application； ③ 访问 https://[你的用户名].pythonanywhere.com/hello，就能拿到 API 响应。

4. 其他支持场景（免费版够用）

• 轻量级数据库：免费版支持 SQLite（文件型，不用配置），如果需要 MySQL/PostgreSQL，升级付费版后能直接在后台创建；
• 简单的后端服务：比如配合前端 Vue/React 做后端接口，免费版能扛小流量（个人测试、小型 Demo 完全够）。

二、为什么选 PythonAnywhere？（主流免费平台对比）

市面上免费部署平台不少，但对 Python 新手来说，PythonAnywhere 是「性价比之王」——对 Python 项目友好、步骤简单、免费无时间限制。下面直接对比主流平台，优缺点一目了然：

结论：谁该选 PythonAnywhere？

• ✅ 纯 Python 新手：不想折腾服务器，只想把 Django/Flask 项目上线看看效果；
• ✅ 静态网站需求者：5 分钟搞定个人主页、博客，不用学复杂工具；
• ✅ 脚本运行需求者：需要长期运行简单 Python 脚本，定时任务功能够用；
• ❌ 不适合：需要调用第三方 API（免费版无网络）、项目流量大（免费版 CPU 有限）、非 Python 项目（比如 Node.js、Java）。

三、PythonAnywhere 免费部署 Django 实操（敏感信息模糊版）

前面说了这么多场景，这里重点放 Django 部署的清晰步骤，所有个人信息都用「[ ]」模糊，你直接替换成自己的内容即可。

1. 准备工作

• 本地 Django 项目（确保 python manage.py runserver 能正常运行）；
• 生成 requirements.txt（本地执行 pip freeze > requirements.txt）；
• 浏览器（访问 PythonAnywhere）。

2. Step 1：注册 PythonAnywhere 免费账号

1. 访问官网：PythonAnywhere，点击右上角「Sign Up」；
2. 选「Beginner」（免费版），填写信息：
   • 用户名：[你的用户名]（记牢！后续所有路径都要用）；
   • 邮箱：[你的常用邮箱]（需验证）；
   • 密码：[你的密码]（8 位以上，含字母 + 数字）；
3. 验证邮箱：打开邮件里的链接，激活账号后登录。

3. Step 2：本地项目配置修改（避坑关键）

打开本地项目的 settings.py（路径：[你的项目根目录]/[你的项目主文件夹]/settings.py），在末尾添加以下配置，区分本地和服务器环境：

import os
from pathlib import Path

# 项目根目录（原有配置，不用改）
BASE_DIR = Path(__file__).resolve().parent.parent

# ===================== 服务器环境（PythonAnywhere）=====================
if 'PYTHONANYWHERE_DOMAIN' in os.environ:
    # 1. 允许访问的域名（PythonAnywhere 分配的固定域名）
    ALLOWED_HOSTS = ['[你的用户名].pythonanywhere.com']
    # 2. 禁用 DEBUG 模式（避免泄露敏感信息）
    DEBUG = False
    # 3. 静态文件配置（核心！不然样式会丢）
    STATIC_URL = '/static/'
    STATIC_ROOT = os.path.join(BASE_DIR, 'staticfiles')
    # 服务器收集静态文件的目标目录
    STATICFILES_DIRS = [
        os.path.join(BASE_DIR, 'static'),  # 本地自定义静态文件目录（手动创建）
    ]
    # 4. 媒体文件配置（用户上传的图片、文件）
    MEDIA_URL = '/media/'
    MEDIA_ROOT = os.path.join(BASE_DIR, 'media')
    # 媒体文件存放路径
    # 5. 数据库配置（免费版仅支持 SQLite，不用额外装）
    DATABASES = {
        'default': {
            'ENGINE': 'django.db.backends.sqlite3',
            'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
        }
    }

# ===================== 本地开发环境=====================
else:
    ALLOWED_HOSTS = []
    DEBUG = True
    # 本地数据库配置（比如 MySQL，保持你原来的就行）
    DATABASES = {
        'default': {
            'ENGINE': 'django.db.backends.mysql',
            'NAME': '[你的本地数据库名]',
            'USER': '[你的本地数据库用户名]',
            'PASSWORD': '[你的本地数据库密码]',
            'HOST': 'localhost',
            'PORT': '3306',
        }
    }

避坑提醒：

• STATICFILES_DIRS 里只能放「你手动存静态文件的目录」（比如 static），绝对不能包含 STATIC_ROOT（会触发 staticfiles.E002 错误）；
• 免费版不支持 MySQL，别忘把服务器环境的数据库改成 SQLite。

4. Step 3：上传项目到 PythonAnywhere（无 Git 方式）

① 本地压缩项目

把本地 Django 项目根目录（含 manage.py、requirements.txt）压缩成 ZIP 包，命名为 [你的项目名].zip。

② 服务器上传 + 解压

1. 登录 PythonAnywhere，点击顶部「Files」（文件管理器）；
2. 左侧目录默认在 /home/[你的用户名]/（你的用户根目录），点击「Upload a file」，选择本地的 [你的项目名].zip；
3. 上传完成后，打开「Bash 控制台」（顶部「Consoles」→「Bash」）；
4. 验证：执行 ls [你的项目名]，能看到 manage.py、requirements.txt 就对了。

执行解压命令（替换 [你的项目名]）：

cd ~ # 进入用户根目录
unzip [你的项目名].zip # 解压后生成 [你的项目名] 文件夹

5. Step 4：创建并激活虚拟环境

虚拟环境能隔离项目依赖，避免冲突，步骤超简单：

1. 激活验证：命令行前缀会出现 ([你的虚拟环境名])，表示已自动激活；

后续手动激活（关闭控制台后）：

workon [你的虚拟环境名]

在 Bash 控制台执行（Python 版本选 3.8+，和本地一致）：

mkvirtualenv --python=/usr/bin/python3.10 [你的虚拟环境名] # 比如：django-venv

6. Step 5：安装项目依赖

1. 验证：执行 pip list，能看到 Django 就说明安装成功。

安装依赖（用 requirements.txt 自动安装）：

pip install -r requirements.txt

进入项目根目录：

cd /home/[你的用户名]/[你的项目名]

7. Step 6：配置 Web 应用（核心步骤）

① 新建 Web 应用

1. 点击顶部「Web」→ 绿色按钮「Add a new web app」；
2. 选「Manual configuration」（手动配置，避免模板冲突）→ 点击「Next」；
3. 选 Python 版本（和虚拟环境一致，比如 Python 3.10）→ 点击「Next」。

② 配置项目路径和虚拟环境

在 Web 配置页面，修改 2 个关键路径：

Virtualenv（虚拟环境路径）：

/home/[你的用户名]/.virtualenvs/[你的虚拟环境名]

（注：.virtualenvs 是隐藏文件夹，在文件管理器勾选「Show hidden files」才能看到）

Source code（项目根目录）：

/home/[你的用户名]/[你的项目名]

③ 修改 WSGI 文件（服务器和 Django 通信的桥梁）

1. 在 Web 配置页面找到「WSGI configuration file」，点击蓝色的文件路径（比如 /var/www/[你的用户名]_pythonanywhere_com_wsgi.py）；
2. 点击右上角「Save」保存。

清空原有内容，粘贴以下代码（替换 3 处信息）：

import os
import sys

# 1. 项目根目录路径（替换成你的）
project_path = '/home/[你的用户名]/[你的项目名]'
if project_path not in sys.path:
    sys.path.insert(0, project_path)

# 2. Django 配置模块（替换成你的项目主文件夹名）
os.environ['DJANGO_SETTINGS_MODULE'] = '[你的项目主文件夹].settings'

# 3. 标记为服务器环境（对应 settings.py 中的判断）
os.environ['PYTHONANYWHERE_DOMAIN'] = 'True'

# 加载 Django WSGI 应用
from django.core.wsgi import get_wsgi_application
application = get_wsgi_application()

8. Step 7：配置静态文件和媒体文件

① 创建文件夹（若不存在）

1. 在文件管理器进入项目根目录 /home/[你的用户名]/[你的项目名]；
2. 点击「New directory」，分别创建 static（本地静态文件）和 media（用户上传文件）文件夹。

② 配置静态文件路径

在 Web 配置页面找到「Static files」，点击「Add a new static file」，添加 2 条配置：

添加后点击「Save」。

9. Step 8：数据库迁移 + 创建管理员账号

收集静态文件（把 static 里的文件复制到 staticfiles）：

python manage.py collectstatic

按 y 确认，看到「X static files copied」就完成了。

创建管理员账号（登录 Django 后台 /admin 用）：

python manage.py createsuperuser

按提示输入：用户名（比如 admin）、邮箱（随便填）、密码（输入时不显示，输完回车），确认后按 y。

执行数据库迁移（创建 SQLite 表）：

python manage.py migrate

看到 Applying ... OK 就成功了。

回到 Bash 控制台，确保虚拟环境已激活，进入项目根目录：

workon [你的虚拟环境名]
cd /home/[你的用户名]/[你的项目名]

10. Step 9：重启 Web 应用，访问项目！

1. 回到 Web 配置页面，点击绿色的「Reload [你的用户名].pythonanywhere.com」按钮；
2. 等待 1-2 秒，提示「Web app reloaded successfully」就重启成功了；
3. 访问项目：在浏览器输入 https://[你的用户名].pythonanywhere.com，能看到本地项目的首页就说明部署成功！
4. 访问后台：输入 https://[你的用户名].pythonanywhere.com/admin，用刚才创建的管理员账号登录。

四、免费版常见问题 + 解决方案（新手必看）

1. 问题 1：访问项目显示「500 Internal Server Error」

• 原因：配置错误（WSGI 文件、数据库、静态文件都可能）；
• 解决：查看错误日志 ——Web 配置页面找到「Error log」，点击查看最新错误。 比如日志显示「ModuleNotFoundError: No module named 'xxx'」，就是依赖没装，重新执行 pip install xxx； 显示「DatabaseError」，就是迁移没执行，重新跑 python manage.py migrate。

2. 问题 2：静态文件不显示，页面没样式

• 原因 1：没执行 collectstatic，或者 STATIC_ROOT 配置错了；
• 解决：重新执行 python manage.py collectstatic，检查 STATIC_ROOT 路径是否和 Web 静态配置一致；
• 原因 2：Web 静态文件的 URL 和目录不匹配；
• 解决：确保「Static files」里的 URL 是 /static/，目录是 STATIC_ROOT 路径（/home/[你的用户名]/[你的项目名]/staticfiles）。

3. 问题 3：数据库报错「Can't connect to MySQL」

• 原因：免费版不支持 MySQL，settings.py 没切换到 SQLite；
• 解决：回到 Step 2，确认服务器环境的数据库配置是 SQLite，重新上传 settings.py 并重启应用。

4. 问题 4：免费版提示「CPU 时间不足」

• 原因：项目流量过大，或脚本执行时间太长；
• 解决：关闭不必要的后台进程，简化脚本逻辑，或者等第二天（免费版每天重置 CPU 额度）。

五、PythonAnywhere 免费版小技巧（提升体验）

1. 延期技巧：免费账户每 3 个月会过期，到期前登录，在 Web 页面会有「Extend」按钮，点击就能续期，无限续下去没问题；
2. 定时任务：想让脚本每天跑一次？用「Tasks」功能（顶部「Consoles」→「Tasks」），设置执行时间和命令就行；
3. 文件管理：后续修改本地代码，不用重新传整个项目 —— 只压缩修改的文件（比如 views.py、settings.py），上传替换服务器对应文件，重启应用即可。

六、总结

PythonAnywhere 对 Python 新手来说，是「免费部署天花板」—— 不用学 Linux、不用买服务器、不用懂 Git，全程可视化操作 + 少量命令，就能把 Django/Flask/ 静态网站上线。虽然免费版有一些限制（无网络请求、CPU 有限），但对个人学习、小项目展示完全够用。

如果你的需求是「快速把 Python 项目上线看看效果」，选 PythonAnywhere 准没错；如果需要调用第三方 API 或更大流量，再考虑升级付费版或换 Render、DigitalOcean 等平台。