pbeke/qownnotes-webpage

QOwnNotes Webpage Docker镜像文档

镜像概述

QOwnNotes Webpage是开源笔记应用QOwnNotes的网页端实现，基于Web技术栈构建，提供与桌面版QOwnNotes一致的核心笔记管理能力。该镜像旨在通过浏览器提供便捷的笔记访问与编辑功能，支持与QOwnNotes桌面版、Nextcloud等服务同步数据，满足跨设备、跨平台的笔记管理需求。

核心功能与特性

• Markdown全支持：提供完整的Markdown编辑与预览功能，支持代码块、表格、公式等常用语法
• 数据同步能力：无缝对接QOwnNotes桌面版及Nextcloud/ownCloud，实现笔记数据实时同步
• 笔记管理功能：支持笔记创建、编辑、删除、分类、标签管理及搜索
• 用户认证机制：内置基础身份验证，保障笔记数据访问安全
• 轻量部署：基于Docker容器化部署，配置简单，资源占用低

使用场景与适用范围

• 个人日常笔记：作为个人知识管理工具，通过浏览器随时随地访问和编辑笔记
• 跨设备协作：团队成员通过Web端共享和协作编辑笔记内容
• 轻量级办公：替代本地笔记软件，减少设备安装依赖，通过服务器集中管理笔记数据
• 开发/学习辅助：用于记录代码片段、学习笔记，支持Markdown代码块高亮显示

使用方法与配置说明

快速启动（Docker Run）

通过以下命令快速启动QOwnNotes Webpage容器：

bash
docker run -d \
  --name qownnotes-web \
  -p 8080:80 \
  -v /path/to/local/data:/app/data \
  -e QOWNNOTES_SYNC_URL="https://your-nextcloud-instance.com" \
  -e QOWNNOTES_USERNAME="your-username" \
  -e QOWNNOTES_PASSWORD="your-password" \
  qownnotes/webpage:latest

参数说明：

• -p 8080:80：将容器内80端口映射到主机8080端口，通过http://localhost:8080访问
• -v /path/to/local/data:/app/data：挂载本地目录用于持久化存储笔记数据
• 环境变量用于配置同步服务信息

Docker Compose配置

创建docker-compose.yml文件进行更灵活的部署：

yaml
version: '3'
services:
  qownnotes-web:
    image: qownnotes/webpage:latest
    container_name: qownnotes-web
    restart: always
    ports:
      - "8080:80"
    volumes:
      - ./qownnotes-data:/app/data
    environment:
      - QOWNNOTES_SYNC_URL="https://nextcloud.example.com"
      - QOWNNOTES_USERNAME="user123"
      - QOWNNOTES_PASSWORD="secure-pass"
      - QOWNNOTES_PORT=80
      - LOG_LEVEL=info

启动服务：

bash
docker-compose up -d

配置参数与环境变量

访问与使用

容器启动后，通过浏览器访问 http://<主机IP>:8080 即可打开QOwnNotes Webpage界面。首次访问需完成初始化配置，包括确认同步服务器信息、登录账户，之后即可开始创建和管理笔记。笔记数据将自动与配置的同步服务或本地存储目录保持一致。