WizNote Server 自托管维护版

个人维护的 WizNote Server 自托管镜像，基于官方私有部署版持续做兼容维护、功能修复和使用体验增强。
最后更新：2026-07-10
官方基线：官方私有部署版 Docker 镜像 / WizNote Server 0.1.107

项目定位

为知笔记官方已经提供 Docker 化私有部署能力，用户可以通过官方镜像运行自己的 WizNote Server。公开报道显示，ONES 在 2022 年完成对为知笔记的全资收购，收购后为知笔记的协作文档能力被用于支撑 ONES Wiki。

但从老用户和自托管用户的角度看，官方私有部署版长期缺少持续维护。Docker Hub 的 wiznote/wizserver-amd64 tags 页面显示该镜像已多年未更新；作为长期用户，我也多次向官方反馈 bug 和功能缺口，实际体验是官方目前难以提供持续修复支持。

本项目不是重写为知笔记，也不是替代官方服务。它只做一件事：在官方私有部署版基线之上，维护一个可运行、可迁移、可长期使用的自托管镜像，把老用户在本地部署场景中仍然需要的能力补回来。

当前维护镜像发布在 Docker Hub：damoncui/wizserver-amd64。推荐使用 damoncui/wizserver-amd64:latest，需要固定版本时使用显式日期 tag。

安装与使用

快速启动

mkdir -p ~/wizdata

docker run -d \
  --name wiznote \
  --restart=always \
  -p 80:80 \
  -p 9269:9269/udp \
  -v ~/wizdata:/wiz/storage \
  -v /etc/localtime:/etc/localtime:ro \
  damoncui/wizserver-amd64:latest

docker compose 示例

services:
  wiznote:
    image: damoncui/wizserver-amd64:latest
    container_name: wiznote
    restart: always
    ports:
      - "80:80"
      - "9269:9269/udp"
    volumes:
      - ./storage:/wiz/storage
      - /etc/localtime:/etc/localtime:ro

数据目录

/wiz/storage 是最重要的数据目录，包含数据库、附件、索引和运行数据。升级镜像前必须先备份该目录。

建议：

• 每次升级前完整备份 storage。
• 不要在没有备份的情况下跨大版本替换镜像。
• 先在测试环境用一份 storage 副本验证，再切正式环境。

使用边界

这是个人维护的自托管镜像，不是官方版本。它适合已经依赖为知笔记私有部署、希望继续修复 bug 和补齐功能的老用户。它不承诺覆盖官方云服务、移动端原生客户端或所有桌面客户端能力。

功能总览

分类	功能	解决的问题	状态
部署维护	基础功能升级、前端 CDN 替换、Debian 12 主线镜像、MySQL 5.7 兼容、显式版本 tag	让旧私有部署环境继续可用、可构建、可迁移、可回滚	已可用
搜索与阅读	搜索增强、分享免登录阅读器、协作笔记分享渲染	补齐官方搜索过滤不足和公开分享阅读体验	已可用
附件与预览	Office / PDF / 文本附件本地预览、Web 附件下载修复	自托管环境不再依赖微软 Office Online Viewer，Web 端可直接预览/下载附件	已可用
图表与嵌入	Mermaid 新语法渲染、Excalidraw 可编辑画板、文本绘图入口	技术文档中的图表、画板和流程图可读可编辑	已可用
编辑器增强	代码块折叠、标题自动编号、表格列宽、块链接复制、剪贴板菜单	补齐协作笔记编辑体验缺口	已可用
Markdown 修复	修复 Markdown 语法粘贴问题	修复 Markdown 粘贴/导入中的常见解析误判	已可用
细节修复	头像 EXIF 方向、右侧跳转按钮、右侧编辑面板增强	修复长期影响日常使用的小问题	已可用

功能对照

以下对照基于官方基线镜像与当前维护镜像，在相同测试内容和相同浏览器操作路径下记录；暂时无法稳定复现的项目继续保留截图占位。

