<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>BlogPad on atin的个人小站</title><link>https://atin.asia/tags/blogpad/</link><description>Recent content in BlogPad on atin的个人小站</description><generator>Hugo -- gohugo.io</generator><language>zh-cn</language><lastBuildDate>Wed, 11 Nov 2026 21:50:00 +0800</lastBuildDate><atom:link href="https://atin.asia/tags/blogpad/index.xml" rel="self" type="application/rss+xml"/><item><title>BlogPad：在手机上写完 Markdown，SSH 直发自己的 Hugo 站</title><link>https://atin.asia/archives/blogpad-phone-hugo/</link><pubDate>Wed, 11 Nov 2026 21:50:00 +0800</pubDate><guid>https://atin.asia/archives/blogpad-phone-hugo/</guid><description>&lt;img src="https://atin.asia/upload/blogpad-cover-v3.jpg" alt="Featured image of post BlogPad：在手机上写完 Markdown，SSH 直发自己的 Hugo 站" /&gt;&#10; &lt;blockquote&gt;&#10; &lt;p&gt;官网与下载：&lt;strong&gt;&lt;a class="link" href="https://atin.asia/blogpad/" target="_blank" rel="noopener"&#10; &gt;https://atin.asia/blogpad/&lt;/a&gt;&lt;/strong&gt; ｜ 源码：&lt;strong&gt;&lt;a class="link" href="https://github.com/aixtin/blogpad" target="_blank" rel="noopener"&#10; &gt;https://github.com/aixtin/blogpad&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;&#10;&#10; &lt;/blockquote&gt;&#10;&lt;p&gt;写博客这件事，最后卡住人的往往不是没想法，而是&amp;quot;要发出去&amp;quot;的那几步：打开电脑、登后台、贴 Markdown、点发布、等构建。想法在手机上冒出来的时候，这一套流程基本等于劝退。&lt;/p&gt;&#10;&lt;p&gt;所以我把最常用的那一段单独拆出来做了一个 App：&lt;strong&gt;BlogPad&lt;/strong&gt;，一个只干一件事的 Android 写作台——在手机上写 Markdown，通过 SSH 把文件传到自己的 Hugo 站点，跑一条构建命令，拿回文章地址。全程没有后台、没有数据库、没有第三方服务。&lt;/p&gt;&#10;&lt;h2 id="为什么不再套一层后台"&gt;为什么不再套一层后台&#10;&lt;/h2&gt;&lt;p&gt;常见的路子是给站点配个 Web 后台或者 Headless CMS，手机上用浏览器登进去写。这类方案功能全，但代价是：一套运行时、一个数据库、一个登录入口，以及一堆需要长期维护的依赖。对于一台只放静态文件的 Hugo 站点来说，这些都不必要——文章的真相就是 &lt;code&gt;content/post&lt;/code&gt; 下的一个 &lt;code&gt;.md&lt;/code&gt; 文件，发布就是把文件放对位置、再跑一次 &lt;code&gt;hugo&lt;/code&gt;。&lt;/p&gt;&#10;&lt;p&gt;BlogPad 就是照这个事实做的：&lt;/p&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;首页列出的，是远端 &lt;code&gt;content/post&lt;/code&gt; 里真实存在的文章，不是任何数据库里的副本；&lt;/li&gt;&#10;&lt;li&gt;发布 = SFTP 上传 Markdown + 在同一会话里执行你填的构建命令；&lt;/li&gt;&#10;&lt;li&gt;成功后返回文章链接，失败就撤销这次上传。&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;p&gt;没有同步冲突，因为不存在第二份数据。&lt;/p&gt;&#10;&lt;h2 id="一次发布实际发生了什么"&gt;一次发布实际发生了什么&#10;&lt;/h2&gt;&lt;p&gt;点&amp;quot;发布&amp;quot;之后，App 做的事很朴素：&lt;/p&gt;&#10;&lt;ol&gt;&#10;&lt;li&gt;按 Hugo 规范生成 front matter（标题、日期、draft、slug、categories、tags）；&lt;/li&gt;&#10;&lt;li&gt;通过 SFTP 把文件写到远端文章目录；&lt;/li&gt;&#10;&lt;li&gt;复用同一条 SSH 会话执行构建命令，比如 &lt;code&gt;hugo --gc --minify&lt;/code&gt;；&lt;/li&gt;&#10;&lt;li&gt;从构建输出里取回文章地址，失败则回滚。&lt;/li&gt;&#10;&lt;/ol&gt;&#10;&lt;p&gt;第 3 步是关键：&lt;strong&gt;传输和构建走同一条连接&lt;/strong&gt;。如果分成两次连接，中间任何一次握手失败都会把站点留在&amp;quot;文件已上传、页面还没生成&amp;quot;的半坏状态——访客看到的是 404，而你以为发出去了。&lt;/p&gt;&#10;&lt;h2 id="几个我较真过的细节"&gt;几个我较真过的细节&#10;&lt;/h2&gt;&lt;h3 id="front-matter-是生成出来的不是让你背的"&gt;front matter 是生成出来的，不是让你背的&#10;&lt;/h3&gt;&lt;p&gt;标题、日期、草稿标记、slug、分类、标签都做成表单字段，落盘时按 Hugo 的格式写。改一篇旧文章时，远端 &lt;code&gt;.md&lt;/code&gt; 会被载回表单原处编辑；把 slug 改掉，App 会重命名远端文件并清掉旧文件，不会留下两份。表单不认识的 front matter 键原样保留，方便你手写过自定义字段。&lt;/p&gt;&#10;&lt;h3 id="构建失败必须能退回去"&gt;构建失败必须能退回去&#10;&lt;/h3&gt;&lt;p&gt;发布链路上最怕的不是报错，是报错之后什么都不说。所以构建命令返回非零时，App 会撤销本次上传的文件，站点回到发布前的样子，然后告诉你失败在哪一步。宁可这次没发出去，也不要留一个半成品在线。&lt;/p&gt;&#10;&lt;h3 id="主机指纹认一次之后不认别人"&gt;主机指纹认一次，之后不认别人&#10;&lt;/h3&gt;&lt;p&gt;首次连接会把服务器的主机密钥 SHA-256 指纹显示出来，要求你比对确认后保存。之后指纹对不上就直接拒连——SSH 客户端该有的基本防护，不该因为是手机 App 就省掉。&lt;/p&gt;&#10;&lt;h3 id="版本检查不碰-api-限流"&gt;版本检查不碰 API 限流&#10;&lt;/h3&gt;&lt;p&gt;关于页要显示&amp;quot;有没有新版本&amp;quot;。做法是读 GitHub &lt;code&gt;releases/latest&lt;/code&gt; 的 302 跳转，从 Location 里取 tag，而不是调 GitHub API——匿名 API 每小时只有 60 次，共享出口很容易被限流误判。再叠加 24 小时节流和&amp;quot;同版本只提示一次&amp;quot;，避免每次启动都弹窗。&lt;/p&gt;&#10;&lt;h2 id="安装与配置"&gt;安装与配置&#10;&lt;/h2&gt;&lt;p&gt;安装包只从两个地方发：官网 &lt;strong&gt;&lt;a class="link" href="https://atin.asia/blogpad/" target="_blank" rel="noopener"&#10; &gt;https://atin.asia/blogpad/&lt;/a&gt;&lt;/strong&gt; 的站内直链（国内网络可直接下），以及 &lt;strong&gt;GitHub Releases&lt;/strong&gt;。两边是同一份构建，SHA-256 一致；其它来源的安装包没有校验，不建议装。&lt;/p&gt;&#10;&lt;p&gt;配置只有三步：&lt;/p&gt;&#10;&lt;ol&gt;&#10;&lt;li&gt;&lt;strong&gt;连接&lt;/strong&gt;：设置里填主机、端口、用户名，选私钥（OpenSSH ed25519 / RSA）或密码；&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;站点&lt;/strong&gt;：填站点根目录、文章目录（通常是 &lt;code&gt;content/post&lt;/code&gt;）和构建命令（比如 &lt;code&gt;hugo --gc --minify&lt;/code&gt;），首次连接比对指纹后保存；&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;写&lt;/strong&gt;：新建 → 填标题和正文 → 发布。&lt;/li&gt;&#10;&lt;/ol&gt;&#10;&lt;p&gt;如果服务器只开了本机端口，可以用 &lt;code&gt;adb reverse&lt;/code&gt; 把手机的 2222 端口转发到开发机 22，主机填 &lt;code&gt;127.0.0.1&lt;/code&gt;；长期使用更省事的是接 WireGuard，直接填内网地址。&lt;/p&gt;&#10;&lt;h2 id="技术参数"&gt;技术参数&#10;&lt;/h2&gt;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;项&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;值&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;包名&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;io.github.aixtin.blogpad&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;版本&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;v1.5.1（versionCode 4）&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;体积&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;约 3.9 MB&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;系统&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Android 8.0（minSdk 26）及以上&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;技术栈&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Kotlin + AndroidX，SSH/SFTP 用 JSch&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;许可&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;MIT&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;分发&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;本站直链 + GitHub Releases，不上任何第三方应用商店&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;h2 id="它不做什么"&gt;它不做什么&#10;&lt;/h2&gt;&lt;p&gt;不做多端同步、不做图床、不做评论、不做数据分析。它假定你已经有一个能构建的 Hugo 站点，也假定你愿意拿一手 SSH 凭据去换掉一整套后台。如果你要的是&amp;quot;注册就能写&amp;quot;的平台，那它不合适；如果你要的是&amp;quot;文件写到自己机器上、发完就走&amp;quot;，它正好。&lt;/p&gt;&#10;&lt;p&gt;官网与下载：&lt;strong&gt;&lt;a class="link" href="https://atin.asia/blogpad/" target="_blank" rel="noopener"&#10; &gt;https://atin.asia/blogpad/&lt;/a&gt;&lt;/strong&gt;&#10;源码与版本历史：&lt;strong&gt;&lt;a class="link" href="https://github.com/aixtin/blogpad" target="_blank" rel="noopener"&#10; &gt;https://github.com/aixtin/blogpad&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;&#10;</description></item></channel></rss>