【案例共创】基于华为开发者空间云主机部署Typora高效内容创作，实现图片自动上传-优快云博客

本案例由开发者：徐建国提供

一、概述

1. 案例介绍

在日常技术博文的创作实践中，内容产出效率与写作体验往往受到编辑工具的显著制约。长期以来，许多创作者依赖 Microsoft Word 这类传统文档处理器。然而，这种看似强大的工具在技术写作的特定场景下却暴露了明显的短板：频繁的手动排版调整（如代码块缩进、标题层级）、反复的字体字号设置、以及处理图表与文字的复杂交互，常常会无情地打断流畅的思维链条。这些看似琐碎的操作累积起来，极大地消耗了作者的精力和时间，使得核心的技术思考与表达效率大打折扣，创作过程变得滞涩而低效。

为了应对这一挑战，Markdown（简称 md）作为一种轻量级标记语言，凭借其简洁、专注文本内容本身的特性，迅速成为技术社区青睐的写作方式。它使用简单的符号（如 # 表示标题， * 表示列表， ``` 包裹代码块）即可实现清晰的结构化排版，作者无需频繁切换鼠标与键盘进行格式设置，能够将注意力高度集中于技术内容的构思与撰写上。这种“所见即所想”的模式显著提升了写作的专注度和行文速度，让创作回归到表达的核心。

然而，Markdown 在带来高效编辑体验的同时，也并非完美无缺，其图片管理环节的繁琐性构成了一个普遍存在的痛点。在 Markdown 中插入一张图片，不仅需要编写正确的 ![]() 语法，更关键且麻烦的是图片本身的存储与路径管理：图片文件需要物理存放于本地特定目录或上传至第三方图床服务，并确保链接的长期有效性和可访问性。处理多张图片、批量上传、路径维护、图床选择与配置等操作，常常让作者从纯粹的写作状态中抽离出来，陷入文件管理的泥沼。这种上下文切换和额外的操作步骤，部分抵消了 Markdown 在纯文本编辑环节带来的效率增益，成为优化技术写作全流程中亟待解决的关键问题。

因此，对于追求高效的技术创作者而言，拥抱 Markdown 是提升编辑效率的重要一步，但如何更优雅、更自动化地解决图片存储与管理问题，则是进一步提升整体创作流畅度和体验的关键所在。

PicGo 是一款开源的跨平台图床工具，支持拖拽/复制粘贴快速上传图片到多种主流图床（如 SM.MS、GitHub 等），并自动生成图片链接（Markdown / HTML 等格式），极大简化了 Markdown 写作中的配图流程。

本方案基于华为开发者空间 - 云主机环境，部署并配置 Markdown 编辑器 Typora 与图床工具 PicGo，通过对接华为云对象存储服务 (OBS)，实现技术写作中图片的自动化上传与管理。

2. 适用对象

个人开发者
高校学生

3. 案例时间

本案例总时长预计60分钟。

4. 案例流程

说明：

领取华为开发者空间 - 云主机；
登录华为控制台购买华为云 - 对象存储服务 OBS；
配置AK/SK签名认证；
安装md编辑器typora与图床工具picgo，配置AK/SK、OBS桶参数
测试验证图片自动上传功能。

5. 资源总览

本案例预计花费0元。

资源名称	规格	单价（元）	时长（分钟）
华为开发者空间 - 云主机	鲲鹏通用计算增强型 kc2 \| 4vCPUs \| 8G \| Ubuntu	免费	60
华为云 - 对象存储服务 OBS	对象存储服务 OBS \| 标准存储 \| 多AZ存储	3（按需计费）	60

二、资源准备与环境配置

1. 开发者空间配置

面向广大开发者群体，华为开发者空间提供一个随时访问的“开发桌面云主机”、丰富的“预配置工具集合”和灵活使用的“场景化资源池”，开发者开箱即用，快速体验华为根技术和资源。

如果还没有领取云主机进入华为开发者空间工作台界面后点击配置云主机，选择Ubuntu操作系统。

在华为开发者空间工作台界面，点击打开云主机 > 进入桌面连接云主机。

2. 购买华为云OBS

在华为开发者空间云主机桌面打开火狐浏览器，登录华为云官网首页，在页面顶部点击控制台，进入控制台页面。

在控制台页面左上角打开服务列表，选择所有服务 > 存储，在右侧的服务列表中选择对象存储服务OBS。

对象存储服务OBS页面，点击桶列表右上角创建桶。

在桶列表/创建桶页面配置基础配置 - 区域，桶配置依次配置桶名称、存储类别、桶策略。点击右下角立即创建。

参数说明：