日期	功能名称	功能描述	官方版	维护版
2026-03-08	基础功能升级	整理私有部署版基础能力：用户数量不再限制为 5 个，移除自托管场景中不适配的授权与功能提示；同时将 xapp 从 0.1.90 升级到 0.1.107，并清理 xapp、wapp、www 中的跟踪代码。	官方私有部署版仍保留较多基础使用限制，旧版 xapp 停留在 0.1.90	维护版不限制用户数量，移除自托管场景中不适配的授权展示；xapp 升级到 0.1.107，同时删除 xapp、wapp、www 中的跟踪代码。
2026-03-08	基础库升级	替换前端库 CDN 配置，升级 Mermaid、Prism、Flowchart、MathJax 等库地址，修复官方旧 CDN 失效和版本过旧问题，提升新语法的兼容性。	官方前端依赖较旧的 CDN 和库版本，Mermaid、Flowchart、Prism 等能力在网络变化或源站失效时容易不可用	维护版使用可用 CDN 配方：主要切到 jsDelivr，Flowchart 使用 cdnjs，Web 端 draw.io 入口也做了适配
2026-06-09	基础系统升级	将官方私有部署运行环境迁移到 Debian 12，同时保留 MySQL 5.7、/wiz/storage 挂载和原有数据兼容性。	官方镜像长期停留在旧运行环境 CentOS 7，后续系统依赖和维护空间有限。	维护版提供 Debian 12 主线镜像，使用显式版本 tag 发布，便于迁移、回滚和长期维护。
2026-06-10	搜索增强	增加统一搜索 API，补齐分类、标签、创建/修改时间、附件、收藏、公开分享等过滤维度，并支持更适合 AI/脚本消费的精简字段。	官方镜像没有增强搜索接口；同样的 /wizserver/search 请求返回 404。 实测截图	维护版在同一容器内提供增强搜索能力，仍复用官方鉴权和官方索引数据，不复制用户笔记。 实测截图
2026-06-16	分享免登录阅读器	为公开分享笔记提供博客式阅读器，覆盖经典笔记、Markdown 笔记和协作笔记，支持目录、代码高亮、图表渲染和资源代理。	官方公开分享在部分场景仍落到登录页或阅读体验较弱，协作笔记公开分享尤其不适合直接传播。	维护版可以把公开分享链接渲染成免登录阅读页面，适合把旧笔记作为文章或资料分享出去。
2026-06-16	Mermaid 渲染增强	在前端旧版 Mermaid 渲染失败时，回退到服务端渲染，支持 mindmap、sankey、xychart 等新图表类型。	官方版依赖较旧的前端 Mermaid，mindmap 等新语法会渲染失败。	维护版可用服务端渲染补齐新图表类型，技术笔记中的 Mermaid 内容更稳定。
2026-06-16	Excalidraw 可编辑画板	在协作笔记中增加 Excalidraw 画板块，支持插入、编辑、保存和再次编辑。	官方版内置 draw.io / UML 能力，但没有 Excalidraw 这种手绘风格的原生可编辑块。	维护版在右侧编辑面板补充画板入口，可作为 Excalidraw 图块的插入入口。
2026-06-16	文字与背景色板增强	扩展协作笔记编辑器的文字色和背景色选项，补齐黑色、清除背景、粉色等常用样式。	官方色板选项较少，部分常用颜色或清除背景操作不够顺手。	维护版扩展了色板选项，并尽量保持与原编辑器视觉风格一致。
2026-06-19	Web 协作笔记附件下载修复	修复 Web xapp 中 Office 附件下载失败的问题，让浏览器端也能正常下载协作笔记附件。	官方 Web 端部分附件下载会走桌面客户端专用能力，浏览器环境下可能报“不支持”。	维护版在 Web 端使用浏览器下载能力保存附件，桌面端仍保留原有行为。
2026-06-22	Office / PDF / 文本附件本地预览	支持 docx、doc、ppt、pptx、xls、xlsx、pdf、txt、md、代码文件等附件在 Web 内直接预览。	官方 Web 端 Office 预览依赖微软 Office Online Viewer；自托管内网地址通常无法被微软服务器访问，txt/md 等文本附件也不在预览白名单内。 实测截图	维护版改为本地预览：Office/PDF 转逐页图片 HTML，xlsx 转 HTML 表格，文本和代码文件直接高亮展示，文档不出本机。 动态演示
2026-06-22	头像上传方向修复	修复手机竖图头像上传后被旋转成横图的问题。	官方版处理头像时没有正确应用 EXIF 方向，竖图可能在缩放后变横。	维护版在图片处理层应用 EXIF auto-orient，竖图、横图和无 EXIF 图片都能保持正确方向。
2026-06-23	块菜单剪贴板增强	将“作为 Markdown 粘贴”等剪贴板能力补到块选中菜单中，触屏和 iPad 场景也能使用。	官方右键菜单里有部分剪贴板能力，但触屏设备无法稳定召唤右键菜单；块选中菜单缺少这些入口。	维护版在块菜单中补齐剪贴板入口，选中块后即可粘贴 Markdown、纯文本、图片链接、块快照和块链接，解决 iOS 浏览器长按无法触发剪贴板入口的问题
2026-06-23	复制块链接	支持复制指向具体块的内部链接，粘贴后形成可点击的块引用。	官方版有笔记级链接能力，但缺少块级复制入口。	维护版在块菜单和选区工具栏提供“复制块链接”，适合在长文档中互相引用具体段落。
2026-06-23	修复 Markdown 语法粘贴问题	修复 Markdown 粘贴/导入时的语法解析问题：单波浪号不再误判为删除线，中文/全角标点后的加粗语法可正常识别。	官方版使用的 Markdown 解析规则较宽松：单个 ~te xt~ 会触发删除线，**±5%**（说明） 这类中文标点场景中加粗无法闭合，星号会原样保留。	维护版按 GFM 常见习惯收紧删除线规则：单波浪号保持字面文本，双波浪号才渲染为删除线；同时补充中文/全角标点识别，**...** 后接中文括号等字符也能正常加粗。
2026-06-24	右侧编辑面板增强	在协作笔记右侧常驻编辑面板中补齐行内代码、扩展色板和插入画板入口。	官方右侧编辑面板缺少部分已经存在于其他入口的能力，编辑路径不一致。	维护版让右侧面板也能直接使用行内代码、清除背景色、粉色背景和 Excalidraw 插入。
2026-06-25	标题自动编号	为协作笔记正文和大纲增加标题自动编号，可通过全局开关控制。	官方版标题没有自动章节编号，长文档需要手工维护 1、1.1、1.1.1 这类序号。	维护版可按标题层级自动编号，并同步显示在正文和大纲中；编号只影响显示，不写入笔记正文。
2026-06-25	代码块折叠	为协作笔记代码块增加折叠/展开能力，折叠状态可随笔记保存。	官方版代码块始终展开，长代码会占用大量阅读空间。	维护版在代码块工具条增加折叠按钮，折叠后保留语言名和行数，阅读体验接近现代文档工具。
2026-06-26	表格手动列宽	支持协作笔记表格列宽手动调整并保存。	官方版表格列宽更偏自动布局，用户调整后的宽度不容易作为明确状态保存。	维护版在用户拖拽调整列宽后记录手动列宽状态，刷新和再次编辑时尽量保持布局。
2026-06-30	笔记开头/结尾跳转按钮	在右侧底部工具区增加跳到笔记开头和结尾的按钮。	官方版长文档阅读时需要手动滚动，缺少快速跳转入口。	维护版提供开头/结尾跳转按钮，阅读和编辑状态下都可用。
2026-07-01	文本绘图入口	在插入菜单和快捷输入中补充 Mermaid、PlantUML、Flowchart 等文本绘图入口。	官方版已有部分图表能力，但入口不够集中，用户不容易发现或快速插入。	维护版增加“文本绘图”分组，并支持 /、+、、 等快捷入口插入常见图表块。

支持维护

如果这个自托管维护版帮你继续使用为知笔记私有部署，可以通过打赏支持后续维护。

后续也会围绕自托管场景提供迁移、升级、备份、故障排查、定制镜像和定制开发等服务。

打赏主要用于：

• 测试环境和服务器资源；
• 镜像构建、验证和长期维护；
• 继续补齐老用户仍然需要的功能；
• 处理自托管场景中的兼容性问题。

支持二维码：

微信支付	支付宝