外网也能传:用 Docker SFTP 把静态站点直推到家宽服务器

liulinhai 2026.11.3 7:48 20 0
电脑技术 Docker SFTP 家宽服务器 静态站点

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

外网也能传:用 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 自带)

三个坑,踩过才记住:

  1. atmoz 是纯 SFTP,没有 scp 服务端,必须加 -sftp 强制走 SFTP 协议,否则报 no such file;
  2. 远程路径要写绝对路径 /upload/...(写相对 upload/ 在 pscp 下同样报 no such file);
  3. 首次连接主机密钥未缓存,加 -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/ 动态托管直接复用);
  • 上传即对外可见,端到端验证通过。

这算是「把博客搬回家」之后,顺手补齐的外网发布最后一环。

Last Modified·2026年11月3日 07:48

暂无评论

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