Docker、Nginx、HTTPS 与 Cloudflare 上线运维
本地跑通只是半程。把应用安全、省心地部署到云服务器上长期运行,照着下面这套标准结构走即可。
1. 生产级 Dockerfile 模板(Python / Node 通用思路)
FROM python:3.12-slim
WORKDIR /app
# 先只复制依赖清单,利用 Docker 缓存加速后续构建
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY . .
# 使用非 root 用户运行,降低容器逃逸风险
RUN useradd -m appuser && mkdir -p /app/data && chown -R appuser:appuser /app
USER appuser
EXPOSE 8000
CMD ["uvicorn", "app:app", "--host", "0.0.0.0", "--port", "8000"]
2. docker-compose.yml(仅绑定本地回环端口)
services:
web:
build: .
container_name: vibe-web
restart: unless-stopped
env_file: .env
ports:
- "127.0.0.1:8000:8000" # 关键:不暴露 8000 给公网,统一由宿主机 Nginx 接管 443
volumes:
- ./data:/app/data
3. Nginx 反向代理完整配置(支持 HTTP/2、WebSocket 与 SSE 流)
server {
listen 80;
server_name yourdomain.com;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl;
http2 on;
server_name yourdomain.com;
ssl_certificate /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;
ssl_protocols TLSv1.2 TLSv1.3;
client_max_body_size 50m;
location / {
proxy_pass http://127.0.0.1:8000;
proxy_http_version 1.1;
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;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_buffering off; # 保证 AI 流式输出实时到达前端
proxy_read_timeout 300s; # 长推理任务不轻易 504
}
}
4. Cloudflare DNS 接入最佳实践
- 普通 Web 站点与 API:开启小黄云代理(Proxied),SSL 模式设为
Full (strict),源站配上正式 Let's Encrypt 证书或 CF 15 年 Origin CA 证书,隐藏真实服务器 IP 并自带免费 DDoS 防护。 - 使用 DNS-01 自动申请泛域名/单域名证书:只需要给服务器或 ACME 工具颁发一个仅限单个域名
Zone.DNS:Edit的最小权限 API Token,即可免开80端口自动签发和每 60 天自动续期证书。
5. 服务器日常体检与备份命令
# 查看防火墙与监听端口
ufw status numbered
ss -tulpn
# 查看服务运行状态与最新 50 行日志
systemctl status your-service
journalctl -u your-service -n 50 --no-pager
# 每天凌晨 3 点自动备份 SQLite 数据库(crontab -e)
0 3 * * * sqlite3 /opt/app/data/app.db ".backup '/opt/backups/app_$(date +\%F).db'"