






# 一、Poznote介绍




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

## 1.2 Poznote主要特点

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



















# 二、本次实践规划
## 2.1 本地环境规划
>本次实践为个人测试环境，操作系统版本为 Ubuntu 24.04.2 LTS。


|hostname| IP地址  | 操作系统版本   |Docker版本   |部署项目|备注
|--|--| --|  --|--|--|
|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正常运行。



```bash
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
```
![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/7434dc0ceb2484601e9e720eabdbb5da.png)



## 3.2  检查Docker版本
>检查Docker版本

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


## 3.3 检查docker compose 版本
>检查Docker compose版本，确保2.0以上版本。


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

```


# 四、拉取Poznote镜像



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



```bash
docker pull ghcr.io/timothepoznanski/poznote:1.9.4
```



![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/18f7127437750364b97cd9cc28ca5bde.png)











# 五、部署Poznote服务

## 5.1 创建部署目录
- 创建部署目录

```bash
mkdir -p /data/poznote && cd /data/poznote
```
## 5.2 docker compose方式部署





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

```bash
vim docker-compose.yaml
```

```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容器。


```bash
docker compose up -d
```



![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/d15d38145ec41be92d8e91a084bd12fa.png)






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

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




```bash
docker compose logs
```



![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/0200afa0eee7a2923bb5f8c0e3d97ed8.png)






























































# 六、访问Poznote服务









## 6.1 访问Poznote首页





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




![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/3a94473f82d1f53b33d1132b0765ac32.png)


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


![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/86d863911e0bae31dccacd7cf82f80a9.png)


## 6.2 编辑笔记

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


![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/4960592a21c2bbf25a0f1bf69d0a1c4e.png)


# 七、总结

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


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

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

开发工具

运维

后端

Poznote是一款功能强大的自托管笔记应用，支持富文本编辑、全文搜索、标签管理、文件附件等功能。本文详细介绍在Ubuntu24.04系统下使用Docker部署Poznote1.9.4的完整过程，包括环境检查、镜像拉取、容器配置及访问验证，帮助用户快速搭建私有笔记服务。

响应式设计

云服务器

数据安全

数据存储

代码解释

服务器

防火墙

容器

Docker

2026上云采购 | AI焕新·智启新局

ES特惠专场，新客首购5.5折起！


文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Poznote + Docker：打造属于你的开源笔记管理系统-腾讯云开发者社区-腾讯云

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

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

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