跳到正文
零到全栈 · 卷 7 · 上线与运维

导读

本合集目录
本章目录

本卷目标:把只在你电脑上跑的东西,变成互联网上一个别人随时能打开、你随时能修的服务。 读完这一卷,https://你的域名 能打开;进程开机自启、崩了自动重启;日志能回答"谁在什么时候访问了什么";数据库每天自动备份,而且你亲手恢复过一次;发布出错时,一条命令切回上一版。

本文件是卷 7 的导航页。 正式内容在 8 个分册里,每册可单独打开阅读。


一、本卷信息

项 内容
卷号 / 卷名 卷 7 · 上线与运维(全书最关键的一卷)
章数 8 章
组织方式 一章一个文件,每章自带前置说明、正文、验收、自测
主题范围 ① 配置与代码分离 ② 服务器环境与目录规划 ③ systemd 常驻 ④ Nginx 反代 ⑤ 域名与备案 ⑥ HTTPS 与证书 ⑦ 日志与埋点 ⑧ 备份、监控与回滚
不涉及 新功能开发、测试体系、性能优化、安全加固清单——那是卷 8 的事
目标读者 ① 跟着前六卷做完「读到」、现在要把它放上公网的人 ② 会写代码但从没独立部署过的人 ③ 部署过但"能跑就行"、想补上运维基本功的人
前置条件 一台能 SSH 登录的 Ubuntu LTS 服务器;前六卷的 backend/ 与 web/ 产物;一个域名(可先跳过,用 IP 验证)
产出物 一个可访问的 HTTPS 站点 · 一份 dudao.service · 一份 backup.sh · 一次真实的删库恢复记录
随书代码 backend/config.py、backend/routers/health.py、scripts/backup.sh、scripts/deploy.sh、scripts/rollback.sh、dudao.service。全部在正文里给全文,可原样抄
验收口径 不看"读完了没有",只看你敢不敢当着别人的面删掉线上数据库再从备份恢复(清单见第 8 章)

二、八章目录

章 文件 这一章给你什么 产出
1 卷7-01-部署心智配置与代码分离.md 为什么同一份代码在两个环境会跑出两种结果 .env.example + 启动即校验的 config.py
2 卷7-02-服务器环境准备.md 谁在跑、代码放哪、Python 从哪来 五个目录 + dudao 用户 + 一个 venv
3 卷7-03-systemd让进程常驻.md 进程怎么才能不死、日志去哪了 dudao.service + 一次"杀掉再回来"演练
4 卷7-04-Nginx反向代理.md 静态与接口怎么分工、502 是谁发的 80 端口站点配置 + 分诊表
5 卷7-05-域名备案与DNS.md 为什么改了不生效、备案到底卡在哪 一条生效的 A 记录
6 卷7-06-HTTPS与证书.md TLS 在握手时做了什么、证书怎么自己续 443 配置 + 自动续期 + dry-run 通过
7 卷7-07-日志埋点与流量.md 一行日志该记什么、磁盘怎么被写满的 JSON 日志 + logrotate + /api/stats
8 卷7-08-备份监控与回滚.md 出事时怎么救回来 backup.sh + /healthz + 版本目录与回滚

章与章是强线性的。 第 1 章定的三个环境变量,第 2 章要用;第 2 章建的目录,第 3、4、8 章一直引用;第 4 章的 proxy_set_header,第 6 章的 X-Forwarded-Proto 和第 7 章的真实 IP 都靠它。

跳过第 7 章直接做第 8 章,你会不知道备份失败该去哪看日志。跳过第 5 章直接做第 6 章,certbot 会给你一句 Timeout during connect,然后你会在 Nginx 里找一整天。


三、阅读约定

记号 含义
代码字体 命令、文件名、配置项、报错原文;可直接复制
粗体 关键判断,值得单独记下来
⚠️ 高频翻车点,跳过会浪费你两小时
表格 凡是要对比、要决策的东西都在表里
每章末尾「本章验收」 逐条能勾上再往下走,不要自我安慰
「三个坑」 症状 → 成因 → 修法,全部是真会遇到的报错

本卷所有命令按 Ubuntu LTS + Nginx 现行版本 的官方行为编写。配置项在版本之间偶有变化(比如 HTTP/2 的写法),遇到不一致时以 nginx -v 的输出为准,正文里给了判断方法。


四、本卷在全书里的位置

卷5 后端与API        接口能在本机跑
 └ 卷6 数据与状态     数据能存住、用户分得开
    └ 卷7 上线与运维   ← 本卷:它终于属于互联网
       └ 卷8 产品化    它值得被使用

本卷结束时的形态,就是全书唯一一张"生产架构图":

浏览器
  │  https://dudao.example.com
  ▼
Nginx :443(TLS 终止、静态托管、/api 反代)
  ├─ /        → /srv/dudao/web          (前端构建产物,直接读磁盘)
  └─ /api/    → 127.0.0.1:8000
                   ▼
              systemd 管着的 uvicorn(用户 dudao)
                   ▼
              /srv/dudao/data/dudao.db

四个约束贯穿全卷,后面每一章都在维护它们:

约束 为什么
应用只监听 127.0.0.1 公网入口只有 Nginx 一个,攻击面最小
应用以 dudao 跑,不用 root 被攻破时损失可控
代码、产物、数据三者分目录 回滚只换代码,数据不受影响
配置从环境变量进来 同一份代码能在开发和生产都跑对

第 8 章做完之后,这四条就都有了对应的验证手段:ss -lntp 看监听、ps -o user= 看用户、readlink current 看版本、/healthz 看配置有没有缺。


五、上线前的最后一张清单

这一卷不是"读完就好",是"每条都能演示"。做完八章,你应该能当着别人的面完成下面六件事:

  1. 把服务停掉,再启动,curl -I https://你的域名 从失败变回 200;
  2. systemctl kill -s SIGKILL dudao,三秒后站点自己回来;
  3. journalctl -u dudao -n 20 里指出最近一次请求的日志行;
  4. 说出昨天有多少个独立 IP 访问过(用 7.7 的命令现场算);
  5. 删掉数据库,用备份恢复,报出恢复花了多少秒;
  6. 执行一次回滚,指出 current 指向了哪个目录。

六件事里任何一件做不到,说明对应那一章还没真的完成。


六、现在开始

从第 1 章开始。它不装任何软件,但会决定你后面七章顺不顺——配置没分离,后面每一步都会在"为什么本机能跑服务器不能跑"上打转。

如果你已经有一台能 SSH 的服务器和一个域名,也可以先跳到第 2 章准备环境。但第 1 章的三个环境变量(SECRET_KEY、DB_PATH、ALLOW_ORIGIN)建议先抽出来,否则第 3 章写 systemd 时你会卡在 EnvironmentFile 上。

→ 卷7-01-部署心智配置与代码分离.md