家里没有公网 IPv4,那就换一条路:IPv6 直连,全程不经过 NAT。
缘起
博客在云服务器上跑了几年,续费年年涨,数据却在别人机器里。正好家里宽带有了公网 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 一见便知。迁移结束、旧站下线后可删。
经验总结
- 搬数据不是重点,“外网怎么进”才是——这次真正的功课是 IPv6 + DDNS + 双栈切流,文件一晚上就传完了
- 环境类的坑(镜像源、WSL2、编码、文件关联)值一篇文档,下次照着跳省几小时
- 永远先想好回滚——能从容双栈观察,靠的就是“旧站原样不动 + 删一条记录就回去”
目前状态:IPv6 访客已在新家,IPv4 还在旧站,DDNS 自动维护中。待办:每日数据库备份、HTTPS 证书、观察后切 A 记录。
定稿于 2026.10.22
本书目录
- 01 把网站从云服务器搬回家里:Django + Docker + IPv6 DDNS 迁移实录
- 02 评论功能迁移完善:把四处 site-packages 补丁收拢为 sitecomments 自定义 app
- 03 为什么 AAAA 记录指向家里的 IPv6 地址,外网就能直接访问
- 04 外网打不开、本机却正常:一次 IPv6 静默断网三小时的完整复盘
- 05 用 Markdown 写博客:一篇示例,也是本站的格式说明
- 06 给博客加上 Markdown:一个字段、两套渲染层,和一堆必须小心的地方
- 07 把编辑器打磨顺手:去掉多余确认、对齐宽度,让评论也用上 Markdown
- 08 收尾两件事:评论只剩 Markdown,代码高亮只剩一套
- 09 编辑栏合并成一套,顺手补上撤销重做
- 10 博客媒体全面上云:CDN 域名统一与纯云存储改造
- 11 把博客升级到 Django 4.2 LTS:一次低风险、却有意外收获的升级
- 12 网站优化记录:存储后端本地化与 Markdown 编辑器统一
- 13 把文章编成书:给博客加一个「文集」板块
- 14 网站开发里程碑小结:siliu.online 的架构与特点
- 15 小结之后的继续打磨:PDF 导出、悬浮目录与后台收尾
- 16 本站功能与使用指南:siliu.online 一览
- 17 外网也能传:用 Docker SFTP 把静态站点直推到家宽服务器