Jotdex 1.0

把资料库安在你信任的地方。

支持一条命令、Docker Compose 与官方 Docker run 脚本自部署。默认日常只需管理一个 Jotdex 容器。

系统更新已内置。 完成安装后，在“设置 → 系统更新”检查并更新。升级只替换程序容器，不会重建笔记、附件或 Docker 数据卷。

Quick start

先用最小配置跑起来。

核心资料库先在可信内网运行。远端备份、增强检索、通知和 Tunnel 都在系统内按需启用，不塞进首次安装。

curl -fsSL https://get.jotdex.com | sh
01

准备一台长期在线的主机

支持常见 Linux、NAS、amd64 与 arm64，并要求 Docker Compose v2。

02

先确认数据目录与备份位置

不要把数据库、附件和恢复点放进临时目录，也不要只保留同盘副本。

03

默认稳定安装

首次安装使用 latest 指向当前稳定版；系统更新仍只接受带签名、明确版本和不可变摘要的发行。

Docker 管理面板也能用完整功能。

Portainer、CasaOS、群晖 Container Manager 等用户，不必为了图形化管理而失去扩展和系统更新。默认使用发行包内的 简化模式：deploy/compose.single.yaml，日常只显示一个 Jotdex 容器。

Default for panels

简化模式

一个项目、一个日常运行的 Jotdex 容器。核心资料库、私有扩展运行时和受限更新入口都已包含；只有主服务公开你设置的端口。

  • 网页内安装扩展
  • 设置中手动检查、确认系统更新
  • 首次启动自动生成每个实例独有的私有凭据

Without Compose

官方 Docker run 脚本

不使用 Compose 的 NAS 或管理面板，可运行发行包中的 deploy/docker-run.simple.sh。它同样保留扩展与网页内手动更新，不是临时启动命令。

不要自行拼写普通的单条 docker run 命令并省略脚本中的状态卷、标签或权限边界。

面板中只需要填写两项

JOTDEX_PORT=8888
JOTDEX_COMPOSE_PROJECT=jotdex

其余凭据由简化模式在私有 Volume 中生成。公网 VPS、团队或需要最严格 Docker 权限隔离时，可改用 deploy/compose.manager.yaml 的正常模式。不要把扩展 Token、更新 Token 或存储根密钥粘贴到面板环境变量。详情请查看 Docker 管理面板手册 ↗。

先确定网络边界

局域网与 NAS

可信局域网可以直接访问实例。安装器默认监听主机的 8888 端口；如需限制网卡，可显式指定监听地址。

公网访问

需要公网访问时，建议使用 HTTPS 反向代理或 Cloudflare Tunnel。Tunnel 属于可选插件，不会接管核心资料库。

HTTP 可用于局域网或你自行决定的公网入口；未加密访问会在系统内持续提示风险。

完成首次设置

  1. 在同一可信网络中打开实例地址。
  2. 创建管理员用户名和高强度密码。
  3. 保存恢复材料，并确认它不与服务器放在同一位置。
  4. 写入一条测试笔记，再完成一次导出或恢复点验证。

首次设置不使用长期保留的一次性口令。管理员创建完成后，初始化入口应立即失效。

更新、备份与恢复

  • 更新前创建本地恢复点，并运行只读升级检查。
  • 保留原 Compose 项目名与数据卷，避免误启一个空实例。
  • 远端加密备份用于异机灾备，不能替代本地恢复点。
  • 定期执行真实恢复演练，而不是只检查备份文件是否存在。

阅读完整 V1 安装手册 ↗