把网站从云服务器搬回家里:Django + Docker + IPv6 DDNS 迁移实录

liulinhai 2026.10.22 21:37 20 0
Django技术 Nginx 网站迁移 Docker Docker Compose IPv6 DDNS 家庭服务器

收录于《把博客搬回家》第 1 篇

缘起

博客在云服务器上跑了几年,续费年年涨,数据却在别人机器里。正好家里宽带有了公网 IPv6,就起了迁回的念头。先说结论:个人项目完全可以搬,商业站点不建议——云厂商的 SLA、DDoS 防护、BGP 线路,家里复制不了。这次搬的是 Django 4.0 + SQLite 的博客,外加一个静态知识门户;图片走七牛 CDN,图床不动,只搬站点本身。

迁移后的架构

一句话:外网流量从云服务器改成了家中电脑,中间靠 DDNS 兜底地址变化:

访客 → 域名解析
  ├─ IPv6(AAAA) → 家中公网 IPv6 → 路由器 → Docker
  │                                        ├─ nginx 反代(:80/:443)
  │                                        │    ├─ 静态目录直出
  │                                        │    └─ proxy_pass → gunicorn → Django
  │                                        └─ SQLite 文件(绑定挂载)
  └─ IPv4(A) → 原云服务器(保留,回滚用)
图片请求 → 七牛 CDN(未动)

双栈并行是这次切流的核心策略,后面细说。

第一步:勘查与备份

动手前先只读勘查:项目路径、Python/Django 版本、WSGI 服务器、数据库、静态目录、nginx 配置全文、托管方式、定时任务。老站全程只读,一根头发不动。

备份三件套:代码 + 数据库 + 静态目录。SQLite 的热备份用官方 API,不锁库:

python3 -c "import sqlite3; s=sqlite3.connect('db.sqlite3'); d=sqlite3.connect('backup.sqlite3'); s.backup(d)"

传输用流式 tar,一步到位:

ssh ... "tar czf - --exclude=__pycache__ -C /项目目录 ." | tar xzf - -C /本地目录/

备份必须校验:数据库跑 PRAGMA integrity_check;静态目录逐文件比对清单(大小+路径),上千个文件一个不能少。

第二步:本地部署

Docker Compose 三个服务:web(Django + gunicorn)、nginx(反代)、acme(证书,一次性任务)。几个关键决策:

  • 版本锁定:基础镜像用与源站一致的 Python 小版本,避免“本地能跑线上炸”
  • SQLite 单 worker + 多线程:SQLite 单写者,gunicorn 多 worker 偶发 database is locked,用 1 worker × 4 线程
  • 静态目录绑定挂载,不要重新 collectstatic:富文本编辑器从 INSTALLED_APPS 移除后,其资源无法被重新收集,必须把源站已收集好的 static/ 原样挂进去
  • HTTP 优先启动:与源站现状一致,没签证书也能先跑;证书就绪后再注入 443 配置
  • settings 最小改动:只加 localhost 和反代 SSL 头两个补丁

一键部署脚本串起:build → up → 等 gunicorn 就绪 → migrate → 验收。

第三步:外网接入——IPv6 + DDNS

家宽没有固定 IP,但有公网 IPv6(浏览器开 test-ipv6.com 一测便知)。方案:DDNS 把域名的 AAAA 记录指向家里当前的 IPv6,每 5 分钟更新一次。

DDNS 脚本有两个设计要点,都是踩坑踩出来的:

  • 只选永久地址:系统的 IPv6 隐私扩展会生成几小时轮换一次的临时地址,选中它,解析记录几小时后必然失效。过滤条件:排除 SuffixOrigin=Random,优先永久 SLAAC 地址
  • 健康闸门:更新 DNS 前先确认“站点真的在服务”——Docker 守护进程可达 + 相关容器在跑 + 本地 HTTP 探测返回 200。三层全过才更新,否则安静跳过。为什么要加 HTTP 探测?容器“活着”但服务 502 的半死状态真实存在,只看容器状态会误判

切流策略:双栈并行,IPv4 最后切。先把 AAAA 指向新家(IPv6 用户切过去),A 记录留在旧服务器(IPv4 用户无感知),观察几天没问题再动 A。回滚只需删掉 AAAA,秒级生效;旧服务器保留 1–2 周。

踩坑实录

这次真正的经验都在这一节,按“现象 → 根因 → 解法”记录。

1. Docker Hub 连不上

pull 超时,镜像仓库域名被解析到可疑地址——典型的 DNS 污染。解法:镜像加速器前缀拉取,再打标准标签:

docker pull docker.1ms.run/library/python:3.10-slim
docker tag docker.1ms.run/library/python:3.10-slim python:3.10-slim

2. Windows 上 Docker 引擎起不来(三连坑)

现象都是引擎卡在启动、日志 backend is not running,但根因一层比一层深:

  • 坑一:“虚拟机平台”/WSL 可选功能没启用。管理员运行 dism 启用两项功能后重启。注意:dism 返回 3010 是“成功且需重启”的意思,不是失败(ERROR_SUCCESS_REBOOT_REQUIRED),我的第一版脚本就误报了
  • 坑二:功能启了也重启了,还是起不来——WSL2 内核文件缺失。下载官方的 WSL 更新包安装即可
  • 坑三:安装器没把 docker 加进 PATH,手动补

3. PowerShell 5.1 的三个暗坑

  • 传参吃双引号:把带双引号的代码传给 python 等原生程序,引号会被吃掉导致语法错误。绕法:代码里用单引号
  • 中文乱码:脚本必须存 UTF-8 with BOM,并设置控制台输出编码;curl 的输出落盘再用 UTF-8 读
  • 函数内管道输出会“消失”:$x = 函数名 会把函数内所有管道输出吸进变量,只有 Write-Host 能显示到屏幕。函数内展示内容一律用 Write-Host

4. 双击 .ps1 弹“用什么应用打开”

Windows 默认把 .ps1 关联到记事本(安全设计)。解法:用 .cmd 批处理包装,内部带 -ExecutionPolicy Bypass,双击必执行。

5. IPv6 测试“不通”的冤案

curl -6 外网全失败,但 .NET 的 TCP 测试全通。真相:本机有代理环境变量,curl 走了不走 IPv6 的本地代理。测试一律加 --noproxy '*'。

6. 验收脚本连报五个 FAIL

全是脚本 bug 不是站点 bug:中文编码(同坑 3);目录有 index.html 时 nginx 优先返回页面而非目录列表(与源站行为一致,是预期写错);301 跳转的 Location 是 Host 头对应的绝对 URL。教训:验收失败先怀疑脚本,用 curl 看原始响应再下结论。

一个小技巧:怎么判断连的是哪台机器

新旧站内容完全相同时,给新站 nginx 加一个独有的响应头:

add_header X-Served-By "home-local" always;

curl -I 或浏览器 F12 → Network → Response Headers 一见便知。迁移结束、旧站下线后可删。

经验总结

  1. 搬数据不是重点,“外网怎么进”才是——这次真正的功课是 IPv6 + DDNS + 双栈切流,文件一晚上就传完了
  2. 环境类的坑(镜像源、WSL2、编码、文件关联)值一篇文档,下次照着跳省几小时
  3. 永远先想好回滚——能从容双栈观察,靠的就是“旧站原样不动 + 删一条记录就回去”

目前状态:IPv6 访客已在新家,IPv4 还在旧站,DDNS 自动维护中。待办:每日数据库备份、HTTPS 证书、观察后切 A 记录。

Last Modified·2026年10月22日 21:37

暂无评论

您尚未登录,请先才能评论。