一、Poznote介绍

1.1 Poznote项目简介

Poznote 是一款轻量级但功能强大的自托管网络笔记应用，帮助用户高效捕获、组织和访问笔记，同时确保用户完全掌控自己的数据。

1.2 Poznote主要特点

• 富文本编辑器：提供简洁高效的富文本编辑体验，快速创建格式丰富的笔记。
• 全文搜索：支持即时全文搜索，轻松定位所需笔记内容。
• 标签系统：通过自定义标签对笔记进行灵活分类与管理。
• 文件附件：可在笔记中附加文件，增强上下文信息与参考资料完整性。
• 响应式设计：适配各类设备，在桌面或移动浏览器上均可流畅使用。
• 自托管架构：所有数据存储于用户自有服务器，保障隐私与安全。
• 多实例支持：可运行多个相互隔离的实例，适用于不同项目或用户。
• 工作区（Workspaces）：将笔记按项目或场景分组到独立工作区，提升组织效率。
• 内置备份功能：提供一键导出与备份工具，确保数据安全无忧。
• 回收站机制：删除的笔记进入回收站，支持误删恢复。
• REST API：开放完整的编程接口，便于集成与自动化操作。
• 公开分享：生成只读链接，便捷地对外共享笔记内容。
• 任务列表：在笔记内创建和管理待办事项，助力任务追踪与进度管理。
• Markdown 支持：原生支持 Markdown 语法，实现高效结构化写作。
• 深色模式：提供深色主题，优化低光环境下的阅读与书写体验。
• Excalidraw 集成：内置 Excalidraw 绘图工具，轻松创建图表、草图与可视化笔记。

二、本次实践规划

2.1 本地环境规划

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

2.2 本次实践介绍

1.本次实践部署环境为个人测试环境，生产环境请谨慎；
2.在Docker环境下部署Poznote文件管理工具。

三、本地环境检查

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 Sun 2025-11-02 07:06:57 UTC; 3 days ago
TriggeredBy: ● docker.socket
       Docs: https://docs.docker.com
   Main PID: 889 (dockerd)
      Tasks: 82
     Memory: 1.1G (peak: 2.8G)
        CPU: 6min 1.860s
     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

四、拉取Poznote镜像

下载Poznote镜像，镜像名称为：ghcr.io/timothepoznanski/poznote:1.9.4

docker pull ghcr.io/timothepoznanski/poznote:1.9.4

五、部署Poznote服务

5.1 创建部署目录

• 创建部署目录

mkdir -p /data/poznote && cd /data/poznote

5.2 docker compose方式部署

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

vim docker-compose.yaml

version: '3.8'

services:
  webserver:
    image: ghcr.io/timothepoznanski/poznote:1.9.4
    container_name: poznote
    restart: always
    environment:
      SQLITE_DATABASE: /var/www/html/data/database/poznote.db
      POZNOTE_USERNAME: admin
      POZNOTE_PASSWORD: Admin@123
      HTTP_WEB_PORT: 8200
    ports:
      - "8200:80"
    volumes:
      - poznote_data:/var/www/html

volumes:
  poznote_data:

5.3 创建Poznote容器

执行以下命令，创建Poznote容器。

docker compose up -d

5.4 查看Poznote容器状态

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

root@jeven:/data/poznote# docker compose ps
WARN[0000] /data/poznote/docker-compose.yaml: the attribute `version` is obsolete, it will be ignored, please remove it to avoid potential confusion
NAME      IMAGE                                    COMMAND                   SERVICE     CREATED          STATUS          PORTS
poznote   ghcr.io/timothepoznanski/poznote:1.9.4   "docker-php-entrypoi…"   webserver   42 seconds ago   Up 41 seconds   9000/tcp, 0.0.0.0:8200->80/tcp, [::]:8200->80/tcpp

5.5 检查Poznote容器日志

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

docker compose logs

六、访问Poznote服务

6.1 访问Poznote首页

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

在部署文件中我们设置的账号密码为admin/Admin@123 ，输入账号密码登录即可。

6.2 编辑笔记

我们点击新增笔记选项，编辑markdown笔记内容，效果如下所示：

七、总结

本次实践成功通过 Docker 部署了 Poznote 笔记管理工具，验证了容器化应用在快速搭建服务方面的优势。整个过程操作简洁，依赖少，仅需一个 compose 文件即可完成部署与数据持久化。Poznote 界面清爽、功能实用，适合轻量级笔记记录与管理。通过本次练习，不仅加深了对 Docker 卷管理和环境变量配置的理解，也为后续部署类似 Web 应用积累了经验。