在 Linux 服务器上搭建 Joplin 服务器 - 自建安全笔记平台
本指南的理想产品
立即开始 — 订购合适的产品，按照本指南一步一步操作。
介绍
Joplin 是一款开源的笔记和待办事项应用，支持将基于 Markdown 的笔记组织成可搜索的笔记本，并实现跨设备同步。它提供端到端加密、网页剪辑器和跨平台同步功能。非常适合注重隐私、灵活性和完全掌控数据的用户！
想自己托管这项服务？我们将带你一步步完成安装和配置，并告诉你所有需要注意的事项。
使用一键应用安装器安装 Joplin
你可以通过我们的 一键应用安装器 在 VPS 网页界面直接安装 Joplin。完成初始应用设置后，打开应用目录，搜索 Joplin，并根据你的项目、环境和域名偏好开始部署。这为你提供了一个快速且用户友好的方式来部署和管理 Joplin，无需手动命令行操作，同时还能享受集成的网页管理、自定义域名支持和可用的 SSL 证书配置。
此应用只能安装并运行在带有图形用户界面的 Linux 系统上；本示例中以 Ubuntu Desktop 25.04 作为参考。
前置条件
在安装 Joplin 之前，请确保你的主机环境满足以下要求，以保证安装顺利并获得最佳性能。
| 硬件 | 最低要求 | ZAP-Hosting 推荐配置 |
|---|---|---|
| CPU | 1 个 vCPU 核心 | 4 个 vCPU 核心 |
| 内存 | 2 GB | 4 GB |
| 磁盘空间 | 250 MB | 250 MB |
软件要求所有必要依赖已安装，并运行在支持的操作系统上。请确保你的服务器满足以下条件后再继续安装：
依赖项： Libfuse2
操作系统： 带桌面支持的 Linux
确保所有依赖已安装且操作系统版本正确，以避免安装 Joplin 时出现兼容性问题。
准备工作
在搭建 Joplin 之前，你需要先准备好系统环境，包括将操作系统更新到最新版本并安装所有必需的依赖。这些准备工作能确保环境稳定，避免安装过程中或之后出现问题。
更新系统
为了确保系统运行最新的软件和安全补丁，建议先执行系统更新。运行以下命令：
sudo apt update && sudo apt upgrade -y
这会确保你的系统拥有最新的安全修复和软件版本。
安装依赖
更新完成后，就可以安装依赖了。
Libfuse2
Joplin 需要先安装 Libfuse2。运行以下命令：
sudo apt install -y libfuse2
安装
满足所有要求并完成准备后，就可以开始安装 Joplin 了。执行以下命令：
wget -O - https://raw.githubusercontent.com/laurent22/joplin/dev/Joplin_install_and_update.sh | bash
Joplin 会通过官方安装脚本下载并安装。耐心等待安装完成，之后即可立即启动应用。
配置
安装完成后，你应该配置基础设置以适应你的使用习惯。配置项可在 设置 菜单中找到。
同步 Joplin 支持多种同步目标，如 Nextcloud、Dropbox、OneDrive 或 WebDAV。在“同步”中选择你喜欢的服务商并输入凭证，实现跨设备笔记同步。
加密 为保护同步的笔记安全，开启“加密”设置中的端到端加密。系统会生成一个密钥，需在所有访问笔记的设备上配置。
编辑器与外观 Joplin 使用 Markdown 作为笔记格式。在“编辑器”设置中，你可以选择是否自动显示预览，并调整字体类型和大小。
插件与扩展 内置插件管理器允许你安装额外功能，比如图表支持、日历集成或高级标签管理。
网页剪辑器 可选地启用“Joplin 网页剪辑器”浏览器扩展，直接将网页或选中内容保存为笔记。
通过这些核心设置，Joplin 可广泛应用于任务管理、项目文档或个人知识库等多种场景。
总结及更多资源
恭喜你！现在已经成功在你的 VPS/独立服务器上安装并配置了 Joplin。我们还推荐你查看以下资源，能为你的服务器配置提供更多帮助和指导：
- Joplinapp.org - 官方网站
- Joplinapp.org/help/ - Joplin 帮助中心
有具体问题这里没覆盖？如需更多帮助，随时联系在线客服，我们每天都在线为你服务！🙂