一、jotty·page介绍

1.1 jotty·page项目简介

jotty·page 是一个轻量级、自托管的待办事项与笔记管理应用，所有数据本地存储，注重隐私与安全，支持端到端加密。

1.2 jotty·page主要特点

• 任务清单管理：支持拖放排序、进度条、分类，以及高级功能如看板（Kanban）视图和时间跟踪。
• 富文本笔记编辑：内置基于 TipTap 的所见即所得（WYSIWYG）编辑器，完整支持 Markdown 与代码语法高亮。
• 灵活共享机制：可在同一实例内与其他用户共享清单或笔记，并支持生成公开访问链接。
• 无数据库依赖：所有数据以纯文本形式（Markdown 和 JSON）保存在服务器的单一目录中，无需数据库。
• 用户与会话管理：提供管理员面板，用于创建用户账户和监控登录会话。
• 高度可定制外观：内置 14 种主题，支持自定义主题、表情符号和图标。
• 端到端加密：采用 PGP 加密方案，确保笔记内容仅本人可读（详见 ENCRYPTION.md）。
• RESTful API 支持：提供带身份验证的 API，便于程序化访问和集成第三方工具。

二、本次实践规划

2.1 本地环境规划

本次实践为个人测试环境，操作系统版本为 Ubuntu 24.04.2 LTS。

2.2 本次实践介绍

1.本次实践部署环境为个人测试环境，生产环境请谨慎；
2.在Docker环境下部署jotty·page轻量级待办事项与笔记管理应用。

三、本地环境检查

3.1 检查Docker服务状态

检查Docker服务是否正常运行，确保Docker正常运行。

root@jeven:~# systemctl status docker
● docker.service - Docker Application Container Engine
     Loaded: loaded (/usr/lib/systemd/system/docker.service; enabled; preset: enabled)
     Active: active (running) since Thu 2026-02-05 00:27:40 CST; 1s ago
TriggeredBy: ● docker.socket
       Docs: https://docs.docker.com
   Main PID: 841698 (dockerd)
      Tasks: 65
     Memory: 73.5M (peak: 77.1M)
        CPU: 975ms
     CGroup: /system.slice/docker.service

3.2 检查Docker版本

检查Docker版本

root@jeven:~# docker -v
Docker version 28.5.0, build 887030f

3.3 检查docker compose 版本

检查Docker compose版本，确保2.0以上版本。

root@jeven:~# docker compose version
Docker Compose version v2.39.4

四、拉取jotty·page镜像

下载jotty·page镜像，执行以下命令：

docker pull ghcr.io/fccview/jotty:latest

五、部署jotty·page服务

5.1 创建部署目录

• 创建部署目录

mkdir -p /data/jottypage/{config,cache,data}  && cd /data/jottypage

• 在测试环境下，设置目录权限。

 chmod -R 777 /data/jottypage

5.2 创建jotty·page容器

新建及编辑docker-compose.yaml文件，宿主机映射端口可自行设置，注意防止端口冲突。

vim docker-compose.yaml

services:
  jotty:
    image: ghcr.io/fccview/jotty:latest
    container_name: jotty
    user: "1000:1000"
    ports:
      - "1122:3000"
    volumes:
      - ./data:/app/data:rw
      - ./config:/app/config:rw
      - ./cache:/app/.next/cache:rw
    restart: unless-stopped
    environment:
      - NODE_ENV=production


    

5.3 创建jotty·page容器

执行以下命令，创建jotty·page容器。

docker compose up -d

5.4 查看jotty·page容器状态

检查jotty·page容器运行状态，确保jotty·page容器正常启动。

root@jeven:/data/jottypage# docker compose ps
NAME      IMAGE                          COMMAND                   SERVICE   CREATED          STATUS          PORTS
jotty     ghcr.io/fccview/jotty:latest   "/usr/local/bin/dock…"   jotty     19 minutes ago   Up 19 minutes   0.0.0.0:1122->3000/tcp, [::]:1122->3000/tcp

5.5 检查jotty·page容器日志

检查容器运行日志，确保jotty·page服务正常运行。

root@jeven:/data/jottypage# docker compose logs
jotty  |   ▲ Next.js 14.2.35
jotty  |   - Local:        http://localhost:3000
jotty  |   - Network:      http://0.0.0.0:3000
jotty  |
jotty  |  ✓ Starting...
jotty  |  ✓ Ready in 73ms

六、访问jotty·page服务

6.1 访问jotty·page初始页

浏览器地址： http://<个人的服务器IP>1122，访问jotty·page初始页。如果无法访问，请确保宿主机的防火墙已关闭或已放行相关端口，对于云服务器还需配置相应的安全组规则。

6.2 创建用户

自行创建登录用户，填写账号信息完毕后，点击“Create Admin Account”确定创建。

6.3 任务管理

在Checklists中，我们可以自行创建待办事项或任务管理。

6.4 笔记管理

在Notes模块中，我们新建笔记及编辑笔记内容，效果如下：

七、总结

本次实践基于 Docker 成功部署了 jotty·page 轻量级待办事项与笔记管理应用，完整覆盖环境验证、容器创建及服务访问等关键环节。部署过程高效稳定，充分体现了容器化技术在简化应用交付中的优势。jotty·page 提供简洁直观的用户界面，任务与笔记功能响应迅速，操作流畅，适用于个人或小团队的日常信息管理。数据持久化与服务配置均按预期运行，系统整体表现可靠且资源占用低。