完美整合:使用七牛云作为Typora的自动图床(Windows版)
完美整合:使用七牛云作为Typora的自动图床(Windows版)与本地备份功能
作为一名Markdown爱好者,Typora的简洁与高效无疑极大地提升了我们的写作体验。然而,手动管理文章中的图片并逐个上传到图床是一个繁琐且容易出错的过程。本文将指导Windows用户如何通过一个简单的脚本和配置,将七牛云对象存储变为Typora的专属自动图床,实现"复制即上传,粘贴即链接"的流畅体验,同时新增本地备份功能确保数据安全。
本教程分为四个核心步骤,完全针对Windows系统优化。
第一步:获取并放置上传程序
您需要一个能够与七牛云API和Typora交互的上传工具。这里我们使用一个专门为Windows编译的上传工具。
- 获取程序:
- 从可靠的来源获取Windows版的七牛云上传工具(例如
qiniu-uploader.exe) - 确保下载的工具是最新版本,以兼容当前的七牛云API
- 从可靠的来源获取Windows版的七牛云上传工具(例如
- 放置程序:
- 在您的电脑上创建一个专门的文件夹来存放该程序和配置文件,例如
D:\Typora-Qiniu\ - 将下载好的上传程序(如
qiniu-uploader.exe)放入此文件夹中
- 在您的电脑上创建一个专门的文件夹来存放该程序和配置文件,例如
第二步:创建与编辑配置文件 (config.json)
在上传程序所在的同一文件夹内,我们需要创建一个名为 config.json 的文本文件,用于告知程序如何连接您的七牛云账户以及设置本地备份。
- 创建配置文件:
- 在
D:\Typora-Qiniu\文件夹中,右键新建一个文本文档 - 将其重命名为
config.json(如果系统隐藏了扩展名,请先取消隐藏:查看 → 勾选"文件扩展名")
- 在
- 编辑配置文件:
- 使用记事本或其他文本编辑器打开
config.json文件 - 将以下JSON配置内容复制进去,并替换其中的占位符为您的实际信息
- 使用记事本或其他文本编辑器打开
1
{
2
"access_key": "这里替换成您的七牛云AK(Access Key)",
3
"secret_key": "这里替换成您的七牛云SK(Secret Key)",
4
"bucket_name": "这里替换成您的空间名称(Bucket Name)",
5
"base_url": "这里替换成您的域名,例如:http://img.example.com",
6
"base_dir": "D:\\Typora-Qiniu\\LocalImages"
7
}
参数详解与获取方式:
access_key&secret_key:这是您七牛云账户的密钥,相当于账号密码,请务必妥善保管。- 获取路径:登录七牛云后台 → 个人中心 → 密钥管理 → 查看AK/SK
bucket_name:您创建的存储空间的名字base_url:您绑定到存储空间的测试域名或自定义域名(推荐),注意要以http://或https://开头。上传成功后,图片的链接将是{base_url}/{图片文件名}base_dir:新增功能 - 本地存储路径。程序会在上传图片到七牛云的同时,在本地保留一份备份。请确保此路径存在且有写入权限(例如:D:\\Typora-Qiniu\\LocalImages)
保存并关闭 config.json 文件。
第三步:创建本地备份目录
根据您在配置文件中设置的 base_dir 路径,创建本地备份文件夹:
- 打开文件资源管理器,导航到您想要创建备份目录的位置
- 右键 → 新建 → 文件夹
- 命名为与配置中
base_dir一致的名称(例如:LocalImages) - 确保此目录有写入权限(通常默认就有)
第四步:配置Typora
最后一步是告诉Typora使用我们刚刚准备好的上传工具。
- 打开Typora设置:
- 启动Typora,点击顶部菜单栏的
文件→偏好设置
- 启动Typora,点击顶部菜单栏的
- 切换到「图像」设置页:
- 在左侧设置列表中,找到并点击 「图像」
- 进行核心配置:
- 在「上传服务」板块,进行如下设置:
- 上传服务:选择
Custom Command - 命令:填写上传程序的完整路径。例如:
D:\Typora-Qiniu\qiniu-uploader.exe
- 上传服务:选择
- 勾选「对本地位置的图片应用上述规则」
- 勾选「对网络位置的图片应用上述规则」
- 在「插入时」选择「上传图片」
- 在「上传服务」板块,进行如下设置:
- 验证配置:
- 点击「验证图片上传选项」按钮
- Typora 会尝试上传一张测试图片。如果所有配置都正确,您会看到 "验证成功" 的提示,并且会显示一张通过七牛云链接加载的图片
- 同时检查您设置的本地备份目录(如
D:\Typora-Qiniu\LocalImages)中是否也保存了测试图片的副本
开始使用!
现在,一切就已配置完毕。您可以享受行云流水般的写作体验了:
- 在Typora中,直接将剪贴板中的图片(
Ctrl+V)粘贴到文档中 - 或者拖动本地图片到文档中
- Typora会自动调用后台的上传程序,将图片上传至您配置的七牛云空间,并自动将文档中的图片地址替换为高效的云端URL
- 同时,程序会在您指定的本地目录中保留一份图片备份,确保数据安全
常见问题排查(Windows特有)
- 验证失败:
- 路径错误:确保「命令」中的程序路径使用反斜杠且完全正确,例如
D:\Typora-Qiniu\qiniu-uploader.exe - 安全软件拦截:检查您的杀毒软件或Windows Defender是否误报了上传工具,如有需要请添加例外
- 配置信息错误:仔细检查
config.json文件中的 AK、SK、Bucket名称和域名是否填写正确 - 本地目录权限:确保
base_dir指定的目录存在且有写入权限
- 路径错误:确保「命令」中的程序路径使用反斜杠且完全正确,例如
- 上传成功但图片不显示:
- 检查
base_url域名是否已正确备案并绑定到存储空间,并且网络可以正常访问
- 检查
- 本地备份未生成:
- 检查
base_dir路径是否正确且存在 - 确认程序有该目录的写入权限
- 检查路径中是否使用了双反斜杠
\\进行转义
- 检查
仓库地址:https://github.com/Sunrisies/qiniu-uploader
通过以上四步,您就成功为Windows系统下的Typora搭建了一个专业、高效的自动化写作工作流,同时享有云端访问速度和本地数据安全的双重保障,让您能够更专注于内容创作本身。
相关文章
查看同分类文章MAVLink 消息处理指南
MAVLink消息处理系统摘要 本系统实现了一套完整的MAVLink消息处理机制,用于无人机通信与控制。核心功能包括: 消息接收:通过UDP连接持续接收飞控消息,支持心跳维持机制 消息处理:分类处理多种MAVLink消息类型,包括心跳、位置、姿态和航点相关消息 航点管理:实现航点下载状态机,支持分片请求和接收航点数据 消息转发:将处理后的消息通过MQTT发布到指定主题 系统采用多线程架构,包含独立的消息接收线程和主处理循环,通过通道进行线程间通信。关键特性包括航点下载状态机、错误处理和日志记录机制,确保通信
304 浏览
M3U8 下载助手油猴脚本 - 技术实现解析
M3U8下载助手技术解析 该油猴脚本通过注入拦截脚本实现对M3U8链接的全面捕获。核心架构包括: 请求拦截层:劫持XHR、fetch和WebSocket请求 DOM监听层:通过MutationObserver监控动态元素变化 跨域通信:iframe间使用postMessage传递数据 UI展示层:提供浮动按钮等交互界面 关键技术点: 使用document-start确保早期注入 通过保存原始方法实现API劫持 在send时而非open时检测URL 全面覆盖各种属性(src/href/data-src等) 脚
362 浏览
我做了一个局域网传文件的小工具,记录一下
本文记录了作者开发局域网文件传输工具的过程。起因是工作中遇到大文件传输不便的问题,作者选择用Rust语言开发,解决了WebSocket状态管理、大文件上传限制等技术难点。最终成品通过浏览器即可使用,支持文字聊天和文件传输,内存占用低。同事们试用后反馈良好,建议增加拖拽上传等功能。作者认为Rust虽开发较繁琐但运行高效稳定,并将项目开源供社区参与改进。
291 浏览
局域网聊天工具
这是一个基于Rust和Axum框架开发的局域网实时聊天工具,支持文本聊天、图片和文件分享功能。项目采用WebSocket实现实时通信,前端使用Tailwind CSS构建界面。主要功能包括实时消息传递、文件上传下载(限制100MB)、在线用户显示和消息历史记录。部署简单,只需Rust环境,通过Cargo编译运行即可启动服务。系统架构清晰,包含后端处理、前端界面和文件存储模块,适合局域网内团队协作使用。
350 浏览