配置项	规则描述	示例
区域	桶创建成功后不支持变更区域，请谨慎选择。相同区域资源之间内网相通。选择靠近您业务的区域可降低网络时延，提高访问速度。	华北-北京四
桶名称	需全局唯一，不能与已有的任何桶名称重复，包括其他用户创建的桶。用户删除桶后，立即创建同名桶或并行文件系统会创建失败，需要等待30分钟才能创建。长度范围为3到63个字符，支持小写字母、数字、中划线（-）、英文句号（.）。禁止两个英文句号（.）相邻，禁止英文句号（.）和中划线（-）相邻，禁止以英文句号（.）和中划线（-）开头或结尾。禁止使用IP地址。	dtse-mirrors
存储类别	创建桶时选择的存储类别会作为上传对象的默认存储类别。了解存储类别差异请官网查看。	标准存储
桶策略	任何用户都可以对桶内对象进行读/写/删除操作。有可能产生预期外的公网流量费用，详见官网计费说明。	公共读写

此时，对象存储服务OBS页面，桶列表中新增了上一步创建的dtse-mirrorsOBS桶。

点击桶名称进入OBS桶列表/对象页面，在对象中点击新建文件夹，编辑名称，点击确定，创建文件夹路径。

注：若之前已经购买过OBS桶，未开通公共读写。可以在文件夹路径右侧操作栏点击更多，选择配置对象策略。在OBS桶列表/桶策略页面点击创建，编辑创建对象桶策略（被授权用户选择“所有账号”）。

返回OBS桶列表/概览页面，获取Endpoint(终端节点)。

至此OBS桶创建完成，我们在此步骤中获取到几个关键数据：

桶名称：dtse-mirrors Endpoint(终端节点)：obs.cn-north-4.myhuaweicloud.com 路径：对象/img/huawei

此三个数据注意保存，后续Picgo配置中会用到。

3. 配置AK/SK签名认证

在华为开发者空间云主机桌面打开火狐浏览器，登录华为云，在顶部菜单栏点击控制台，进入华为云控制台页面。

在华为云控制台页面，将鼠标悬浮于账号信息（注意，不要点击），在弹出的菜单中选择我的凭证，进入我的凭证页面。

在我的凭证页面，点击左侧菜单栏的访问密钥，在右侧访问密钥界面点击新增访问密钥，弹出新增访问密钥的信息配置对话框。

填写描述信息，并勾选“我已悉知，为账号创建访问密钥会带来的风险”，点击下方的继续创建按钮，完成访问密钥的创建。

访问密钥创建成功后，会弹出创建成功对话框，点击下方的立即下载，打开记录密钥信息的credentials.csv文件。

文件中Access Key Id即为AK，Secret Access Key即为SK。

AK是Access Key（访问密钥）的缩写, 用于标识用户身份的唯一ID, 通常公开传输；
SK是Secret Key（秘密密钥）的缩写，用于生成请求签名的保密密钥，仅用户和服务端持有。其核心功能是通过对称加密机制验证请求发送者的合法性，防止未授权访问。

AK/SK注意保存，后续Picgo配置中会用到。

三、安装配置typora与picgo，实现图片自动上传

1. 下载安装typora

通过wget命令从typora官网下载linux版本*.deb安装包，然后通过dpkg进行安装，具体命令如下：

sudo wget -O typora.deb https://downloads.typoraio.cn/linux/typora_1.10.8_arm64.deb
sudo dpkg -i typora.deb

2. 安装配置picgo

2.1 安装picgo

通过npm install命令全局安装picgo

sudo npm install -g picgo

2.2 安装picgo插件

通过picgo install命令下载插件picgo-plugin-huawei，具体指令如下：

picgo install picgo-plugin-huawei

2.3 配置picgo图床uploader参数

通过picgo set命令进入uploader配置界面，具体指令如下：

picgo set uploader

根据提示，选择huaweicloud - uploader。完成后进入下一步配置参数：

参考上图windows版本picgo配置界面，需要配置项的顺序依次为AK、SK、桶名称、Endpoint(终端节点)、对象（存储路径）。

根据步骤“二、资源准备与环境配置”中获取到的具体参数依次进行配置。非必填项可以回车跳过。

配置完成后通过picgo use命令将该uploader设置成默认，具体指令如下：

picgo use uploader

2.4 测试picgo上传图片

通过picgo upload命令，实现图片上传，具体指令如下：

picgo upload 文件路径

3. 配置typora

3.1 配置偏好设置

在华为开发者空间云主机桌面，左下角所有应用程序 > 办公 > Typora，打开typora编辑器。

在typora编辑器界面打开文件 > 偏好设置,

在偏好设置界面，左侧选择图像，右侧图像配置界面插入图片时...配置项，在其下拉选项中选择“上传图片”，并勾选“对本地位置的图片应用上述规则”、“对网络位置的图片应用上述规则”；配置项图片语法偏好中勾选“插入时自动转义图片URL”；配置项上传图片设定中上传服务选择“自定义命令”，命令填写picgo upload；