Poznote 是一款免费、自托管的开源笔记软件，可以看作 Notion、Obsidian、Evernote 的替代品：数据全部存放在你自己的服务器上，支持富文本、Markdown、任务列表、看板、日记等多种笔记形式。本指南带你走完从零开始的完整流程——部署 Poznote 服务、完成首次登录设置、熟悉主界面，并写下你的第一篇笔记，全程无需任何编程基础。

一、Poznote 能帮你做什么

在开始之前，先花 30 秒了解它的能力，方便你之后有目的地探索：

• 多类型笔记：富文本（所见即所得）、Markdown（支持 Mermaid 图表和数学公式）、任务列表、快捷方式
• 任务管理：带截止日期、提醒的交互式清单，还有专门的日历视图
• 组织方式：文件夹、标签、收藏、工作区（Workspace），笔记之间还能用关系图谱串联
• 协作与共享：工作区可共享给团队成员，单篇笔记可生成公开链接
• 多端访问：响应式设计，浏览器打开即用，手机、平板都能正常编辑

二、部署 Poznote：三条命令起步

Poznote 官方推荐使用 Docker 部署，官方镜像同时支持 x86 和 ARM64 架构（包括树莓派、NAS 等设备）。完整步骤可参考仓库中的 docs/README.zh-cn.md 安装章节，核心流程如下（Linux/macOS，Windows 的 PowerShell 命令同理）：

# 1. 创建目录并进入 mkdir poznote && cd poznote # 2. 下载环境变量文件并编辑（设置端口等） curl -o .env https://raw.githubusercontent.com/timothepoznanski/poznote/main/.env.template vi .env # 3. 下载 Docker Compose 配置 curl -o docker-compose.yml https://raw.githubusercontent.com/timothepoznanski/poznote/main/docker-compose.yml # 4. 拉取镜像并启动 docker compose pull docker compose up -d

其中.env里的HTTP_WEB_PORT决定了浏览器访问的端口，默认是8040，对应的编排文件见 docker-compose.yml。启动后稍等片刻，服务即就绪。

💡 如果安装过程遇到问题（端口被占用、数据目录权限等），建议查看 docs/TROUBLESHOOTING.zh-cn.md，里面覆盖了绝大多数常见故障。

三、首次登录：使用默认管理员账号

打开浏览器访问：

http://localhost:8040

首次登录使用全新安装自动创建的管理员账号：

登录页的代码在 src/public/login.php，当账号仍是出厂默认凭据时，页面会直接提示这对账号密码（默认凭据判断逻辑见 src/lib/default-credentials.php）。

四、完成欢迎设置向导

首次登录成功后，你会被自动带到欢迎设置向导页（src/public/welcome.php），这是唯一一次出现的"新手引导"，只需要做两件事：

1. 设置偏好：界面语言（支持简体中文、English、Français 等 8 种语言）、主题（跟随系统 / 浅色 / 深色 / 纯黑等）、日期时间格式、时区
2. 完善账号：把默认的admin_change_me用户名改成你自己的，并设置新密码（出厂密码admin会在页面上明确提示你更换）

点击"开始使用 Poznote"后，向导完成，正式进入主界面。这些选项之后都能在设置中随时修改，所以不必纠结。

五、熟悉主界面：仪表盘与左侧图标栏

登录后的第一个页面是仪表盘（src/public/dashboard.php）：笔记以卡片形式按文件夹分组铺开，一眼看清全部内容，还能直接拖拽调整卡片位置。

界面最左侧是一条图标栏（src/icon_sidebar.php），它是整个应用的导航中枢，从上到下依次是：

• 🏠Dashboard：回到仪表盘
• 🔀Graph：笔记关系图谱
• 📝Notes：笔记管理页（列表式总览）
• ✅Tasks：所有任务集中页（含日历视图）
• 📁Folders：文件夹列表
• 📖Diary：每日日记面板
• 🏷️Tags：标签管理
• 📤Shares：我的共享链接
• 📎Attachments：附件总览
• 🗑️Trash：回收站

图标栏的按钮顺序和颜色都可以自定义，点右下角的设置按钮即可进入完整设置页（src/public/settings.php）。

六、写下你的第一篇笔记

现在来到重点环节。回到仪表盘或笔记页，点击顶部的+按钮就能新建笔记。系统预置的欢迎笔记（src/welcome_note.html）里也写着同样的提示。

编辑时记住两个高频技巧：

• 输入/或右键：打开斜杠命令菜单，可以插入标题、表格、待办清单、Mermaid 图、代码块等
• 自动保存：边写边存，无需手动保存；Poznote 还会自动保留修订历史，随时可回退

新建笔记时可以选择类型：

七、进阶体验：任务日历与笔记图谱

写完几篇笔记、建一个任务列表后，强烈建议你试试这两个"哇塞"功能：

📅 任务页 + 日历视图：打开左侧图标栏的 Tasks，可以按"待办 / 重要 / 已逾期"等状态筛选任务，切到日历模式后，带截止日期的任务会直接落在对应的日期格子里。

🕸️ 关系图谱（Graph）：Graph 页面把所有笔记变成节点、把笔记间的引用变成连线，帮你发现知识之间的关联，特别适合做长期知识库。

八、个性化你的 Poznote

Poznote 的个性化全部在界面内完成，不用碰任何配置文件。最常用的是主题切换：点击左侧图标栏最底部的主题按钮，可在浅色、深色、纯黑、薰衣草、棕褐、终端等主题间循环切换。

此外在设置 > 显示中还能调整字体、字号、笔记配色板等；在设置 > 行为中可设置笔记排序规则、界面语言、时区。如果是多用户部署，管理员可以在设置 > 管理工具中管理用户、开启 Git 同步等。

九、小结与延伸阅读

到这里，你已经完成了 Poznote 新手入门的完整闭环：部署 → 首次登录 → 欢迎设置 → 熟悉界面 → 第一篇笔记 → 个性化。几个常用入口汇总：

• 官方中文文档：docs/README.zh-cn.md（安装、认证、备份、Git 同步等全部主题）
• 故障排除指南：docs/TROUBLESHOOTING.zh-cn.md
• 故障排除入口页：docs/TROUBLESHOOTING.md
• 主界面源码：src/public/index.php
• 任务与日历页面：src/public/tasks.php

Poznote 还支持 AI 助手、语音转文字、MCP 服务器、Chrome 扩展等更多玩法，相关文档都在 docs/ 目录下，等基础流程跑通后可以按需深入。🎉