TimeAmber
剪藏#剪藏#运维江湖客

Poznote + Docker：打造属于你的开源笔记管理系统

2026 年 2 月 13 日 约 1 分钟
分享Twitter / XTelegram微博

一、Poznote介绍

1.1 Poznote项目简介

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

1.2 Poznote主要特点

  • 富文本编辑器：提供简洁高效的富文本编辑体验，快速创建格式丰富的笔记。

  • 全文搜索：支持即时全文搜索，轻松定位所需笔记内容。

  • 标签系统：通过自定义标签对笔记进行灵活分类与管理。

  • 文件附件：可在笔记中附加文件，增强上下文信息与参考资料完整性。

  • 响应式设计：适配各类设备，在桌面或移动浏览器上均可流畅使用。

  • 自托管架构：所有数据存储于用户自有服务器，保障隐私与安全。

  • 多实例支持：可运行多个相互隔离的实例，适用于不同项目或用户。

  • 工作区（Workspaces）：将笔记按项目或场景分组到独立工作区，提升组织效率。

  • 内置备份功能：提供一键导出与备份工具，确保数据安全无忧。

  • 回收站机制：删除的笔记进入回收站，支持误删恢复。

  • REST API：开放完整的编程接口，便于集成与自动化操作。

  • 公开分享：生成只读链接，便捷地对外共享笔记内容。

  • 任务列表：在笔记内创建和管理待办事项，助力任务追踪与进度管理。

  • Markdown 支持：原生支持 Markdown 语法，实现高效结构化写作。

  • 深色模式：提供深色主题，优化低光环境下的阅读与书写体验。

  • Excalidraw 集成：内置 Excalidraw 绘图工具，轻松创建图表、草图与可视化笔记。

二、本次实践规划

2.1 本地环境规划

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

jeven 192.168.3.88 Ubuntu 24.04.2 LTS 28.5.0 Poznote ——

2.2 本次实践介绍

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

三、本地环境检查

3.1 检查Docker服务状态

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

JAVASCRIPT
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 

Notion image

3.2 检查Docker版本

检查Docker版本

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

3.3 检查docker compose 版本

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

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

四、拉取Poznote镜像

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

JAVASCRIPT
docker pull ghcr.io/timothepoznanski/poznote:1.9.4 

Notion image

五、部署Poznote服务

5.1 创建部署目录

  • 创建部署目录
JAVASCRIPT
mkdir -p /data/poznote && cd /data/poznote 

5.2 docker compose方式部署

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

JAVASCRIPT
vim docker-compose.yaml 
JAVASCRIPT
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容器。

JAVASCRIPT
docker compose up -d 

Notion image

5.4 查看Poznote容器状态

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

JAVASCRIPT
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服务正常运行。

JAVASCRIPT
docker compose logs 

Notion image

六、访问Poznote服务

6.1 访问Poznote首页

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

Notion image

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

Notion image

6.2 编辑笔记

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

Notion image

七、总结

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

原文地址: https://mp.weixin.qq.com/s?__biz=MzkyNjU5ODk4Mg==&mid=2247488864&idx=1&sn=f77ad9183860de74f7e4fd0ee40318b0&chksm=c373adf23ea5047e1a9aff9f2cb75373a1b3b09637405383e64bf4c4b76a79b38cb811d6b19e&mpshare=1&scene=1&srcid=0213msfBWqq6uPhbhFT56ekc&sharer_shareinfo=41bc1f8fd292c1a726c46ddccfcc1c00&sharer_shareinfo_first=41bc1f8fd292c1a726c46ddccfcc1c00#rd

相关文章