分类目录归档:WEB开发

Nginx 反向代理与 Docker 部署 Web 应用入门

本地 python app.py 能跑,不代表能上线。生产环境通常是:Docker 跑应用 + Nginx 对外反代。本文给你最小可用图景。

为什么需要 Nginx

  • 统一 80/443 入口,后端不直接暴露
  • 静态资源缓存、HTTPS 终结
  • 多服务按域名/路径分流

反向代理片段

server {
    listen 80;
    server_name demo.example.com;

    location / {
        proxy_pass http://webapp:8000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

Docker Compose 思路

services:
  webapp:
    build: .
    networks: [app-net]
  nginx:
    image: nginx:1.25-alpine
    ports: ["80:80"]
    volumes:
      - ./nginx.conf:/etc/nginx/conf.d/default.conf:ro
    depends_on: [webapp]
    networks: [app-net]

上线检查清单

  1. 健康检查接口:/health
  2. 日志落盘或收集,方便排错
  3. 密钥走环境变量
  4. 数据库不映射公网端口

你现在的 antpython.net 与博客,就是「同网桥 + Nginx 按域名反代」的典型结构。

RESTful API 设计要点与常见错误

前后端分离后,API 就是合同。合同写清楚,联调少吵架。本文总结 REST 设计里最实用的约定和踩坑点。

资源导向,而不是动作导向

# 更 REST
GET    /api/orders
GET    /api/orders/123
POST   /api/orders
PATCH  /api/orders/123
DELETE /api/orders/123

# 不推荐
POST /api/getOrderList
POST /api/deleteOrder

统一响应结构

{
  "code": 0,
  "message": "ok",
  "data": {"id": 123, "status": "paid"}
}

错误时也返回可机读的 code 和人类可读的 message,并配上合适 HTTP 状态码(400/401/403/404/500)。

分页、过滤、排序

GET /api/orders?status=paid&page=1&page_size=20&sort=-created_at

幂等与安全

  • GET 不应改数据
  • 删除/更新要鉴权,防越权(不能只信前端传的 user_id)
  • 创建类接口可加幂等键,避免重复提交

常见错误

  1. 所有接口都返回 200,错误只写在 body
  2. 字段命名中英混用、同一含义多个名字
  3. 没有版本策略,一改全崩(可用 /api/v1)
  4. 文档缺失:至少维护 OpenAPI / 示例请求

Flask 从路由到模板:做一个迷你站点

Flask 轻量、好上手,很适合把 Python 能力接到 Web 上。本文从路由、请求、模板三块搭一个迷你站点骨架。

最小应用

from flask import Flask, render_template, request, redirect, url_for

app = Flask(__name__)

@app.get("/")
def index():
    return render_template("index.html", title="首页")

@app.route("/hello/<name>")
def hello(name: str):
    return f"你好,{name}!"

@app.post("/search")
def search():
    q = request.form.get("q", "").strip()
    return render_template("search.html", q=q)

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

模板继承

{# templates/base.html #}
<!doctype html>
<title>{% block title %}站点{% endblock %}</title>
<body>
  <nav><a href="{{ url_for('index') }}">首页</a></nav>
  {% block content %}{% endblock %}
</body>
{# templates/index.html #}
{% extends "base.html" %}
{% block title %}首页{% endblock %}
{% block content %}
<h1>欢迎</h1>
{% endblock %}

项目结构建议

myapp/
  app.py
  templates/
  static/
  requirements.txt

下一步

  1. 把业务拆成 Blueprint(用户、文章、后台)
  2. 用 Flask-Session / JWT 做登录态
  3. 配置与密钥走环境变量

先跑通「页面能开、表单能交、模板能复用」,再谈框架对比。