Featured image of post BlogPad:在手机上写完 Markdown,SSH 直发自己的 Hugo 站

BlogPad:在手机上写完 Markdown,SSH 直发自己的 Hugo 站

没有后台、没有数据库、没有第三方服务——一个 4 MB 的安卓写作台,写完直接推到自己服务器上的 Hugo 站点。下载与说明见官网 atin.asia/blogpad。

官网与下载:https://atin.asia/blogpad/ | 源码:https://github.com/aixtin/blogpad

写博客这件事,最后卡住人的往往不是没想法,而是"要发出去"的那几步:打开电脑、登后台、贴 Markdown、点发布、等构建。想法在手机上冒出来的时候,这一套流程基本等于劝退。

所以我把最常用的那一段单独拆出来做了一个 App:BlogPad,一个只干一件事的 Android 写作台——在手机上写 Markdown,通过 SSH 把文件传到自己的 Hugo 站点,跑一条构建命令,拿回文章地址。全程没有后台、没有数据库、没有第三方服务。

为什么不再套一层后台

常见的路子是给站点配个 Web 后台或者 Headless CMS,手机上用浏览器登进去写。这类方案功能全,但代价是:一套运行时、一个数据库、一个登录入口,以及一堆需要长期维护的依赖。对于一台只放静态文件的 Hugo 站点来说,这些都不必要——文章的真相就是 content/post 下的一个 .md 文件,发布就是把文件放对位置、再跑一次 hugo。

BlogPad 就是照这个事实做的:

  • 首页列出的,是远端 content/post 里真实存在的文章,不是任何数据库里的副本;
  • 发布 = SFTP 上传 Markdown + 在同一会话里执行你填的构建命令;
  • 成功后返回文章链接,失败就撤销这次上传。

没有同步冲突,因为不存在第二份数据。

一次发布实际发生了什么

点"发布"之后,App 做的事很朴素:

  1. 按 Hugo 规范生成 front matter(标题、日期、draft、slug、categories、tags);
  2. 通过 SFTP 把文件写到远端文章目录;
  3. 复用同一条 SSH 会话执行构建命令,比如 hugo --gc --minify;
  4. 从构建输出里取回文章地址,失败则回滚。

第 3 步是关键:传输和构建走同一条连接。如果分成两次连接,中间任何一次握手失败都会把站点留在"文件已上传、页面还没生成"的半坏状态——访客看到的是 404,而你以为发出去了。

几个我较真过的细节

front matter 是生成出来的,不是让你背的

标题、日期、草稿标记、slug、分类、标签都做成表单字段,落盘时按 Hugo 的格式写。改一篇旧文章时,远端 .md 会被载回表单原处编辑;把 slug 改掉,App 会重命名远端文件并清掉旧文件,不会留下两份。表单不认识的 front matter 键原样保留,方便你手写过自定义字段。

构建失败必须能退回去

发布链路上最怕的不是报错,是报错之后什么都不说。所以构建命令返回非零时,App 会撤销本次上传的文件,站点回到发布前的样子,然后告诉你失败在哪一步。宁可这次没发出去,也不要留一个半成品在线。

主机指纹认一次,之后不认别人

首次连接会把服务器的主机密钥 SHA-256 指纹显示出来,要求你比对确认后保存。之后指纹对不上就直接拒连——SSH 客户端该有的基本防护,不该因为是手机 App 就省掉。

版本检查不碰 API 限流

关于页要显示"有没有新版本"。做法是读 GitHub releases/latest 的 302 跳转,从 Location 里取 tag,而不是调 GitHub API——匿名 API 每小时只有 60 次,共享出口很容易被限流误判。再叠加 24 小时节流和"同版本只提示一次",避免每次启动都弹窗。

安装与配置

安装包只从两个地方发:官网 https://atin.asia/blogpad/ 的站内直链(国内网络可直接下),以及 GitHub Releases。两边是同一份构建,SHA-256 一致;其它来源的安装包没有校验,不建议装。

配置只有三步:

  1. 连接:设置里填主机、端口、用户名,选私钥(OpenSSH ed25519 / RSA)或密码;
  2. 站点:填站点根目录、文章目录(通常是 content/post)和构建命令(比如 hugo --gc --minify),首次连接比对指纹后保存;
  3. 写:新建 → 填标题和正文 → 发布。

如果服务器只开了本机端口,可以用 adb reverse 把手机的 2222 端口转发到开发机 22,主机填 127.0.0.1;长期使用更省事的是接 WireGuard,直接填内网地址。

技术参数

项值
包名io.github.aixtin.blogpad
版本v1.5.1(versionCode 4)
体积约 3.9 MB
系统Android 8.0(minSdk 26)及以上
技术栈Kotlin + AndroidX,SSH/SFTP 用 JSch
许可MIT
分发本站直链 + GitHub Releases,不上任何第三方应用商店

它不做什么

不做多端同步、不做图床、不做评论、不做数据分析。它假定你已经有一个能构建的 Hugo 站点,也假定你愿意拿一手 SSH 凭据去换掉一整套后台。如果你要的是"注册就能写"的平台,那它不合适;如果你要的是"文件写到自己机器上、发完就走",它正好。

官网与下载:https://atin.asia/blogpad/ 源码与版本历史:https://github.com/aixtin/blogpad