首页 / 教程目录 / 安装与初始化
part-2 · 安装与初始化

下载与安装

从桌面到掌心，把 Obsidian 装进你所有的设备

作者：Obsidian 教程编辑部 发布于 2026年7月2日

黑曜石（Obsidian）之所以迷人，在于它既能在沉甸甸的桌面主机上吞吐长文，也能在你兜里那部手机上接住一闪而过的灵感。它是为数不多真正”全平台覆盖”的笔记软件——Windows、macOS、Linux 三大桌面系统，加上 iOS、iPadOS 与 Android 两支移动阵营，一个都不落下。这一篇，我们就把这台知识引擎装到你每一台设备上。

一、先认准唯一的官方入口

请认准官网下载页：https://obsidian.md/zh/download。页面会按操作系统分块列出安装包，Windows、macOS、Linux、Android 一目了然。iOS 与 iPadOS 则跳转至 App Store。永远从官方渠道获取安装包——这既是为了避开被篡改的安装程序，也是因为 Obsidian 本身对个人与教育用途完全免费，没有任何理由去冒险。

Obsidian 的个人使用是免费的，无需注册账号即可下载安装。账号只在你想使用官方同步、发布服务，或购买 Catalyst 许可证时才需要。

二、桌面端安装

Windows

  1. 打开官网下载页，在 Windows 区块点击 Universal 下载安装包。
  2. 双击运行下载好的安装文件，按提示一步步完成安装。
  3. 安装结束后，像打开任何普通应用那样启动 Obsidian 即可。

macOS

  1. 在下载页的 macOS 区块点击 Universal 下载安装文件。
  2. 打开下载好的文件，在弹出的窗口里把 Obsidian 图标拖入”应用程序”文件夹。
  3. 之后从启动台或”应用程序”中打开它。

macOS 用户偶尔会遇到 Gatekeeper 拦截——提示”无法打开，因为来自身份不明的开发者”。这是 macOS 对未签名应用的标准保护，并非 Obsidian 特有。处理方式很常规：在”系统设置 → 隐私与安全性”中点击”仍要打开”，或对该应用右键选择”打开”即可放行。

Linux

Linux 的玩法更丰富，官方提供三种安装方式，按你的发行版习惯任选其一：

  • Snap：下载 .snap 文件后，在终端运行 snap install obsidian_<version>_<arch>.snap --dangerous --classic。其中 --dangerous 是因为 Snap 未经审核，--classic 则赋予其访问沙盒外笔记目录的权限。
  • AppImage：下载后先赋权 chmod u+x Obsidian-<version>.AppImage，再以 ./Obsidian-<version>.AppImage --no-sandbox 启动。若你在 Chromebook 上报 libnss3.so 找不到的错误，安装 libnss3-dev 包即可解决。
  • Flatpak：两行命令搞定——flatpak install flathub md.obsidian.Obsidian 安装，flatpak run md.obsidian.Obsidian 运行。

三、移动端安装

移动端的安装最省心，走应用商店即可：

  • Android：在 Google Play 商店搜索 Obsidian 点击”安装”。你也可以直接从官网下载页获取 APK 文件自行安装。
  • iPhone / iPad：在 App Store 搜索 Obsidian，点击”获取”下载。

移动端与桌面端共享同一套笔记格式与核心交互逻辑，区别只在界面布局与少量手势——这些我们会在下一篇界面认识里细聊。

四、稳定版与内测版（Catalyst）

Obsidian 的版本分两条线：

  • 稳定版（Stable Build）：经过充分测试的正式版本，绝大多数用户日常使用的就是它。默认下载的就是稳定版。
  • 内部版本（Insider Build）：包含最新功能但可能不太稳定的抢先版，需要 Catalyst 许可证才能获取。

Catalyst 是一次性付费的个人许可证，本质上是赞助开发、换取抢先体验权，分三档：Insider（25 美元）、Supporter（50 美元）、VIP（100 美元）。三档都享有”抢先体验新版本""进入专属开发频道”等权益，更高档位额外有专属徽章与休息室频道。

购买后启用内测版的方法是：在 Obsidian 中进入 设置 → 账号 登录你的账户（即可看到 Catalyst 等级），再到 设置 → 关于 中开启”接收内部版本”，然后检查更新，便能收到最新的内测推送。移动端内测版则通过 Discord 对应的 Insider 频道获取。

需要提醒的是：内测版意味着尝鲜也意味着风险，重要知识库请务必做好备份，不要在生产环境里追新。

五、系统要求与安装小贴士

Obsidian 是一款基于 Electron 的应用，体量轻盈，在主流配置的 Windows、macOS、Linux 设备上都能流畅运行；移动端则要求较新的 iOS/iPadOS 与 Android 版本。具体的最低系统版本会随官方更新而调整，以下载页当前提供的能力为准——若你的设备能顺利安装并启动，基本就能正常使用。

安装过程中如果遇到问题，几条通用排查思路：

  • 下载不完整或被拦截：换用浏览器重新下载，或检查安全软件是否误拦。
  • macOS 打不开：参考前文 Gatekeeper 放行方法。
  • Linux 缺库：AppImage 报缺少 .so 文件时，按提示用包管理器补上对应依赖（如 libnss3-dev）。
  • 安装后无法启动：先到官网更新日志确认版本是否匹配你的系统，再到官方论坛搜索报错关键词。

装好之后，下一篇我们就来聊聊 Obsidian 世界里最核心的概念——Vault（仓库）：为什么”一个文件夹就是一个知识库”。