导读
本合集目录
本章目录
本卷目标:把只在你电脑上跑的东西,变成互联网上一个别人随时能打开、你随时能修的服务。 读完这一卷,
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 看配置有没有缺。
五、上线前的最后一张清单
这一卷不是"读完就好",是"每条都能演示"。做完八章,你应该能当着别人的面完成下面六件事:
- 把服务停掉,再启动,
curl -I https://你的域名从失败变回 200; systemctl kill -s SIGKILL dudao,三秒后站点自己回来;journalctl -u dudao -n 20里指出最近一次请求的日志行;- 说出昨天有多少个独立 IP 访问过(用 7.7 的命令现场算);
- 删掉数据库,用备份恢复,报出恢复花了多少秒;
- 执行一次回滚,指出
current指向了哪个目录。
六件事里任何一件做不到,说明对应那一章还没真的完成。
六、现在开始
从第 1 章开始。它不装任何软件,但会决定你后面七章顺不顺——配置没分离,后面每一步都会在"为什么本机能跑服务器不能跑"上打转。
如果你已经有一台能 SSH 的服务器和一个域名,也可以先跳到第 2 章准备环境。但第 1 章的三个环境变量(SECRET_KEY、DB_PATH、ALLOW_ORIGIN)建议先抽出来,否则第 3 章写 systemd 时你会卡在 EnvironmentFile 上。