一条 Docker SFTP,补上「把博客搬回家」的外网发布最后一环。
外网也能传:用 Docker SFTP 把静态站点直推到家宽服务器
一、缘起:为什么需要一条外网上传通道
把博客搬回家之后,nginx 已经用 location /jameszhu/ + alias 动态托管 D:/web/app/jameszhu/AI-Teaching/ 下的静态站点(autoindex on),加子站零配置——只要把文件丢进那个目录,外网立刻就能以 http://siliu.online/jameszhu/<子目录>/ 访问。
但之前这个目录只能在内网、在本机去放。出门在外想更新个演示页、传个静态作品,就没有通道。于是目标很明确:从外网把静态站点传到 D:/web/app/jameszhu/AI-Teaching/,并且不改一行业 nginx 配置。
二、为什么不开主机 SSH
最先想到的「开个 SSH 传文件」被我自己否了,原因有三:
- 本机压根没装 Windows OpenSSH,也不打算装;
- 开 22 端口等于把整台 Windows 暴露出去,权限粗、风险大;
- 我真正要的只是「把文件传到某一个目录」,用容器隔离出来的纯 SFTP 服务更干净——文件落到指定目录就完事,碰不到系统的其他部分。
三、方案:atmoz/sftp 容器
atmoz/sftp 是一个极简的 SFTP-only 镜像:自带 chroot 监狱,等价于 ForceCommand internal-sftp,没有 shell、也没有 scp 服务端。把它作为 web / nginx 同工程里的一个服务一起 up 即可。
docker-compose.yml 里新增的片段(真实配置,密码处隐去):
# SFTP 上传服务:从外网把静态站点传到 D:/web/app/jameszhu/AI-Teaching
# 与 nginx 共用同一宿主机目录(本容器 :rw,nginx :ro),无需改 nginx 配置。
sftp:
image: atmoz/sftp:latest
restart: unless-stopped
ports:
- "2222:22"
volumes:
- ../app/jameszhu/AI-Teaching:/home/sftpuser/upload:rw
# 免密登录(可选):把客户端公钥 id_ed25519.pub 放进 ./sftp-keys/ 后取消下一行注释
# - ./sftp-keys:/home/sftpuser/.ssh/keys:ro
# 格式: 用户:密码:uid:gid:家目录(chroot 根,容器 root 拥有、不可写)
# 数据挂在 /home/sftpuser/upload,登录后 cd upload 进入 AI-Teaching
command: sftpuser:********:1000:1000:/home/sftpuser
几个要点:
- 端口
2222:22:对外是 2222,容器里才是 22,主机 22 纹丝不动,Windows 自带 SSH 服务依旧关着。 - 挂载
../app/jameszhu/AI-Teaching:/home/sftpuser/upload:rw:写权限。 command的格式是用户:密码:uid:gid:家目录。chroot 根是/home/sftpuser(容器 root 拥有、不可写),真正的数据在upload子目录;登录后cd upload就到了AI-Teaching。
四、挂载设计的关键:nginx 只读 + sftp 可写
同一份宿主目录,被两个容器以不同视图挂载,这是「零配置」的核心:
| 容器 | 挂载 | 视图 | 职责 |
|---|---|---|---|
| nginx | ../app/jameszhu/AI-Teaching:/srv/jameszhu/AI-Teaching:ro |
只读 | 对外提供 HTTP 访问 |
| sftp | ../app/jameszhu/AI-Teaching:/home/sftpuser/upload:rw |
可写 | 接收外网上传 |
两个容器挂同一个宿主路径,一个只读、一个可写,互不冲突:
- sftp 负责「写」——外网上传进来;
- nginx 负责「读」——立刻对外服务。
文件一落到宿主目录,nginx 无需 reload 就能以 http://siliu.online/jameszhu/<子目录>/ 提供出来。这也是为什么前面说「不改 nginx 配置」:这条上传通道挂上去之前,/jameszhu/ 的托管早就准备好了。
五、镜像拉取的小坑
Docker Hub 直连超时;试了 docker.m.daocloud.io(该镜像不在白名单)和 docker.nju.edu.cn(403),都不行。最终走 docker.1ms.run/atmoz/sftp:latest 拉取成功,再 docker tag 回 atmoz/sftp:latest(沿用旧站迁移时攒下的镜像源经验)。
六、客户端怎么连
命令行 pscp(PuTTY 自带)
三个坑,踩过才记住:
- atmoz 是纯 SFTP,没有 scp 服务端,必须加
-sftp强制走 SFTP 协议,否则报no such file; - 远程路径要写绝对路径
/upload/...(写相对upload/在 pscp 下同样报no such file); - 首次连接主机密钥未缓存,加
-hostkey "SHA256:..."。
示例(密码与 hostkey 以占位符表示):
pscp -sftp -P 2222 -pw <密码> -hostkey "SHA256:..." ^
index.html sftpuser@siliu.online:/upload/AI-Teaching/demo/index.html
注意登录后的家目录是 chroot 根,目标要从 /upload/ 起算。
图形化:FileZilla / WinSCP
- 协议选 SFTP;主机
siliu.online,端口2222,用户名sftpuser,密码登录; - 登录后把远程默认目录设为
/upload,就能像普通 FTP 一样拖文件了。
密码 vs 密钥
当前是密码认证,简单够用。想更稳更省心,取消 compose 里 ./sftp-keys 那行注释,把客户端公钥 id_ed25519.pub 放进 D:/web/deploy/sftp-keys/,再 docker compose up -d sftp 即可改密钥登录(atmoz 会扫描 .ssh/keys 下的所有公钥)。
七、端到端验证
用 pscp 上传一个 sftp_test.txt → 确认落盘到 D:/web/app/jameszhu/AI-Teaching/sftp_test.txt → 再 curl -6 http://siliu.online/jameszhu/sftp_test.txt 返回 200 且内容一致 → 整条链路通。验证完清理掉测试文件。
八、安全与待办
- 这个静态目录不在
backup-db.ps1的备份范围(备份只含 db + media)。如果里面有需要长期保留的演示站点,要自行安排备份。 - 密码建议定期更换;长期方案是改成密钥登录。
- 因为是 chroot 监狱 + nginx 只读视图,即便凭证泄露,攻击者能动的也只有
AI-Teaching这一个目录,影响面可控。
小结
一条 Docker SFTP,把「外网 → 家宽服务器指定目录」打通,并且:
- 不动主机 22、不开 Windows SSH;
- 不碰 nginx 配置(已有的
/jameszhu/动态托管直接复用); - 上传即对外可见,端到端验证通过。
这算是「把博客搬回家」之后,顺手补齐的外网发布最后一环。
定稿于 2026.11.03
本书目录
- 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 把静态站点直推到家宽服务器