【免费下载链接】poznotePowerful note-taking without the hassle.项目地址https://gitcode.com/gh_mirrors/po/poznote点击查看免费下载Poznote 是一款免费、开源、可自托管的笔记系统支持富文本、Markdown、任务清单、看板视图与多人协作。本教程带你用 Docker 在 Windows、Linux 和 macOS 上完成部署只需 3 条命令5 分钟就能拥有完全属于自己的私有笔记系统数据全部保存在自己的机器上。为什么用 Docker 部署 Poznote 自托管笔记✅零环境依赖不用自己装 PHP、nginx、SQLite一个 Docker 镜像全部搞定镜像内部用 supervisor 统一管理服务进程构建细节见 Dockerfile。✅全平台通用官方镜像支持linux/amd64和linux/arm64Windows / macOS 通过 Docker Desktop 即可运行树莓派、NAS 等 ARM 设备也支持。✅数据完全自主所有笔记、附件、备份都保存在你本地的data/目录更新应用也不会丢数据。✅5 分钟上线默认端口8040克隆仓库、拉取镜像、启动容器即可访问。准备工作Docker 环境一键装好平台需要安装WindowsDocker Desktop安装并启动即可LinuxDocker Engine Docker Compose 插件macOSDocker Desktop安装并启动即可装完后验证一下能打印出版本号就说明环境就绪docker --version docker compose version 三个平台的安装流程完全一致下文命令通用Windows 请在 PowerShell 中执行。3 条命令完成 Poznote Docker 部署最快方法第 1 步克隆仓库并准备配置文件仓库里直接自带了部署需要的 docker-compose.yml 和环境模板 .env.template克隆一次即可git clone https://gitcode.com/gh_mirrors/po/poznote cd poznote cp .env.template .env # Windows PowerShell 用copy .env.template .env第 2 步拉取镜像并启动容器docker compose pull docker compose up -ddocker compose.yml会启动两个容器服务作用端口webserverPoznote 主程序nginx PHP${HTTP_WEB_PORT}→ 容器内 80mcp-serverAI 助手用的 MCP 接口仅绑定127.0.0.1:8045首次启动拉取镜像需要几分钟之后每次启动都是秒级。第 3 步验证部署执行docker compose ps两个服务状态均为Up健康检查通过即部署成功docker compose ps docker compose logs -f webserver # 可选查看启动日志首次登录默认账号、密码与端口浏览器打开http://localhost:8040用户名admin_change_me密码admin端口8040来自.env的HTTP_WEB_PORT⚠️登录后第一件事改掉默认管理员账号名和密码再去Settings Admin Tools User Management管理多用户。修改 Poznote 访问端口与关键 .env 配置大多数日常设置都在网页界面里改.env只用于部署/运行时参数。修改后执行docker compose up -d生效即可。完整说明见 .env.template 内的注释。变量默认值用途HTTP_WEB_PORT8040浏览器访问端口改端口就改这一行POZNOTE_MCP_PORT8045MCP 服务端口仅本机可访问POZNOTE_LISTEN_PORT容器内 80仅network_mode: host模式需要POZNOTE_PHP_FPM_MAX_CHILDREN10并发 PHP 请求数多人高负载时调大POZNOTE_PHP_MEMORY_LIMIT512单请求 PHP 内存上限MBPOZNOTE_DEBUGfalse排障时临时开启平时保持关闭 端口被占用时直接把HTTP_WEB_PORT改成别的端口如8090再docker compose up -d即可。如何更新 Poznote一键升级、数据永不丢失笔记、附件、备份全部存放在./data目录对应容器内/var/www/html/data升级只会替换镜像不会动这个目录。更新流程cd poznote git pull # 获取最新的 docker-compose.yml 与配置模板 docker compose down docker compose pull # 拉取新版本镜像 docker compose up -d容器启动脚本docker/init.sh会在每次启动时初始化目录、应用环境参数然后由 supervisord 拉起 nginx 与 php-fpm无需额外操作。常见部署问题速查清单遇到报错别慌90% 的问题都在这张表里完整版见 docs/TROUBLESHOOTING.md现象原因与解决mkdir(): Permission denied/unable to open database file挂载卷权限问题先执行sudo chown -R 82:82 data82 是 Alpine 中www-data的 UID再启动attempt to write a readonly database先重启容器不行就docker compose down sudo chown 1000:1000 -R data浏览器显示 This site cant be reached多为 SELinux 拦截在 docker-compose.yml 的卷上加:Z后缀./data:/var/www/html/data:Z或避免把目录放在/root下Incorrect username or password管理员用admin_change_me/admin普通用户默认密码是user确认该用户在 User Management 中是active状态容器反复重启执行docker compose logs webserver查看日志定位 如果你的环境禁止容器内运行 root 用户如 K8s 受限策略、rootless PodmanPoznote 提供了专门的非 root 镜像直接使用仓库内的 docker-compose.rootless.yml并在首次启动前把data目录属主设为1000:1000即可。部署之后自托管笔记系统值得马上试的 3 个功能1️⃣ 任务日历——把任务列表、截止日期汇总到一张日历上支持待办 / 重要 / 逾期 / 已完成状态筛选2️⃣ 深色模式与多主题——左下角主题按钮一键切换 Light / Dark / Black / Lavender / Sepia / Terminal 等 6 套内置主题护眼夜间党友好3️⃣ 多人协作与共享——管理员在 User Management 里建账号即可团队共用一个实例工作区、笔记、文件夹都能共享支持公开链接、密码保护或指定用户访问。更多玩法AI 助手、MCP 服务、Git 同步、Webhooks、Chrome 扩展可阅读官方简体中文文档 docs/README.zh-cn.md。总结你的私有笔记系统已经上线回看全程核心就 4 步git clone仓库并复制.env.template为.envdocker compose pull拉取镜像docker compose up -d启动浏览器访问http://localhost:8040用admin_change_me/admin登录并改密码Windows、Linux、macOS 命令完全一致。从打开终端到拥有笔记系统5 分钟封顶——数据在自己手里才是真正强大的笔记没有负担。赞分享【免费下载链接】poznotePowerful note-taking without the hassle.项目地址https://gitcode.com/gh_mirrors/po/poznote点击查看免费下载相关推荐从零开始的openapi-backend mock服务前端独立开发的福音从零开始的openapi backend mock服务前端独立开发的福音 在现代前端开发中等待后端API接口往往是影响效率的最大瓶颈。openapi bac如何5分钟搭建GNN实验Web平台JittorGeometric前端演示系统部署全记录如何5分钟搭建GNN实验Web平台JittorGeometric前端演示系统部署全记录 本文带你用 5 分钟部署 JittorGeometric 前端演示系统Headless Recorder 终极指南一键生成浏览器自动化测试脚本Headless Recorder 终极指南一键生成浏览器自动化测试脚本 想要快速创建浏览器自动化测试脚本Headless Recorder 就是你的完美解开发工具上一篇pyAudioAnalysis完全指南从零开始掌握Python音频分析技术下一篇Openblocks自定义组件开发使用React和SDK的详细教程创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考